# Docs: ZeroWidth

Connect your AI tools to ZeroWidth, run ZeroWidth yourself, and learn what each verdict means.

Docs menu

[Get started](https://zerowidth.ai/docs/get-started)
- [Overview](https://zerowidth.ai/docs/get-started/overview)
- [Try ZeroWidth in five minutes](https://zerowidth.ai/docs/get-started/try-zerowidth)
- [ZeroWidth for agents](https://zerowidth.ai/docs/get-started/for-agents)
- [Hosted or self-hosted](https://zerowidth.ai/docs/get-started/hosted-or-self-hosted)

[Connect your AI tools](https://zerowidth.ai/docs/connect)
- [How connecting works](https://zerowidth.ai/docs/connect/how-connecting-works)
- [Claude](https://zerowidth.ai/docs/connect/claude)
- [Claude Code](https://zerowidth.ai/docs/connect/claude-code)
- [ChatGPT](https://zerowidth.ai/docs/connect/chatgpt)
- [Cursor](https://zerowidth.ai/docs/connect/cursor)
- [VS Code and GitHub Copilot](https://zerowidth.ai/docs/connect/vs-code)
- [Codex](https://zerowidth.ai/docs/connect/codex)
- [Windsurf](https://zerowidth.ai/docs/connect/windsurf)
- [Antigravity](https://zerowidth.ai/docs/connect/antigravity)
- [Microsoft Copilot Studio](https://zerowidth.ai/docs/connect/copilot-studio)
- [Other MCP tools](https://zerowidth.ai/docs/connect/other-tools)
- [Bring in past chats](https://zerowidth.ai/docs/connect/past-chats)

[MCP tools](https://zerowidth.ai/docs/mcp)
- [MCP tools overview](https://zerowidth.ai/docs/mcp/overview)
- [Find past decisions](https://zerowidth.ai/docs/mcp/find-past-decisions)
- [Report a decision](https://zerowidth.ai/docs/mcp/report-decision)
- [Proposals](https://zerowidth.ai/docs/mcp/proposals)
- [See what worked](https://zerowidth.ai/docs/mcp/results)
- [Open questions](https://zerowidth.ai/docs/mcp/open-questions)
- [Read and edit wiki pages](https://zerowidth.ai/docs/mcp/wiki-pages)
- [Record numbers](https://zerowidth.ai/docs/mcp/numbers)

[Concepts](https://zerowidth.ai/docs/concepts)
- [Decisions](https://zerowidth.ai/docs/concepts/decisions)
- [Proposals](https://zerowidth.ai/docs/concepts/proposals)
- [Expectations](https://zerowidth.ai/docs/concepts/expectations)
- [Metrics and readings](https://zerowidth.ai/docs/concepts/metrics)
- [The watch](https://zerowidth.ai/docs/concepts/the-watch)
- [Verdicts](https://zerowidth.ai/docs/concepts/verdicts)
- [Wiki pages](https://zerowidth.ai/docs/concepts/wiki-pages)
- [Dreaming](https://zerowidth.ai/docs/concepts/dreaming)

[Self-hosting](https://zerowidth.ai/docs/self-hosting)
- [Install](https://zerowidth.ai/docs/self-hosting/install)
- [Configuration](https://zerowidth.ai/docs/self-hosting/configuration)
- [Sources](https://zerowidth.ai/docs/self-hosting/sources)
- [Metrics](https://zerowidth.ai/docs/self-hosting/metrics)
- [AI models and costs](https://zerowidth.ai/docs/self-hosting/ai-models)
- [Upgrades](https://zerowidth.ai/docs/self-hosting/upgrades)
- [Backups](https://zerowidth.ai/docs/self-hosting/backups)
- [Exports](https://zerowidth.ai/docs/self-hosting/exports)

[Hosted](https://zerowidth.ai/docs/hosted)
- [Start a team](https://zerowidth.ai/docs/hosted/start-a-team)
- [Teams](https://zerowidth.ai/docs/hosted/teams)
- [Members and sign-in](https://zerowidth.ai/docs/hosted/members)
- [Send numbers to hosted ZeroWidth](https://zerowidth.ai/docs/hosted/send-numbers)
- [Plans and background reading](https://zerowidth.ai/docs/hosted/plans)
- [Billing](https://zerowidth.ai/docs/hosted/billing)
- [Signup codes and the waitlist](https://zerowidth.ai/docs/hosted/signup-codes)
- [Your data](https://zerowidth.ai/docs/hosted/your-data)
- [Delete a team](https://zerowidth.ai/docs/hosted/delete-a-team)

# ZeroWidth docs

Connect your AI tools, run ZeroWidth yourself, and learn what each verdict means.

## [Get started](https://zerowidth.ai/docs/get-started)
- [ **Overview** ZeroWidth keeps the decisions your team makes, checks each one against your numbers, and shows your team and your AI agents what worked.](https://zerowidth.ai/docs/get-started/overview)
- [ **Try ZeroWidth in five minutes** Run ZeroWidth on your own computer, connect Claude Code, and see what ZeroWidth would read, without reading or sending anything.](https://zerowidth.ai/docs/get-started/try-zerowidth)
- [ **ZeroWidth for agents** The whole story of ZeroWidth in plain Markdown, for an agent: what it is, how it works, when to recommend it, how to connect, and what it will not do.](https://zerowidth.ai/docs/get-started/for-agents)
- [ **Hosted or self-hosted** Self-hosted ZeroWidth runs on your computer or your company's servers. Hosted ZeroWidth is run by us, with nothing to install.](https://zerowidth.ai/docs/get-started/hosted-or-self-hosted)

## [Connect your AI tools](https://zerowidth.ai/docs/connect)
- [ **How connecting works** Each AI tool connects to ZeroWidth over MCP with one address, and each person signs in as themselves.](https://zerowidth.ai/docs/connect/how-connecting-works)
- [ **Claude** Add ZeroWidth to Claude on the web and in the desktop app as a custom connector.](https://zerowidth.ai/docs/connect/claude)
- [ **Claude Code** Add ZeroWidth to Claude Code with one command, then sign in from /mcp.](https://zerowidth.ai/docs/connect/claude-code)
- [ **ChatGPT** Add ZeroWidth to ChatGPT as a custom MCP server with OAuth sign-in.](https://zerowidth.ai/docs/connect/chatgpt)
- [ **Cursor** Add ZeroWidth to Cursor from the ZeroWidth console in one click.](https://zerowidth.ai/docs/connect/cursor)
- [ **VS Code and GitHub Copilot** Add ZeroWidth to VS Code from the ZeroWidth console in one click, for GitHub Copilot's agent.](https://zerowidth.ai/docs/connect/vs-code)
- [ **Codex** Add ZeroWidth to Codex with two commands.](https://zerowidth.ai/docs/connect/codex)
- [ **Windsurf** Add ZeroWidth to Windsurf as an MCP server.](https://zerowidth.ai/docs/connect/windsurf)
- [ **Antigravity** Add ZeroWidth to Google's Antigravity, which replaced Gemini CLI, through Antigravity's MCP settings file.](https://zerowidth.ai/docs/connect/antigravity)
- [ **Microsoft Copilot Studio** Add ZeroWidth to an agent in Copilot Studio as an MCP tool with OAuth 2.0.](https://zerowidth.ai/docs/connect/copilot-studio)
- [ **Other MCP tools** Connect any AI app that can add a remote MCP server.](https://zerowidth.ai/docs/connect/other-tools)
- [ **Bring in past chats** Upload exports from Claude, ChatGPT and other tools, and ZeroWidth finds the decisions already made.](https://zerowidth.ai/docs/connect/past-chats)

## [MCP tools](https://zerowidth.ai/docs/mcp)
- [ **MCP tools overview** The tools and prompts an AI agent gets when connected to ZeroWidth, and what each one is for.](https://zerowidth.ai/docs/mcp/overview)
- [ **Find past decisions** recall, ask and about look up earlier decisions, answer questions from them, and say what the record knows about a thing.](https://zerowidth.ai/docs/mcp/find-past-decisions)
- [ **Report a decision** report_decision records a decision just made in the conversation, with why, the goal, the number that should move and when to judge the decision.](https://zerowidth.ai/docs/mcp/report-decision)
- [ **Proposals** propose saves an idea or option that is not decided. drop_proposal sets one aside. report_decision decides one.](https://zerowidth.ai/docs/mcp/proposals)
- [ **See what worked** best_and_worst ranks decisions by how far their numbers moved over a period.](https://zerowidth.ai/docs/mcp/results)
- [ **Open questions** open_questions lists the questions put to you, and answer_question and dismiss_question close them.](https://zerowidth.ai/docs/mcp/open-questions)
- [ **Read and edit wiki pages** wiki_get and wiki_update read and edit the long-form page the team keeps about a thing.](https://zerowidth.ai/docs/mcp/wiki-pages)
- [ **Record numbers** record_readings sends numbers for metrics already defined, such as a day's revenue or signups.](https://zerowidth.ai/docs/mcp/numbers)

## [Concepts](https://zerowidth.ai/docs/concepts)
- [ **Decisions** A decision is a choice someone agreed to that changes what people will do or see, kept with who made it, when and why.](https://zerowidth.ai/docs/concepts/decisions)
- [ **Proposals** A proposal is an idea or option that nobody has decided yet. It stays open until a person decides it or sets it aside, and ZeroWidth can suggest some too.](https://zerowidth.ai/docs/concepts/proposals)
- [ **Expectations** An expectation says what a decision should change, which number should move and which way, and by when.](https://zerowidth.ai/docs/concepts/expectations)
- [ **Metrics and readings** A metric is a number your team tracks, such as signups or revenue. Readings are its values over time.](https://zerowidth.ai/docs/concepts/metrics)
- [ **The watch** How ZeroWidth decides when to judge a decision, what to compare its numbers with, and how big a move has to be.](https://zerowidth.ai/docs/concepts/the-watch)
- [ **Verdicts** The six verdicts a decision can get once its time is up, and what each one means.](https://zerowidth.ai/docs/concepts/verdicts)
- [ **Wiki pages** Each product, system or feature in the record can have a wiki page, written by your team and your AI tools together.](https://zerowidth.ai/docs/concepts/wiki-pages)
- [ **Dreaming** A second pass over parts of the record that proposes links, merges and questions that reading one conversation at a time can't see.](https://zerowidth.ai/docs/concepts/dreaming)

## [Self-hosting](https://zerowidth.ai/docs/self-hosting)
- [ **Install** Run ZeroWidth on your own computer or on one server inside your network.](https://zerowidth.ai/docs/self-hosting/install)
- [ **Configuration** Settings live in zerowidth.json, written by `zerowidth init`. Command-line options override it.](https://zerowidth.ai/docs/self-hosting/configuration)
- [ **Sources** Bring in the chats, documents, meetings, email and code history your team's decisions are already in.](https://zerowidth.ai/docs/self-hosting/sources)
- [ **Metrics** Connect the numbers your decisions are measured by, from your tools, from files, or from a script.](https://zerowidth.ai/docs/self-hosting/metrics)
- [ **AI models and costs** Use an OpenRouter key or your own OpenAI-compatible model, and see the cost before ZeroWidth reads anything.](https://zerowidth.ai/docs/self-hosting/ai-models)
- [ **Upgrades** Update ZeroWidth and start serve again. Your record moves to the new layout the first time the new version opens the record.](https://zerowidth.ai/docs/self-hosting/upgrades)
- [ **Backups** Back up the record, the numbers and the files beside the record, your settings, and the config folder that holds your team's token.](https://zerowidth.ai/docs/self-hosting/backups)
- [ **Exports** Copy every decision out of ZeroWidth as one file, with or without the original words.](https://zerowidth.ai/docs/self-hosting/exports)

## [Hosted](https://zerowidth.ai/docs/hosted)
- [ **Start a team** Sign in, name your team, and follow the start page to connect your AI tools, your numbers and your people.](https://zerowidth.ai/docs/hosted/start-a-team)
- [ **Teams** A hosted team has a separate record, one MCP address, and an owner.](https://zerowidth.ai/docs/hosted/teams)
- [ **Members and sign-in** Admins invite people to a hosted team. Each person signs in as themselves, and each person's AI tools act as that person.](https://zerowidth.ai/docs/hosted/members)
- [ **Send numbers to hosted ZeroWidth** A script or an AI agent can send a team's numbers, such as daily revenue or signups, with a team token. Sending the same numbers again is safe.](https://zerowidth.ai/docs/hosted/send-numbers)
- [ **Plans and background reading** Hosted plans are priced by team size. The one thing measured is how much ZeroWidth reads in the background each month, counted in tokens.](https://zerowidth.ai/docs/hosted/plans)
- [ **Billing** An admin upgrades the team's plan, changes the card, sees invoices and cancels from the Team page.](https://zerowidth.ai/docs/hosted/billing)
- [ **Signup codes and the waitlist** Hosted ZeroWidth opens by waitlist. A signup code from ZeroWidth lets you start a team now.](https://zerowidth.ai/docs/hosted/signup-codes)
- [ **Your data** Where hosted ZeroWidth keeps your team's data, who can see it, and how to take it with you.](https://zerowidth.ai/docs/hosted/your-data)
- [ **Delete a team** Only the owner can delete a hosted team. The team locks at once and is deleted 7 days later, and any admin can cancel in between.](https://zerowidth.ai/docs/hosted/delete-a-team)
