Add trajectory recording to cua do CLI

[sarinali]

Summary

• Every cua do action is now automatically recorded to ~/.cua/trajectories/{machine}/{session}/ in a format compatible with the TrajectoryViewer at cua.ai/trajectory-viewer
• cua trajectory view zips the session, starts a background CORS-enabled file server, and opens cua.ai/trajectory-viewer?zip=localhost:PORT/file.zip in the browser
• Recording is on by default; opt out with cua do --no-record

New files

• cua_cli/utils/trajectory_recorder.py — session management, turn writing, zip, clean
• cua_cli/commands/trajectory.py — cua trajectory ls/view/stop/clean commands

Modified files

• cua_cli/commands/do.py — --no-record flag, post-action screenshot recording in all 11 handlers, session reset on switch
• cua_cli/main.py, cua_cli/commands/__init__.py — register trajectory command
• skills/cua-do-cli/SKILL.md — document trajectory recording

Test plan

• Run cua do switch docker test && cua do screenshot && cua do click 100 200, verify ~/.cua/trajectories/test/ has turn_001/ and turn_002/ with JSON + screenshots
• Run cua do --no-record click 100 200, verify no new turn
• Run cua do switch docker other, verify new session directory
• Run cua trajectory ls, verify output
• Run cua trajectory view, verify zip served and browser opens cua.ai/trajectory-viewer
• Run cua trajectory stop, verify server killed
• Run cua trajectory clean -y, verify sessions deleted

🤖 Generated with Claude Code

[vercel]

@sarinali is attempting to deploy a commit to the Cua Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• rabbit

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sentry]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!