Local-first session video publishing

Turn an agent session or recording into a reviewable video link.

asdf.tube renders Codex, Claude, OpenCode, terminal, and desktop sessions into MP4s you can review locally and then publish as a short share URL. If an agent CLI is already open, the fastest path is to paste one block and let it do the rest.

Replay rendering and redaction happen locally first.
You review the output before anything gets published.
The hosted surface is for watch pages, embeds, and share links.

Start Here

Paste this into your agent CLI

This is the lowest-friction path if Codex, Claude, OpenCode, or a similar agent CLI is already open.

Install and authenticate asdf.tube, then publish my latest Codex session.

Run:
npx @asdftube/cli@latest auth
npx @asdftube/cli@latest replay codex latest --publish --yes

When auth asks for email, use [your email here] and wait for the magic-link or PIN step to complete.
Then print the final share URL.

Then MCP

MCP-friendly path

Use this when your agent runtime can call tools directly and you want the same local-review-first publish flow without copying shell commands by hand.

Use asdf.tube through MCP when available.

Preferred flow:
- export the active session
- review the redactions locally
- render locally
- publish the final MP4 to asdf.tube

Existing Video

Upload what you already have

If you already recorded a desktop or screen walkthrough, just publish it.

npx @asdftube/cli@latest publish ./demo.mp4 --title "Desktop walkthrough"

Capture

Record terminal, desktop, or one window

Capture is available from the CLI. On macOS, desktop/window capture needs Screen Recording permission for the terminal app running asdftube.

npx @asdftube/cli@latest record terminal --cmd "seq 1 10" --publish --title "Terminal demo"
npx @asdftube/cli@latest record desktop --seconds 10 --publish --title "Desktop capture"
npx @asdftube/cli@latest record windows
npx @asdftube/cli@latest record window --app "iTerm2" --seconds 10 --publish --title "Window capture"

Direct CLI

Manual shell path

Use this if you want explicit command-line control instead of the pasteable Codex flow.

npx @asdftube/cli@latest auth
npx @asdftube/cli@latest replay codex latest --review-only
npx @asdftube/cli@latest replay codex 019d97eb-3dbc-70c2-ac2b-dfad275f98c6 --publish --yes
npx @asdftube/cli@latest publish ./demo.mp4 --title "Desktop walkthrough"