Claude Code usage

Agentplay

Replay your coding agent sessions as a map and a timeline

371 stars 47 forksUsage & cost trackers Source

Install

Install
uvx agentplay@latest

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/Entelligence-AI/agentplay.git

From the README

agentplay

See what your coding agent actually did. Replay every session as a map and a timeline: what it read, what it edited, what failed, and what it shipped. Local, open source, works across Claude Code, Codex, Cursor, Copilot, OpenCode, Kiro, Gemini CLI, Antigravity CLI, Command Code and Goose.

That one command finds the agent sessions already on your machine, builds a redacted replay of each one, and opens a local viewer. No account and no API key are required, and your session data never leaves your machine. The only network call is an optional email signup in the viewer, described under Privacy; set AGENTPLAY_NO_NETWORK=1 to switch it off.

Screenshot of the bundled demo session (synthetic data). Dark mode: docs/images/explorer-dark.png.

If agentplay shows you something about your agent you didn't know, a ⭐ helps other people find it.

Contents

- Why this exists
- Install
- Using the viewer
- Supported agents
- Privacy
- Command reference
- The session map format
- How it works
- Configuration
- Development
- Contributing
- Known limitations
- License and credits

Why this exists

Your agent's transcripts already record what it did: which files it read before editing, which commands it retried, which MCP servers failed, where the context window filled up, and which subagents came back empty. That data sits in ~/.claude, ~/.codex, ~/.cursor and similar folders, and almost nobody looks at it.

agentplay makes that data readable. Every session becomes a map of everything it touched and a timeline you can play back, so you can answer questions like:

- What did the agent read before it edited this file, and what did it never open?
- Which commands failed, and how many times did it retry the same one?
- Where did the context window fill up, and what did the…
Read the full README on GitHub

Details

Language
Python
License
Apache-2.0
Last updated
11 November 2026
Topics
agent-observabilityai-agentsclaudeclaude-codecodexcoding-agentscursordeveloper-toolsdevtoolsgithub-copilotkirollm

FAQ

What is Agentplay?

Replay your coding agent sessions as a map and a timeline It is a usage for Claude Code, from Entelligence-AI/agentplay on GitHub.

How do I install Agentplay?

Run uvx agentplay@latest, then follow the setup in the README.

Is Agentplay popular?

Entelligence-AI/agentplay has 371 GitHub stars and 47 forks, and is included in 1 curated Claude Code list. It was last updated on 11 November 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.