tune

Installation
SKILL.md

ax:tune - what to change in the rig after one session

The user has asked to tune the rig. You read what one session actually did, name the changes to the agent's environment (hooks, checks, steering files, tools, access) that would make the next run cheaper or safer, and file every candidate in ax so it is triageable later. The session log is the primary source; ax is the ledger.

Steps

  1. Call the Skill tool with writing-for-agents for the writing style.

  2. Locate the session. Default is the current one: the id is $CLAUDE_CODE_SESSION_ID and the log is ~/.claude/projects/<cwd-slug>/<id>.jsonl. If the user names another session, take its key. Done when you hold a path that exists.

  3. Make it reviewable in ax, scoped. Run ax ingest here in the background (the bare ax ingest walks every transcript on the machine). Watch its RSS; stop it at 4 GB and record that as a Tool economy finding against ax itself. Continue on the raw log while it runs.

  4. Build the ledger. Run python3 -I scripts/turns.py <log> (add --full to see each command). It prints one line per tool call with ERR, DENY, RETRY, AGENT, BIG flags and a summary of calls, flags and tokens. When ax has the session, add ax sessions show session:<id> --turns --json for timings. Done when every flagged line has a cause you can state.

  5. Hunt candidates in these categories, each with evidence from the ledger (turn, tool calls spent, bytes or tokens wasted) and a fix that names a file.

Installs
3
Repository
necmttn/ax
GitHub Stars
122
First Seen
Oct 17, 2026