- 01the cliInstall ax
$ curl -fsSL ax.necmttn.com/install | shOne script. Drops the
axbinary on your PATH and registers the background watcher so new sessions get ingested automatically. The installer auto-falls back to the newest release that actually ships a binary, so a half-published release can't break it. To pin a specific version, prefix withAXCTL_VERSION=v0.28.0. - 02the skillsAdd the ax skills
$ npx skills add Necmttn/axInstalls the retro and workflow-extraction skills your agent triggers on - so the loop runs inside Claude Code, Codex, and the rest.
- 03first ingestIngest your history
$ ax ingestReads your coding-agent transcripts into the local graph. Watch it live at
ax serve→ http://127.0.0.1:1738. Nothing leaves your machine. - 04verifyCheck the install
$ ax doctorConfirms the CLI, the watcher, the skills, and the database are all wired up. Green across the board means you're ready.
- 05first fixSee your first recommendation
$ ax improve recommendax surfaces the repeated mistakes it found and proposes small, repo-specific fixes - reviewed one at a time. Receipts over vibes.
What you just did
ax now watches your coding-agent sessions across every harness you run - Claude Code, Codex, Pi, OpenCode, and Cursor - mines the mistakes that repeat, and turns them into proposals you accept or reject one at a time.
Next stops: the cost-routing loop (route mechanical work to cheaper models and measure the savings), the CLI reference for every command, and the language behind the graph.