ax
ax is a local agent-experience graph that ingests transcripts from AI coding agents (Claude Code, Codex, etc.) and git history into an embedded DuckDB database. It helps developers and AI agents learn from past sessions by surfacing repeated mistakes, skill effectiveness, costs, and insights. It is for developers using AI coding agents who want to improve future sessions with data-driven retrospection.
✨ Key features
- Ingests sessions from six harnesses plus skills, git, and GitHub PRs
- Full-text BM25 recall across all past sessions
- Skill scoring and tool failure insights
- Token cost tracking by session, commit, or branch
- Local-only: no server, no cloud, no account
- Agent skill and MCP for project context
🎯 Use cases
- Recall past solutions or debugging steps with
ax recall - Identify which skills are worth using via
ax skills taste - Measure the token cost of a feature branch
- Find frequently failing tools to improve around
- Generate a personal 'Agent Wrapped' summary of your coding history
📦 Installation
🧰 Requirements: Requires Bun ≥ 1.3. macOS-first; Linux works for ingest and CLI. No database server needed.
curl -fsSL ax.necmttn.com/install | bash
PATH="$HOME/.local/bin:$PATH" ax setup # agent skills + first ingest + doctor
🚀 Usage
ax recall "auth bug" # full-text recall across every past session
ax skills taste # which skills earned their keep
ax costs for --branch main # what a branch cost in tokens
ax sessions metrics # graph-derived session health
ax share <session-id> # publish a session anyone can read
ax studio # live dashboard at http://127.0.0.1:1738
⚠️ Good to know
ax is early and macOS-first; Linux supports ingest and CLI but not the optional telemetry receiver.
❓ FAQ
Is ax fully local?
Yes, ax is fully local with no daemon or server. Ingest reads transcripts into a local DuckDB cache, and nothing is uploaded unless you explicitly opt-in to publish commands.
Which AI coding agents are supported?
ax ingests sessions from Claude Code, Codex, Pi, Omp, OpenCode, and Cursor, plus installed skills, local git history, and GitHub PRs.
How do I install ax?
Run curl -fsSL ax.necmttn.com/install | bash and then ax setup to configure agent skills, ingest history, and run doctor.
What is the 'Agent Wrapped' feature?
It generates a personal recap deck from your session history, similar to Spotify Wrapped, showing your coding habits, top skills, and more. It is generated locally with ax wrapped generate and published via ax wrapped publish.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.