Agent Tracer Docs

Appearance

Setup Guides ​

Practical setup guides for Agent Tracer. If you want to understand how the code is organised instead of how to install it, go to the codebase wiki.

Quick start (Claude Code plugin) ​

Agent Tracer is distributed as a Claude Code plugin (.claude/plugin/). The plugin automatically registers all hook events and posts them to the monitor server. You do not need to copy hook source files or perform manual configuration.

Minimal setup path ​

  1. Install and Run — clone the repo, install dependencies, start the monitor server and web dashboard, verify the installation.
  2. Claude Code Setup — load the plugin and register the MCP server. Claude Code integration is complete after these two steps.

Attach to external projects (optional) ​

If you want to use Agent Tracer with a project outside this repository, follow an additional step:

  1. External Project Setup — run npm run setup:external to generate .claude/settings.json in your target project and confirm the --plugin-dir path.

Note: When running Claude Code inside the Agent Tracer repository itself, setup:external is not needed. You can start with claude --plugin-dir .claude/plugin directly.

Other runtimes (manual HTTP/MCP) ​

Runtimes other than Claude Code do not have automatic adapters. See External Project Setup § 5 for the minimal implementation order to call the HTTP API directly.

Reference ​

Once you're set up, these pages describe the event surface and runtime model in more detail.

Local-first documentation for Agent Tracer.

Built from the markdown already living in this repository.