Work in progress. Comitiva is young. It is built in the open one phase at a time, and things will change between versions. Expect rough edges, and tell us about the ones you hit. See what is done and what is next · Report a problem
The Windows and macOS installers are not signed yet. Code signing for Windows and notarization for Apple are still to come, so Windows SmartScreen and macOS Gatekeeper will stop you the first time you open Comitiva. The steps to get past it are on each card below. The Linux packages are not affected.
The app is 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.
Comitiva stores API keys in your keyring (GNOME Keyring or KWallet). Without a running keyring it refuses to save keys and says why; local models without a key still work.
The AppImage updates itself. Where the system blocks user namespaces (Ubuntu 24.04+), it runs without Chromium’s sandbox; the deb and rpm keep it.
Then
1
Connections → Add connection. Pick a provider, paste a key (none for Ollama or LM Studio; Claude Code and Codex use their own login), then Test and Save.
2
Agents → +. Name it, pick the connection and a model, write its role. Under Tools, add folders or Google Drive.