Skip to content

Replay your coding agent sessions as a map and a timeline

docs: run agentplay with uvx @latest so users get new releases

adityajha20052e13e6e033c7
diff --git a/README.md b/README.md
index 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 it
You 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 pipx
pip install agentplay # or install it into an environment
```
diff --git a/viewer/src/App.tsx b/viewer/src/App.tsx
index 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 map
file anywhere on this page.
</Banner>
diff --git a/viewer/src/insights/AutotuneView.tsx b/viewer/src/insights/AutotuneView.tsx
index 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.tsx
index 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 see
yours; the demo has too few sessions to score.
</Note>
);