
Witness
Records your voice and a browser session, then hands agents a causal evidence package
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.6.3
- Listing updated
- 3 days ago
About Witness
Witness is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The idea is to talk while you use your own product and let the recorder attach proof to each remark. One command, wit start with a dev URL, opens a managed browser and runs three streams at once: your speech with live transcription, every click with about 1.8 seconds of requests, responses, console errors and DOM changes afterwards, and a full rrweb DOM replay with screenshots. A click that produces no aftermath is itself logged as a dead click.
The result lands in a local .witness/sessions folder with a review.html for people and PROMPT.md, session.md and events.jsonl for agents. Running wit mcp turns the session into a stdio MCP server with 12 registered tools, so an agent can ask for just the evidence it needs. Nothing is uploaded and no account is required; the README describes it as MIT licensed.
It needs Node 18+ and Edge or Chrome, and installs from npm as witness-recorder.
Install
Run in a terminal
claude mcp add witness -- npx -y witness-recorderAdd to claude_desktop_config.json
{
"mcpServers": {
"witness": {
"command": "npx",
"args": [
"-y",
"witness-recorder"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"witness": {
"command": "npx",
"args": [
"-y",
"witness-recorder"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"witness": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"witness-recorder"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"witness": {
"command": "npx",
"args": [
"-y",
"witness-recorder"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"witness": {
"command": "npx",
"args": [
"-y",
"witness-recorder"
]
}
}
}Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- list_says
- Lists the spoken fragments in a session.
- events_around
- Returns events around a point in the timeline.
- get_dom_state
- Returns the page's DOM state.
- get_errors
- Returns errors captured in the session.
- get_shot
- Returns a screenshot from the session.
- get_body
- Returns a captured request or response body.
- session_md
- Returns the session timeline document.
- get_asr
- Reads the speech transcript.
- set_asr
- Updates the speech transcript.
What it does
- Voice-anchored timeline
- Attaches each spoken fragment to the clicks, requests and errors from that moment.
- Dead click capture
- Records clicks that cause nothing as evidence rather than dropping them.
- DOM replay
- Embeds an rrweb replay with screenshots and periodic snapshots.
- Queryable session
- Serves the session through a stdio MCP server instead of one large dump.
- Local-first storage
- Keeps everything on disk with no account or upload.
- Pause for privacy
- Freezes all events and audio when you press P.
Good for
- Report a visual bug by talking through it once
- Hand an agent the causal evidence behind a broken button
- Review a design or motion pass with spoken notes attached to the page state
- Collect several issues in one recording session
Pricing
Open source
MIT licensed, free to install from npm
Prices change. Check witness.zalize.com before you buy.
Witness FAQ
What do I need installed?
Node 18+ and a system Edge or Chrome; it falls back to bundled Chromium. Install with npm i -g witness-recorder.
Does anything leave my machine?
The README says sessions stay in .witness/sessions on your disk. Some commands re-run cloud ASR or an LLM, so check those settings.
Is it open source?
The comparison table on the site lists it as MIT.
How does an agent read the evidence?
Either paste PROMPT.md, or run wit mcp so the agent queries the session over stdio.
Is Witness free?
Yes. Witness is open source, so you can use and self-host it for free.
How do I add Witness to Claude Code?
Run this command in your terminal: claude mcp add witness -- npx -y witness-recorder
What are the best alternatives to Witness?
The closest alternatives to Witness are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.
Alternatives to Witness

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools