Axon

Local, harness-agnostic observability for AI coding agents — one Rust binary, in your browser.

Axon reads the logs your AI coding-agent harnesses already write — Claude Code, Codex, OpenCode — and shows which harness, project, agent, and model is working, how fast, at what cost, and how much code it's producing. The signature view is a live three.js "brain" of your models firing in real time; alongside it sit per-agent/model cost & attribution, local leaderboards, budget alerts, and shareable cards.

100% local. No server. No account. Nothing leaves your machine.

[!NOTE] Early access. Working today: cross-harness ingestion (Claude Code, Codex, OpenCode) with exact per-sub-agent attribution, a live local dashboard (axon), budget awareness, and RTK token-savings — plus headless JSON (axon --scan-only). The three.js "brain" and shareable cards are next — see the roadmap. The complete, fixture-verified build spec lives in DESIGN.md.

What it does

	Capability	Status
🧩	Cross-harness ingest from the logs harnesses already write — Claude Code, Codex, OpenCode (Ollama via OpenCode)	✅
🎯	Exact per-named-agent attribution — see what each sub-agent (coder, security, Explore…) actually cost, no heuristics	✅
💸	Cost & budget awareness — per model/agent/harness, today/this-week spend with daily/weekly budget alerts	✅
🖥️	Live local dashboard — auto-refreshing telemetry instrument at localhost, no restart	✅
♻️	RTK integration — surfaces Rust Token Killer's token savings, if installed	✅
🧠	Live "brain" — three.js view of models firing, sized by cost	🔭
🏆	Local leaderboards + Hall of Fame and shareable PNG/WebM cards	🔭
🔒	Enforced privacy — loopback-only + Origin checks, assets bundled, SQLite 0600, zero egress by default	✅

Legend: ✅ available · 🚧 in progress · 🔭 planned.

Why Axon

	Axon	ccusage	Langfuse / Grafana+OTEL
Scope	Cross-harness	Claude Code only	App-level / Claude-only
Per-named-agent attribution	✅ exact	✗	✗
Local, single binary	✅	✅ (npx)	✗ (Docker + Postgres/Clickhouse)
Live visual + budget alerts	✅ (planned)	✗	partial
Account / server required	No	No	Yes

ccusage is the instant incumbent for Claude-only token tables. Axon's wedge is cross-harness cost + exact per-agent attribution in one local pane, with a live visual on top — the gap nobody fills.

Install

Prebuilt, self-contained binaries live in bin/ — no toolchain needed, nothing to configure. Each command below downloads one and installs it as the axon command on your PATH, so afterwards you just type axon anywhere and the dashboard starts.

# macOS (universal — Apple Silicon + Intel)
curl -fsSL https://github.com/danieltamas/axon/raw/main/bin/axon-macos -o /tmp/axon
xattr -d com.apple.quarantine /tmp/axon 2>/dev/null   # unsigned: clear Gatekeeper quarantine
sudo install -m 0755 /tmp/axon /usr/local/bin/axon
axon                                                  # scans your logs, opens the dashboard

# Linux x86_64 (use axon-linux-arm64 on ARM: Graviton, Pi, Asahi)
curl -fsSL https://github.com/danieltamas/axon/raw/main/bin/axon-linux-x64 -o /tmp/axon
sudo install -m 0755 /tmp/axon /usr/local/bin/axon
axon

No sudo? Install into a user dir that's already on your PATH instead — e.g. install -m 0755 /tmp/axon ~/.local/bin/axon, or ~/.cargo/bin/axon if you have Rust. (If the chosen dir isn't on your PATH yet, add it: export PATH="$HOME/.local/bin:$PATH".)

Checksums: bin/SHA256SUMS. Prefer to build it yourself? With Rust installed, clone this repo and run cargo install --path . — that compiles and drops the axon command into ~/.cargo/bin. The Homebrew / curl | sh one-liners arrive with the first tagged GitHub release.

Usage

# Start the live dashboard and open the browser (re-scans in the background):
axon                 # serves http://127.0.0.1:7777
axon --port 8080 --no-open

# Headless — scan your logs, print a JSON summary, then exit:
axon --scan-only

Both commands scan all three harnesses — ~/.claude/projects/, ~/.codex/sessions/, and OpenCode's opencode.db. Optional budget caps live in ~/.config/axon/config.toml (see assets/config.example.toml); the dashboard's Spend panel and the CLI then show today/this-week spend with amber/red alerts.

axon --scan-only collapses each turn, attributes every sub-agent, and prints totals plus per-model, per-agent, and per-harness breakdowns:

{
  "events": 38483,
  "sessions": 206,
  "tokens_out": 36320161,
  "cost_eur": 8187.32,                    // computed from pricing.toml (USD rates × fx → EUR)
  "unpriced_models": ["gpt-5.4"],        // models missing from the map, surfaced loudly (cost is a floor)
  "today_cost_eur": 409.96,
  "by_harness": [
    { "harness": "claude-code", "cost_eur": 6963.44 },
    { "harness": "codex",       "cost_eur": 1215.15 },
    { "harness": "opencode",    "cost_eur": 8.73 }
  ]
}

Rates are USD (from each provider's docs) converted to EUR via fx_to_display in assets/pricing.toml (override at ~/.config/axon/pricing.toml). A model missing from the map is flagged unpriced (its cost is a floor) rather than a silent €0; local/Ollama models are free. OpenCode's own per-message cost is used directly.

How it works

axon parses ~/.claude (and, soon, ~/.codex / OpenCode) logs into a normalized event, stores them in an embedded SQLite database, and serves an embedded Vue 3 + TresJS dashboard. Live updates come from file-watch → SSE; the numbers always come from SQLite (the source of truth). ui/dist is committed and embedded via rust-embed, so cargo install axon needs no Node toolchain. See DESIGN.md for the verified data schemas (§6 + Appendix A are checked against real logs — trust them over intuition).

Privacy

Loopback-only bind (127.0.0.1/[::1]) + Origin checks; every UI asset bundled (enforced zero-outbound — no CDN); SQLite stored 0600 in a 0700 directory. Share-cards redact project/branch by default. Nothing leaves your machine unless you export a file or opt into --otel. See DESIGN.md §16.

Roadmap

• M1 — Claude ingest + store (headless) ✅ collapse-by-message.id, exact sub-agent attribution, cost/LOC engine, SQLite, --scan-only.
• M2 — Codex + OpenCode 🔭 verify real logs, canonical model map, real € rates.
• M3 — Server + analytics UI 🔭 axum + /api/* + embedded Vue; leaderboards, drill-down, budget alerts, CSV/JSON export.
• M4 — Brain + live 🔭 file-watch → SSE, Mission-Control landing, 60fps perf gates.
• M5 — Cards/clips + packaging 🔭 PNG/WebM, weekly recap, cross-compiled releases, installer, Homebrew.
• M6 — OTEL export (optional) 🔭

Full detail in DESIGN.md §14.

Contributing

Contributions are welcome — especially new harness parsers. Start with CONTRIBUTING.md and read DESIGN.md; the fixtures in tests/fixtures/ are the acceptance gates. By participating you agree to the Code of Conduct.

License

MIT © 2026 Daniel Tamas.

Author

Conceived and created by Daniel Tamas. If Axon is useful to you, a ⭐ on the repo is the best way to say thanks.