Necmttn/ax logo

Necmttn/ax

Free

本地优先的 AI 编程代理遥测与召回图谱,可通过 MCP 查询 Claude Code、Codex、Cursor、OpenCode、Pi 的会话、工具调用、技能和成本数据。

FreeFree tier
Type
Open Source

About Necmttn/ax

ax is a local-first observability and memory layer for AI coding agents, specifically Claude Code and Codex. It implements a retro loop that captures every agent session, identifies repeated mistakes and friction patterns, and generates small, repo-specific fixes that users can review and apply. The system uses a stop hook at the end of each session to collect structured retros (tried, worked, failed, next) and indexes them as typed experiments in a local SurrealDB graph. Friction patterns become proposals that users triage, and accepted proposals become experiments with verdicts at t+7, t+30, and t+90 days. ax is fully private: it ingests transcripts, git history, and tool calls into a local database without any cloud upload. It only makes outbound calls on explicit opt-in commands like ax profile publish for sharing aggregate statistics.

Key Features

Retro loop captures every agent session and turns it into actionable improvements
Local-first architecture with SurrealDB on 127.0.0.1 - no cloud, no account, no outbound calls
Structured session retro (tried, worked, failed, next) via stop hook at session end
Friction pattern detection and proposal-based triage system
Experiment tracking with t+7, t+30, t+90 verdicts
Supports Claude Code and Codex agents
Privacy-focused: ingests transcripts, git history, and tool calls locally
Install via single curl command or agent-driven setup prompt

Pros & Cons

Pros
  • Fully local and privacy-preserving - no data leaves the machine
  • Open source and free to use
  • Creates a continuous improvement loop for agent-assisted development
  • Works with popular coding agents (Claude Code, Codex)
  • Simple installation and setup
Cons
  • Requires a local SurrealDB instance and initial setup
  • Only explicitly supports Claude Code and Codex (other agents may need configuration)
  • Learning curve for understanding the retro loop and proposal workflow

Best For

Improve AI coding agent performance by learning from past mistakesReduce redundant work across agent sessions by surfacing what worked beforeTrack and experiment with agent behavior changes over timeEnable teams to review and apply incremental, repo-specific improvements

FAQ

What does ax do with each agent session?
ax watches every session, runs a stop hook at session end, and asks the agent for a structured retro (tried, worked, failed, next). It indexes the result as a typed experiment in a local graph.
Is ax safe to run on private code?
Yes, ax is fully local. Ingest reads transcripts, git history, and tool calls into a SurrealDB on 127.0.0.1. Nothing is uploaded, there is no account, no cloud, and no outbound call at ingest. Only explicit opt-in commands like `ax profile publish` can leave the machine.
Which agents does ax support?
ax is built for Claude Code and Codex agents, as indicated by the setup prompt and header description.
How do I install ax?
Run the command: curl -fsSL ax.necmttn.com/install | sh and then run ax setup. You can also paste a setup prompt into Claude Code or Codex to let the agent install ax for you.