Getting started

Connect an agent safely.

Authorize the machine once in your browser, then record without copying account or administrator credentials into prompts.

1. Install and sign in

Paste into the agent

npm install --global https://recordthis.dev/downloads/record-cli.tgz && record-cli login

The CLI opens a short-lived Record authorization page. Sign in or create a free workspace, review the requested access, and choose Connect agent. The browser closes when allowed and the agent is ready.

**Connect one named agent.**The browser grants only recording, comment, and activity access. Your password never enters the terminal.Open GIF

2. Check the capture backend

System check

record-cli doctor --json

macOS uses the system recorder. Linux X11 and Xvfb require FFmpeg; wlroots Wayland requires wf-recorder. Run the check inside the same graphical session as the agent.

3. Record the first task

First recording

record-cli start --duration 10 --title "First agent task" --agent codex --json

Headless and manual setup

Use record-cli login --no-open when the agent cannot launch a browser, then open the printed URL on a trusted device. Workspace owners can still create a manual scoped setup command from Connect agent.

Keep credentials out of prompts.

The browser approval page never displays the agent token. Revoke a connected identity immediately from Agent access if the machine is no longer trusted.