AgentsReel CLI

AgentsReel turns agent work into reviewable demos: video, run context, event timelines, artifacts, and an explicit review state in one private workspace.

Install

Run once without installing:

npx agentsreel@latest doctor

Install for daily use:

npm install -g agentsreel
agentsreel doctor

AgentsReel requires Node.js 22.12.0 or newer.

If you received a private tarball for an early rollout:

npm install -g ./agentsreel-0.1.0.tgz
agentsreel doctor

Sign In

Create a scoped API token in AgentsReel, then store it locally:

printf "%s" "$AGENTSREEL_TOKEN" | agentsreel login --token-stdin --host https://your-agentsreel-host.example
agentsreel auth status

Tokens are stored at ~/.config/agentsreel/config.json with user-only file permissions. AGENTSREEL_TOKEN can override stored credentials for CI or temporary shells.

First Review Link

Upload an existing recording:

agentsreel upload ./run.mp4 \
  --title "Codex task review" \
  --summary "Ready for review." \
  --submit

After a successful upload, the CLI prints a private review link:

Ready: https://your-agentsreel-host.example/videos/<run-id>
Local run: <local-run-id>
State: .agentsreel/runs/<local-run-id>.json
Verified: run_status, review_url_present

That link is private to your AgentsReel workspace. Public share links are a separate, explicit action and may be disabled by the workspace.

Codex Capture Loop

Capture local command evidence without uploading:

agentsreel capture codex \
  --command "npm test" \
  --title "Agent verification" \
  --no-upload

This creates a local review package under .agentsreel/captures/... with events, manifest, command output, redaction status, and any provided artifacts.

To upload a Codex/Codex-like command capture, attach a recording:

agentsreel capture codex \
  --command "npm test" \
  --video ./run.mp4 \
  --title "Agent verification" \
  --submit

If upload is interrupted, rerun with the printed local run id:

agentsreel run resume <local-run-id>

Command capture strips secret-like environment variables from the child process by default. Avoid commands that print private data, .env files, tokens, or customer secrets.

Local Web Change Review

For a web UI or functional change, start with a local/private plan:

agentsreel test plan \
  --diff worktree \
  --app-url http://localhost:3000 \
  --intent "Review latest changes"

Then create a local capture package:

agentsreel test capture \
  --diff worktree \
  --app-url http://localhost:3000 \
  --intent "Review latest changes" \
  --no-upload

Upload only after the local package looks right.

Update

Check the published npm version:

agentsreel update check

Update a global npm install with npm:

npm install -g agentsreel@latest

If you use npx agentsreel@latest, npm resolves the latest published CLI for that run and no manual update is required.

agentsreel update is intentionally check-only in this release: it prints the exact npm command to run instead of modifying your global install automatically.

Capture Requirements

Basic upload and command capture only need Node.js. Browser capture also needs Playwright browser support plus ffmpeg and ffprobe on PATH:

npx playwright install chromium

iOS capture requires macOS and Xcode command line tools.

AgentsReel is built for controlled review, not public video hosting. Public share links require an API token with the shares:write scope.

License and Use

AgentsReel CLI is proprietary software. Access to the CLI does not grant rights to copy, modify, redistribute, sublicense, or use AgentsReel software, workflows, or services to build a competing product. Use is governed by your AgentsReel agreement or written permission from AgentsReel.