Agenttrail

agenttrail

**Know what your coding agents are doing, while they are doing it.**

[](https://www.npmjs.com/package/agenttrail) [](LICENSE) [](package.json) [](https://github.com/sodiumsun/agenttrail)

Your coding agent has been working for half an hour. Is it making progress? Is it stuck? Did it quietly reopen the part it already called done?

agenttrail is a local, open-source observability layer for AI coding agents. It turns plans, tool calls, file changes, and progress from Claude Code, OpenAI Codex, Cursor, or any agent that edits files into a live project map.

Start an agent, walk away, and come back to this:


cd your-repo
npx agenttrail --open

That's it. No account, no global install, no telemetry. agenttrail opens on localhost and starts watching the repo.

How the live agent map works

A plan says what the agent intends to do. The filesystem says what it actually touched. agenttrail shows both.

When those signals disagree, you know where to look. A completed card lights up when its files change again. A live run sits on the component it is touching. The map moves as the work moves.

Wha