CLI
Commands
Find, read, push, organize — everything comitia can do.
Every command also has comitia --help. To use a different workspace just for one call, add -c <id>.
Connection
| Command | What it does |
|---|---|
comitia init -g | Connect via browser + install AI rules file and skills (all folders) |
comitia login | Connect by allowing it in the browser |
comitia login --paste | For remote machines — connect by pasting a code |
comitia login <token> | Connect with an issued token (CI/scripts) |
comitia logout | Remove the connection from this machine |
comitia whoami | How you're currently connected |
comitia companies | List your workspaces |
comitia use <id or name> | Set the default workspace |
Raw sources — as they came in
Slack, email, and Tiro meeting notes come in automatically on the hour. You can pull them without waiting for organizing to run.
| Command | What it does |
|---|---|
comitia recent [count] | Recently received sources |
comitia find <word> | Search the raw sources |
comitia raw <id...> | Full text of a source (id is the first 8 chars from recent/find) |
comitia sync [slack|tiro|notion|calendar] | Pull in now — instead of waiting for the hourly sync. Requires sources & organize permission |
The organized wiki
| Command | What it does |
|---|---|
comitia list [prefix] | List documents (e.g. comitia list topics/) |
comitia search <word> | Search the wiki body text — exact-word matches only |
comitia read <path...> | Read document contents (multiple at once) |
comitia graph | How documents link to each other |
Let your AI do the organizing — sources & organize permission
| Command | What it does |
|---|---|
comitia rules | This workspace's wiki rules — read before writing |
comitia push <title> <file|-> | Add a source |
comitia build | Build ledgers/tables from raw data (code only, no cost) |
comitia pending | Sources that still need summarizing |
comitia write <path> <file|-> | Save a summary to the wiki (e.g. topics/logistics.md) |
comitia organize | Let Comitia's own AI do the organizing |
comitia skills | Install/update Claude Code skills |
comitia slack <channel> <file|-> | Post to Slack through the connected bot — the bot needs chat:write. Your AI should always ask before posting |
comitia slack … --thread-of "<query>" | Reply in-thread to a message — finds the parent post by searching its text (last 100 posts). You can also pass --thread <ts> directly |
comitia slack … --edit-of "<query>" | Rewrites a message the bot posted instead of posting a new one — like ticking ✅ on a checklist. Bot messages only; you can also pass --edit <ts> |
comitia slack <channel> --delete-of "<query>" | Deletes a message the bot posted. This can't be undone. Bot messages only; you can also pass --delete <ts> |
Examples
# What came up on Slack today?
comitia recent 20
# Find and read sources mentioning "renewal"
comitia find renewal
comitia raw d213b634
# Upload a meeting note and rebuild the base
comitia push "0910 daily" notes.md
comitia build
comitia pending