thrdi 0.0.3

Trace any agentic CLI to a unified local store, queryable from the CLI.

thirdeye

Trace every agent session on your machine — Claude Code, Cursor, Codex, Gemini, Copilot — into one history you and your agents can search.

Install

brew install duncankmckinnon/tap/thirdeye    # macOS / Linux
pipx install thrdi                           # or: uv tool install thrdi

Enable tracing

thirdeye add --claude        # also: --cursor, --codex, --gemini, --copilot

To detach: thirdeye remove --claude.

Read your history

thirdeye list                          # every session, every platform
thirdeye events <id>                   # one session, terse
thirdeye tail <id> -n 5                # last few events
thirdeye event <id> <seq>              # one event, fully expanded
thirdeye search "migration"            # substring across all sessions
thirdeye stats                         # totals

Tag and filter

thirdeye tag <id> <seq> --add bug,review     # tag an event
thirdeye tag <id> --list                     # list tagged events in a session
thirdeye tag <id> <seq> --remove bug         # untag
thirdeye tags                                # global tag inventory
thirdeye search "migration" --tag review --platform claude --since 2026-05-01

Add --json for parseable JSONL, --tree for human-readable, --platform / --cwd / --tag / --since / --until to filter. Session IDs accept any unique prefix. Run thirdeye --help for the full reference.

Agent skill

thirdeye ships with a Claude-Code-format agent skill (use-thirdeye) that teaches a coding agent how to enable tracing, search past sessions, debug tool calls, analyze token usage, and run evaluations against recorded traces.

Install it into a repo so an agent working there picks it up automatically:

thirdeye skill install                          # default: .agents/skills/use-thirdeye
thirdeye skill install .claude/skills           # auto-appends use-thirdeye
thirdeye skill install .claude/commands/use-thirdeye   # full path also works
thirdeye skill install ~/.claude/skills         # Claude Code user-level
thirdeye skill install --force                  # replace an existing entry

--target is the full destination path of the symlink — point it wherever your agent platform expects skills or commands. The skill is installed as a symlink, so upgrading thirdeye (brew upgrade thirdeye or pipx upgrade thrdi) automatically refreshes the skill content in every repo where it is installed.

License

MIT.