claude

tracer

Which session did what — a structural index over Claude Code's own transcripts (~/.claude/projects/*.jsonl), verbatim, no LLM pass. Its own command, `tracer` (bin/, on the Bash PATH while the plugin is on), with two groups: `tracer sessions` (ls · live · show · replay · turns · search — the conversations) and `tracer trace` (every tool call, plus turn · blame · index — what was done in them); every older spelling still runs, unlisted. With the ak CLI installed the same groups are also `ak sessions` and `ak trace`. Also the /tracer:trace, :blame and :index skills, and a Stop-hook index writer (it also launches the tool-call indexer this plugin ships under traces/, the store behind `tracer trace`). Its index lives under ~/.claude/plugins/data/conversation-index; it needs no vault, no ak and no other plugin.

7 on GitHubv2.9.0MITupdated 2 days ago
/

Plugin tracer from marketplace agentic-kit in proxify-dev/agentic-kit. Commands read from the repo's manifest — yesterday.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (3)

  • blame

    Git-blame for Claude Code sessions: find which session read/wrote/edited a specific file, newest-first, with the intent behind each change. Use when the user asks "find the session that edited a file", "which session touched this file", "who changed X", or "when was this file last modified in a chat

  • index

    Index and query Claude Code conversation histories. Extract interaction records from JSONL, filter by plugin/tool/agent, detect patterns and failures. Search conversation content by keyword. Trace file provenance to find why a file was written.

  • trace

    Trace and recap a past Claude Code session by UUID, slug, date, or phrase. Prefetches dialogue + structure + delegated work + the observer's rows for grounded summaries. Use when user asks "what did we do in that session", "trace this work thread", "recap that session", "show session arc", or "link

Subagents (1)

  • reader

    Searches past Claude Code sessions with the `tracer` command and returns what was said, quoted word for word with the session id and turn. Runs on Haiku. When you delegate a search over session history, delegate it here rather than to general-purpose, even when choosing which moments count takes jud

Hooks (5)

  • SessionStart

    uv run --quiet --no-project --python ">=3.10" "${CLAUDE_PLUGIN_ROOT}/hooks/convo-index-stop.py"

  • SessionStart

    uv run --quiet --no-project --python ">=3.10" "${CLAUDE_PLUGIN_ROOT}/hooks/session.py"

  • SubagentStart

    uv run --quiet --no-project --python ">=3.10" "${CLAUDE_PLUGIN_ROOT}/hooks/session.py"

  • PostToolUse

    uv run --quiet --no-project --python ">=3.10" "${CLAUDE_PLUGIN_ROOT}/hooks/raw_read.py"

  • Stop

    uv run --quiet --no-project --python ">=3.10" "${CLAUDE_PLUGIN_ROOT}/hooks/convo-index-stop.py"

View source on GitHub

More from proxify-dev/agentic-kit

All 7 plugins →

Agentic engineering kit: seven skills (context engineering, harness engineering, skill development, agent development, evals, sandboxing, fewer faster tests), most named by a short block a hook prints at the moment it applies; an agentic-engineer agent that starts with two of them loaded; /new-plugin, which makes your own plugin in a folder you pick; and /new-agent and /new-skill, which write the file into that plugin or the project from the skill's template, or hand your words to Claude with the skill loaded (a Claude Mod: needs CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1).

7 skills · 1 agent · hooks

7

modes

claude

How a session works with you and with its subagents. Two session modes, each [on|off|status], answered with no model call, Claude told once at each switch and reminded by one line on each prompt while on, a label in the prompt footer: /orchestrate hands parts to subagents on another model (haiku · sonnet · opus); /ask answers and changes nothing, refusing Edit, Write and NotebookEdit while on. /modes:interview asks you rounds of AskUserQuestion until the direction is clear. /modes:align stops work in progress: it plays back what was built, names where it drifted from what you asked, and asks before any more changes. A Claude Mod: needs CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1.

2 skills

7

observer

claude

What past sessions learned. An observer runs at SessionEnd (the plugin agent agents/observer.md, run headless) and writes observations as rows in the vault's store (~/.ak/db/brain.db); the next session opens on a 'since you were last here' digest; `observer search → timeline → get` recalls them in three layers and `patterns · fold · forget` curate them; a Read hook says when a file has prior observations. CLI: `observer status|mute|unmute|prompts|show|try|store|types|search|timeline|get|patterns|fold|forget|shadow`, also mounted as `observer …` when ak is installed. Shares only the vault's data paths with the other kit plugins.

1 agent · hooks

7

ak

claude

The ak command, and ak setup, the kit's installer: it checks your machine, installs the plugins you pick, and takes a run back with ak setup undo. Its own verbs: plugin ls, inspect and log (what your plugins put in front of your agent) and hooks (which hook ran, when, how long); with the gateway, gateway, xray (the exact prompt a claude launch would send, as a dry run), sysprompt and shim. Every other kit plugin adds its verbs to it: the tracer's are ak sessions and ak trace. A uv tool, kept up to date when a session starts.

hooks

7

insights

claude

How you really work with Claude Code, rebuilt from the files it keeps on your machine. /insights:my-agentic-setup scans your sessions, settings, plugins, skills, hooks and the git repos Claude Code ran in, has AI readers in your own Claude Code session review the rule files and memory of your most active projects, and writes one local page. It opens on a written review of your setup: what works, what to change first, and why. Your level shows the level your laptop reads, a starting point a call confirms or raises; Level 3 and up need your own files to show it (AGENTIC_SETUP_NO_LEVEL=1 leaves the level out). Reads only; nothing leaves the machine unless you press Send on the page. Python 3.12+ or uv.

1 skill

7

web

claude

WebFetchRaw, a tool beside WebFetch: it fetches a URL and saves the page's own content to a file, with no model in between, and returns one line naming the file. WebFetch returns a small model's answer about the page. An HTML page is extracted to markdown, text or cleaned HTML by trafilatura; anything else (JSON, text, a PDF) is saved byte for byte. A Claude Mod (needs CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) that runs a Python script through uv once per call. Shares nothing with the vault and needs no kit.

7

Maintain tracer?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins7 plugins