A
licenseNot graded
qualityB
maintenanceEnables AI coding agents to capture screen and voice recordings, extract timestamped frames, and receive structured Markdown reports with context for bug fixing and UI feedback.
17 npm
18
MIT
Toru
by alifoo
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Torurecord a short demo of our signup flow as a branded GIF"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Toru
Recording infrastructure for your agent. Your coding agent records your product demos itself: 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
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.
Your agent records it.
recording_runopens 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 thebrowser_*tools, marks the result and callsrecording_run_finish.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
Path | What it is |
| The recorder: the MCP server, sessions, capture, the run pipeline and the delivery check. |
| The hosted service around the recorder: accounts, billing, render workers, backups. |
| The web console and site: demos, connections, brand, billing, docs. |
| Toru for Chrome, the extension that records in the user's own Chrome. |
| Toru for Mac, the app that records (and, when allowed, lets the agent operate) a window. |
| The renderer: camera, cursor, brand and export to MP4/GIF. |
| Browser control and page outlines for agents. |
| Plans, credits and billing rules of the hosted service. |
| The Toru skill for Claude Code, Cursor and Codex (alifoo/toru-skills). |
| The vendored OpenScreen editor the renderer builds on (MIT). |
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-skillsPair 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 loadapps/extension/distunpacked.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_KEYandDEFAULT_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.mjsscripts/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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Narrated demo and tutorial videos of your web app, from a guide or your coding agent.
Generate images, GIFs, videos, and PDFs from HTML, URLs, or templates — from your AI agent.
Demo-video assistant: records your web app click by click and returns an MP4 with zooms, captions.
Loom for agents: AI agents record narrated product demos, plus transcripts, summaries, and search.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to create polished product demo videos by controlling a real Chromium browser, recording actions, and rendering 1080p MP4s with narration, captions, and styled overlays.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to record narrated, zoom-animated product demo videos of websites entirely on-device, including outlining pages, scripting tours, recording MP4s, reviewing frames, and extracting embedded recipes to fork or rerender demos.5 npm4MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to operate a web app, record a deterministic session, and compile an editable project into a polished MP4 with zooms, cuts, captions, callouts, and reproducible renders.MIT