agent-walker

# agent-walker

[![CI](https://github.com/miiiiiiich/agent-walker/actions/workflows/ci.yml/badge.svg)](https://github.com/miiiiiiich/agent-walker/actions/workflows/ci.yml)
[![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](#license)
[![MSRV](https://img.shields.io/badge/rustc-1.93+-blue.svg)](https://www.rust-lang.org)

**日本語: [README.ja.md](README.ja.md)**

**Can you see where your AI agents have walked?**

A local terminal dashboard built from the logs your AI coding agents already
write to your machine — tokens, API-equivalent cost, projects, tools, and
autonomy, a month of runs in one screen. Put in the work and you'll earn a
codename.

*Only the one watching can deter it.*

![agent-walker terminal dashboard preview](docs/demo.gif)

## Why

Subscription AI tools don't show you what you actually use. agent-walker
reads the session logs on your disk and answers, in one screen:

- **How much would this cost on the API?** — cache-aware cost windows
  (today / 7d / 30d / period), so you know if the subscription pays for itself
- **Where do the tokens go?** — per-repository breakdown across agents
- **When and with which model?** — GitHub-style activity grass, stacked
  per-model daily bars, hour-of-day profile in your local timezone
- **Can it run unattended?** — turn-duration histogram weighted toward the
  20-minute-plus autonomy range
- **Which skills earn their tokens?** — per-skill 30-day breakdown on the
  Claude tab, when your Claude Code version attributes messages to skills
- **How hard did you push the plan?** — daily peak of the 5h-window
  utilization over the last month on the Codex tab: history, not a live meter
- **How do you let it think?** — how often extended thinking actually fired
  (Claude) and the reasoning-effort mix (Codex)

## Privacy

- Your logs **never leave your machine** — agent-walker does not phone home
  with usage or error data.
- The only always-on outbound traffic is a `GET` of public model-pricing
  metadata from [LiteLLM's pricing database](https://github.com/BerriAI/litellm)
  (MIT-licensed) when the dashboard loads or reloads a report. It carries no
  log content and no usage data, but it does let GitHub's CDN see your IP,
  the same as any `git pull`. Block it with a firewall rule or run offline if
  that matters to you.
- **Cursor is the one exception.** It's auto-detected when you're signed into
  Cursor locally, and reading its usage reaches the network: agent-walker uses
  your local Cursor session token to query Cursor's own usage dashboard (Cursor
  keeps no usage on disk). That sends your session cookie to Cursor to read your
  own usage. It's skipped (no request) whenever there's nothing to read — Cursor
  not installed, or signed out — so nothing is sent unless you're signed in. See
  [docs/cursor.md](docs/cursor.md).
- Release binaries carry [GitHub Artifact Attestations](https://docs.github.com/en/actions/concepts/security/artifact-attestations):

```sh
gh attestation verify agent-walker-aarch64-apple-darwin.tar.xz -R miiiiiiich/agent-walker
```

## Use

No install — `npx` / `bunx` fetch the prebuilt binary for your platform
(macOS arm64/x64, Linux arm64/x64 GNU, Windows x64) and run it:

```sh
npx agent-walker
# or
bunx agent-walker
```

| Key | Action |
|---|---|
| `←` `→` / `h` `l` / `Tab` | switch provider (only those with data; most-used first; Total last) |
| `↑` `↓` / `j` `k` / `PgUp` `PgDn` | scroll |
| `1`–`9` | jump to tab |
| `r` | reload |
| `s` | share your stats card (copy image / save to your OS Downloads folder) |
| `q` / `Esc` / `Ctrl-C` | quit |

Flags:

| Flag | What it does |
|---|---|
| `--days <N>` | Analysis window for the graphs (default 30; the codename's throughput level is always taken from the last 30 days, so the rank doesn't drift with `--days`) |
| `--share <path>` | Render the stats card to a PNG, print its caption, and exit |
| `--no-cache` | Rescan every log file, ignoring the parse cache |
| `--no-cursor` | Disable the Cursor collector — the only one that sends a credential off the machine (your Cursor session cookie, to cursor.com) — so it makes no network request |
| `--claude-dir` / `--codex-dir` / `--agy-dir` / `--opencode-dir` / `--copilot-dir` / `--grok-dir` | Point at non-standard log locations (also honors `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `OPENCODE_HOME`, `COPILOT_HOME`, and `GROK_HOME` when set) |
| `--cursor-state-db` | Point at a non-standard Cursor `state.vscdb` (or set `CURSOR_TOKEN` to supply the session token directly) |
| `--completions <shell>` | Print shell completions (e.g. `--completions zsh`) and exit |

## Share your codename

Press `s` in the dashboard (or run `agent-walker --share card.png`) to render a
shareable stats card. Instead of leading with a raw token count, the card reads
*how* you work: a GitHub-style activity grid, your hour-of-day rhythm, and a
per-model split, with parallelism and task-time as plain numbers.

Your usage also earns a 

... (truncated)