Toru

Let your agent record anything. Your coding agent records any flow in your own Chrome or on your Mac: launch clips, changelog GIFs, help-center guides and bug repros. Toru is its camera, editor and brand kit, and checks every take.

• Hosted: toru.tools (free tier, no card) · Docs: toru.tools/docs · For agents: toru.tools/llms.txt

• Works with Claude Code, Claude, Cursor, Codex and any remote MCP client.

• MIT licensed. See LICENSING.md, TRADEMARKS.md and THIRD_PARTY_NOTICES.md.

How it works

1. Your agent plans the flow. It reads your product's code (or the live UI) for the exact screens, labels and values, and writes a short plan that ends on a visible final state.

2. Your agent records it. recording_run opens the product in a window of its own, in your signed-in Chrome (Toru for Chrome) or on your Mac (Toru for Mac), starts recording and hands the window to the agent. The agent clicks and types with the browser_* tools, marks the result and calls recording_run_finish.

3. Toru finishes the video. It holds on the result, renders with your brand (background, logo, cards, cursor and zoom settings), checks the take (blank, frozen or too-short videos are held back) and returns an MP4 and a GIF.

Toru adds no model of its own: the agent you already use does the driving. Passwords never reach the agent or Toru; the product is already signed in where it records.

Related MCP server: Agent Demo Studio

What is in this repository

Use the hosted service

Sign up at toru.tools, then connect your agent to https://mcp.toru.tools/mcp (OAuth), or install the plugin. In Claude Code:

/plugin marketplace add alifoo/toru-skills
/plugin install toru@toru-skills

Pair Toru for Chrome (Chrome Web Store) or Toru for Mac (curl -fsSL https://toru.tools/install.sh | bash) from the link your agent sends you, then ask for a demo.

Run it yourself

Self-hosting is free and needs no model key. It is young: billing-free defaults and a one-command docker compose setup are in progress, so expect to read .env.example.

Requirements: Node 24.21+, pnpm 10.33, Chromium with a matching ChromeDriver, and FFmpeg.

pnpm install --frozen-lockfile
pnpm build
# Variables from .env.example in the process environment; the server does not read .env files.
export SESSION_ENCRYPTION_KEY="$(openssl rand -base64 32)"   # keep it: it encrypts stored sessions
pnpm start                                                   # the recorder (MCP server)

• Toru for Chrome against your server: TORU_SERVER=https://your-server node apps/extension/build.mjs, then load apps/extension/dist unpacked.

• Toru for Mac: apps/macos/build.sh (macOS 15+, Apple silicon); point it at your server in the pairing screen.

• The optional Toru navigator (a hosted model that drives instead of your agent) needs TYPESAFE_API_KEY and DEFAULT_NAVIGATOR=toru; by default the agent drives.

Develop

pnpm typecheck
pnpm test
CHROMEDRIVER_BINARY=/path/to/chromedriver RENDER_BROWSER_BINARY=/path/to/chromium node scripts/smoke-local.mjs

scripts/smoke-local.mjs runs a real MCP → browser → MP4 → download round trip without any model.

Contributing and security

Contributions are welcome under the DCO: see CONTRIBUTING.md. Report vulnerabilities privately as described in SECURITY.md.