Docs

Reference

Environment variables

Variables the comity CLI and its hooks read, and what they override.

On this page

Environment variables override the stored login (comity login) for every command, including the hooks and MCP header helpers your agents run. Set them in the environment your agent starts from.

Connection

Variable Default Effect
COMITY_SERVER stored server, else https://api.comity.so Server URL. Used by every command, the hooks and comity login (when --server is not given). Must be http:// or https://.
COMITY_TOKEN stored token API token (cmt_…). Overrides the stored login everywhere. comity logout does not unset it.
COMITY_WEB_URL the web origin you logged in through, else https://comity.so Dashboard address used by comity open.

COMITY_SERVER and COMITY_TOKEN together are enough to run without comity login, for example in CI:

Terminal
export COMITY_SERVER=https://api.comity.so
export COMITY_TOKEN=cmt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
comity doctor

comity status, comity whoami and comity doctor show whether each value came from the environment ([env]) or the config file ([file]).

Behavior

Variable Effect
COMITY_SHARE_STATUS=0 Don't send the end-of-turn status (the agent's last message excerpt and files touched) to Comity. false, off and no also work. Teammates then see no status for your sessions. The org-wide switch is the share_session_status policy.
COMITY_NO_BROWSER comity login and comity open print the URL instead of opening a browser. Any non-empty value.
COMITY_DEBUG=1 comity mcp logs each forwarded message (method and id, never the token) and transport errors to stderr. Without it, only errors are logged. true also works.

Update checks

Variable Effect
COMITY_NO_UPDATE_CHECK=1 Turn off the background update check. Any value except empty, 0 or false. Same as --no-update-check.
CI When set (not empty, 0 or false): no update checks, no interactive questions, no colors.
COMITY_UPDATE_URL Override the release manifest URL (default <server>/cli/latest.json). For testing.

See CLI reference → Updates.

Terminal output

Variable Effect
NO_COLOR Any non-empty value turns colors off.
FORCE_COLOR 0 turns colors off; any other value (or empty) turns them on, even without a terminal.

--json output is never colored or interactive.

Paths

Variable Effect
XDG_CONFIG_HOME macOS/Linux: config folder is $XDG_CONFIG_HOME/comity instead of ~/.config/comity.
APPDATA Windows: config folder is %APPDATA%\comity.
COMITY_CLI_DIR omp bridge only: folder of the installed CLI package (containing comity.mjs) when it can't be found next to comity on PATH.

Read from agent hosts

The hook command reads a few variables that agent hosts set themselves, to tell which host invoked it and where: CLAUDE_PROJECT_DIR, CLAUDE_CODE_REMOTE, CURSOR_VERSION, CURSOR_PROJECT_DIR, CURSOR_CODE_REMOTE. You don't set these.