Repository navigation
Comitiva 0.3.0 brings guidelines: write your house style, rules and reference notes once, choose who gets each one, and every agent's prompt carries only the guidelines meant for it. If you already keep an AGENTS.md or CLAUDE.md, import it.
Comitiva is an early-stage open source project, in development and testing. Expect rough edges, keep copies of files you let agents change, and tell us what breaks.
What's new
- Guidelines. A new screen in the sidebar (Cmd/Ctrl+5). A guideline is a named block of Markdown: an instruction, a rule or reference data, such as the house style, who your customers are, or a glossary.
- Who gets each one. Every agent, the agents with a tag (the tags your agents already have are the groups), or only the agents that pick it in their form. The form shows the guidelines that already reach the agent, greyed, with the reason; the agent's panel lists them all.
- Only what applies. A run gets the agent's role, then the guidelines that reach it, in the order of the list. With no guidelines, the prompt is exactly the role, as before. It works the same for API models and for Claude Code and Codex.
- AGENTS.md in and out. Import makes one guideline per
##section of a Markdown file (headings inside code blocks are left alone). Export writes them all back as oneAGENTS.md, keeping who gets each one, so importing it elsewhere gives the same result. An imported guideline reaches no agent until you pick it or change its scope, so importing a file never changes what your agents get on its own.
The decision and its trade-offs: ADR 0020.
Install
| System | File | Notes |
|---|---|---|
| macOS (Apple silicon / Intel) | Comitiva-0.3.0-mac-arm64.dmg / …-mac-x64.dmg |
Not signed yet: the first time, macOS blocks it; open System Settings → Privacy & Security and click Open Anyway. New versions are announced in the app with a download link. |
| Windows 10/11 | Comitiva-0.3.0-win-x64-setup.exe |
Not signed yet: SmartScreen shows More info → Run anyway. Installs for your user; updates install on restart. |
| Linux (Debian, Ubuntu) | Comitiva-0.3.0-linux-amd64.deb |
sudo apt install ./Comitiva-0.3.0-linux-amd64.deb. Updates install on restart. |
| Linux (Fedora, openSUSE) | Comitiva-0.3.0-linux-x86_64.rpm |
sudo dnf install ./Comitiva-0.3.0-linux-x86_64.rpm |
| Linux (any) | Comitiva-0.3.0-linux-x86_64.AppImage |
chmod +x it and run it. Updates itself. |
Already on 0.2.0? The app offers this update on its own.
Not in this release
- Guidelines are Personal. In a workspace on a hub, shared agents get none for now, so a shared agent answers the same whoever sends the message; workspace guidelines, stored on the hub, come with Phase 9.
- Exporting agents as a file does not carry guidelines yet. Use Export on the Guidelines screen to move them.
What's next
A web UI served by the hub, and team agents the hub runs with team keys, so people without the desktop app can join in. See the roadmap.
Every change in this release, commit by commit: CHANGELOG.md.