Replay your coding agent sessions as a map and a timeline
Python agent-observabilityai-agentsclaudeclaude-codecodexcoding-agentscursordeveloper-toolsdevtoolsgithub-copilotkirollmobservabilityopencodeprivacypythonsession-replaytypescriptvisualization
docs: run agentplay with uvx @latest so users get new releases
adityajha20052e13e6e033c7
diff --git a/README.md b/README.mdindex a91eb68..832a25a 100644--- a/README.md+++ b/README.md@@ -12,7 +12,7 @@**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 and Antigravity CLI.**```bash-uvx agentplay+uvx agentplay@latest```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](#privacy); set `AGENTPLAY_NO_NETWORK=1` to switch it off.@@ -57,7 +57,7 @@ agentplay makes that data readable. Every session becomes a map of everything itYou need Python 3.11 or newer. agentplay has **no runtime dependencies** beyond the standard library.```bash-uvx agentplay # run without installing (uv: https://docs.astral.sh/uv/)+uvx agentplay@latest # run the newest release without installing (uv: https://docs.astral.sh/uv/)pipx run agentplay # same, with pipxpip install agentplay # or install it into an environment```diff --git a/viewer/src/App.tsx b/viewer/src/App.tsxindex 43b9123..1d6c7dc 100644--- a/viewer/src/App.tsx+++ b/viewer/src/App.tsx@@ -192,7 +192,7 @@ export function App() {{mode !== 'probing' ? <PlatformBanner /> : null}{mode === 'demo' && source === demo ? (<Banner>- Demo sessions. Run <code className="font-mono">uvx agentplay</code> (or{' '}+ Demo sessions. Run <code className="font-mono">uvx agentplay@latest</code> (or{' '}<code className="font-mono">pipx run agentplay</code>) to see your own, or drop a mapfile anywhere on this page.</Banner>diff --git a/viewer/src/insights/AutotuneView.tsx b/viewer/src/insights/AutotuneView.tsxindex 26ab71b..51e8028 100644--- a/viewer/src/insights/AutotuneView.tsx+++ b/viewer/src/insights/AutotuneView.tsx@@ -16,7 +16,7 @@ export function AutotuneView() {return (<div role="note" className="rounded-xl border border-ds-border-subtlest bg-ds-surface-white p-6 text-center ds-text-body-sm-medium">Autotune writes to your own repos, so it runs from the CLI on your machine. Run{' '}- <code className="font-mono">uvx agentplay</code> to set it up.+ <code className="font-mono">uvx agentplay@latest</code> to set it up.</div>);}diff --git a/viewer/src/insights/RunHealthView.tsx b/viewer/src/insights/RunHealthView.tsxindex 6a45567..2345479 100644--- a/viewer/src/insights/RunHealthView.tsx+++ b/viewer/src/insights/RunHealthView.tsx@@ -33,7 +33,7 @@ export function RunHealthView({ range }: { range: Range }) {if (!source.health) {return (<Note>- Run health reads your local store through the CLI. Run <code className="font-mono">uvx agentplay</code> to see+ Run health reads your local store through the CLI. Run <code className="font-mono">uvx agentplay@latest</code> to seeyours; the demo has too few sessions to score.</Note>);