AI session narration for your daily work journal.
Git captures the what. This plugin captures the why.
When you activate the Worktale skill in Codex CLI, your AI coding agent automatically narrates each commit — adding intent, decisions, and context to your Worktale daily narrative.
Copy the skill to your Codex skills directory:
# Clone and install
git clone https://github.com/worktale/worktale-codex-plugin.git
cp -r worktale-codex-plugin/skills/worktale ~/.agents/skills/worktaleOr manually create ~/.agents/skills/worktale/SKILL.md with the contents from this repo.
Requires the Worktale CLI v1.1.0+:
npm install -g worktale@latest
cd your-repo
worktale initStart Codex with skills enabled:
codex --enable skillsThe agent will automatically detect and activate the Worktale skill when relevant. After every commit it makes, it runs:
worktale note "Refactored auth middleware for compliance — replaced session token storage"Notes accumulate throughout the day. View them with:
worktale digest # End-of-day summary with your notes
worktale dash # Interactive TUI dashboardThe agent writes 1-2 sentence notes focused on:
- Intent — why the change was made
- Decisions — trade-offs and alternatives considered
- Problems solved — bugs found, root causes identified
It does not duplicate what git already tracks (file paths, line counts, diffs).
- Codex loads the skill from
~/.agents/skills/worktale/SKILL.md - The skill prompt instructs the agent to run
worktale note "..."after each commit worktale noteappends to theuser_notesfield in your local Worktale database- Notes appear in
worktale digest, the TUI dashboard, and (eventually) your Worktale Cloud portfolio
All data stays local. Nothing leaves your machine.
MIT