hyukvoid

Agent Pigeon — Development skill for Claude Code

Development community

See how your coding agent actually worked.

How to install Agent Pigeon

This entry records only its repository, not the path inside it, so there is no exact command to give. Open hyukvoid/agent-pigeon and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Pigeon does

See how your coding agent actually worked. A tiny local CLI that turns Claude Code / Codex sessions into flight reports: edits, verification runs, FAIL->PASS loops, and session comparisons. Local, read-only, no API key, nothing uploaded.

Alternatives in Development

Om Tidy — Self-maintenance pass — acts on every hygiene flag: archives completed work, groups loose clusters, splits ove 4.6k ★
Domxss — Confirm DOM XSS in a real headless browser — injects canary payloads into params + URL fragment and only repor 4.5k ★
Cost Xray — See what Claude Code and Codex actually send to the API — and what each part costs 586 ★

README

Agent Pigeon

See how your coding agent actually worked.

**Local · Read-only · No API key · Nothing uploaded**

Agent Pigeon reads your local Claude Code and Codex session history and summarizes edits, recognized verification, FAIL→PASS loops, and session comparisons.

npx agent-pigeon flight

⠀⠀⠀⠀⠀⠀⢀⣤⣴⣤⣄⠀⠀⠀
⠀⠀⠀⠀⠀⠀⣼⣿⣿⣽⣿⣄⠀⠀
⠀⠀⠀⠀⣠⣤⣿⣿⣿⣿⡿⠛⠉⠁
⣀⣀⣴⣿⡿⣿⣿⣿⣿⣿⣿⣷⠀⠀
⠈⠻⣿⡟⠛⣦⣉⠛⢿⣿⣿⣿⠁⠀
⠀⠀⠀⠉⠻⡿⠿⡿⠶⡿⠋⠁⠀⠀
⠀⠀⠀⠀⠒⠓⠂⠀⠒⠓⠂⠀⠀⠀
Agent Pigeon — Codex
  Session span: 63 min · 1 session

  READ      —                   N/A
  EDIT      ██████████████████  40
  VERIFY    ██████              14
  FAIL→PASS ███                 7

Final state
   ✓ recognized verification found

Local · Read-only · Nothing uploaded

Requires **Node.js ≥ 20.11**. Install once with `npm install -g agent-pigeon`.

Reports

Command	What it shows
`flight`	The latest session by default; use `--session` to choose one.
`replay`	Corpus-wide activity, unverified implementation stretches, and recognized FAIL→PASS loops.
`compare`	Side-by-side facts, without scores or a winner. Claude Code and Codex sessions can be compared.
`share flight` / `share compare`	A self-contained SVG report printed to stdout. Redirect it to save.

Flight reports include READ, EDIT, and recognized VERIFY counts, the largest debugging loop, most-touched file, longest stretch of coding without recognized verification, and final verification state. Reports are prompts to inspect, not grades.

Privacy

Agent Pigeon reads only `~/.claude/projects` and `~/.codex/sessions`, in read-only mode. It never reads project source code, writes state or a cache, or transmits data. Reports contain aggregate counts and short session IDs, not source code, diffs, commands, or prompts.

Agent Pigeon is an independent local CLI and does not require or configure PigeonHub.