AI product Open source

agenttrail

agenttrail is a local, open-source observability layer for AI coding agents. It watches plans, tool calls, file changes, and progress from Claude Code, OpenAI Codex, Cursor, or other agents that edit files, then presents them as a live project map with repository components, dependency arrows, progress, and working, blocked, or completed states. It compares declared agent intent with observed filesystem activity, including renewed changes to supposedly finished work, and displays the current run, task list, streaming tool activity, elapsed time, recent calls, session plans, and a live repository tree.

View repository Mentioned in 1 video ↓

Overview

The tool runs locally through commands such as `npx agenttrail`, with no account, global installation, or telemetry. `npx agenttrail init` adds the agenttrail convention to CLAUDE.md and AGENTS.md, creates a starter PLAN.md, and installs additive local Claude Code hooks; the resulting plan and file activity are used to generate a map of roughly 5–9 repository components with dependencies and verifiable statuses. It supports one daemon per repository, a shared board tab switcher, restart via `npx agenttrail up`, and login autostart through `npx agenttrail autostart`.

What agenttrail is used for

1 use taken from transcripts — each links to the moment in the video.

  • A monitoring tool that shows what coding agents are doing by tracking plans, tool calls, and file changes and mapping them to repository components. It displays working, blocked, and completed states.

Videos mentioning agenttrail

1 in the library.