ZeroWidth docs

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

• Get started

  • OverviewZeroWidth keeps the decisions your team makes, checks each one against your numbers, and shows your team and your AI agents what worked.
  • Try ZeroWidth in five minutesRun ZeroWidth on your own computer, connect Claude Code, and see what ZeroWidth would read, without reading or sending anything.
  • ZeroWidth for agentsThe 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.
  • Hosted or self-hostedSelf-hosted ZeroWidth runs on your computer or your company's servers. Hosted ZeroWidth is run by us, with nothing to install.

• Connect your AI tools

  • How connecting worksEach AI tool connects to ZeroWidth over MCP with one address, and each person signs in as themselves.
  • ClaudeAdd ZeroWidth to Claude on the web and in the desktop app as a custom connector.
  • Claude CodeAdd ZeroWidth to Claude Code with one command, then sign in from /mcp.
  • ChatGPTAdd ZeroWidth to ChatGPT as a custom MCP server with OAuth sign-in.
  • CursorAdd ZeroWidth to Cursor from the ZeroWidth console in one click.
  • VS Code and GitHub CopilotAdd ZeroWidth to VS Code from the ZeroWidth console in one click, for GitHub Copilot's agent.
  • CodexAdd ZeroWidth to Codex with two commands.
  • WindsurfAdd ZeroWidth to Windsurf as an MCP server.
  • AntigravityAdd ZeroWidth to Google's Antigravity, which replaced Gemini CLI, through Antigravity's MCP settings file.
  • Microsoft Copilot StudioAdd ZeroWidth to an agent in Copilot Studio as an MCP tool with OAuth 2.0.
  • Other MCP toolsConnect any AI app that can add a remote MCP server.
  • Bring in past chatsUpload exports from Claude, ChatGPT and other tools, and ZeroWidth finds the decisions already made.

• MCP tools

  • MCP tools overviewThe tools and prompts an AI agent gets when connected to ZeroWidth, and what each one is for.
  • Find past decisionsrecall, ask and about look up earlier decisions, answer questions from them, and say what the record knows about a thing.
  • Report a decisionreport_decision records a decision just made in the conversation, with why, the goal, the number that should move and when to judge the decision.
  • Proposalspropose saves an idea or option that is not decided. drop_proposal sets one aside. report_decision decides one.
  • See what workedbest_and_worst ranks decisions by how far their numbers moved over a period.
  • Open questionsopen_questions lists the questions put to you, and answer_question and dismiss_question close them.
  • Read and edit wiki pageswiki_get and wiki_update read and edit the long-form page the team keeps about a thing.
  • Record numbersrecord_readings sends numbers for metrics already defined, such as a day's revenue or signups.

• Concepts

  • DecisionsA decision is a choice someone agreed to that changes what people will do or see, kept with who made it, when and why.
  • ProposalsA 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.
  • ExpectationsAn expectation says what a decision should change, which number should move and which way, and by when.
  • Metrics and readingsA metric is a number your team tracks, such as signups or revenue. Readings are its values over time.
  • The watchHow ZeroWidth decides when to judge a decision, what to compare its numbers with, and how big a move has to be.
  • VerdictsThe six verdicts a decision can get once its time is up, and what each one means.
  • Wiki pagesEach product, system or feature in the record can have a wiki page, written by your team and your AI tools together.
  • DreamingA second pass over parts of the record that proposes links, merges and questions that reading one conversation at a time can't see.

• Self-hosting

  • InstallRun ZeroWidth on your own computer or on one server inside your network.
  • ConfigurationSettings live in zerowidth.json, written by `zerowidth init`. Command-line options override it.
  • SourcesBring in the chats, documents, meetings, email and code history your team's decisions are already in.
  • MetricsConnect the numbers your decisions are measured by, from your tools, from files, or from a script.
  • AI models and costsUse an OpenRouter key or your own OpenAI-compatible model, and see the cost before ZeroWidth reads anything.
  • UpgradesUpdate ZeroWidth and start serve again. Your record moves to the new layout the first time the new version opens the record.
  • BackupsBack up the record, the numbers and the files beside the record, your settings, and the config folder that holds your team's token.
  • ExportsCopy every decision out of ZeroWidth as one file, with or without the original words.

• Hosted

  • Start a teamSign in, name your team, and follow the start page to connect your AI tools, your numbers and your people.
  • TeamsA hosted team has a separate record, one MCP address, and an owner.
  • Members and sign-inAdmins invite people to a hosted team. Each person signs in as themselves, and each person's AI tools act as that person.
  • Send numbers to hosted ZeroWidthA 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.
  • Plans and background readingHosted plans are priced by team size. The one thing measured is how much ZeroWidth reads in the background each month, counted in tokens.
  • BillingAn admin upgrades the team's plan, changes the card, sees invoices and cancels from the Team page.
  • Signup codes and the waitlistHosted ZeroWidth opens by waitlist. A signup code from ZeroWidth lets you start a team now.
  • Your dataWhere hosted ZeroWidth keeps your team's data, who can see it, and how to take it with you.
  • Delete a teamOnly 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.