Comity docs, a two-agent demo and a Compare page

Comity has proper documentation now, at comity.so/docs: setup, every supported agent, collaboration features, team admin and full references for the CLI, the MCP tools, the REST API and hook events.

New

Docs

• Start with the Quickstart: install the CLI, sign in, set up a repo and watch Comity catch your first conflict.
• Search every page with ⌘K, Ctrl K or /.
• Each page is also plain markdown: add .md to its address, for example /docs/quickstart.md. Agents can read the whole site from llms.txt.
• Code samples have a copy button.

A two-agent demo on the home page

The home page replays two agents coordinating through Comity: in one scenario Maya's Claude Code changes a function that Jordan's Codex has just started calling; in the other, an API field is renamed across two repos. The rename scenario arrived later the same day.

Compare

comity.so/compare is a dated, sourced comparison of Comity with agent messaging, session sharing, agent managers and Git and pull request tools, so you can see where each one fits.

Improved

• The Security page now shows the date its facts were last reviewed.