Install
Get Compagnion running on your Mac.
What you need
- macOS 14 Sonoma or later, on a Mac with Apple silicon.
- git, which comes with the Xcode Command Line Tools (
xcode-select --install). - Claude Code and/or Codex, installed and signed in. Compagnion uses your own subscription or API key.
- For pull requests and issues: the GitHub CLI, signed in with
gh auth login.
Install the app
With Homebrew:
brew install --cask innovative365nl/tap/compagnion
This puts Compagnion in Applications and the compagnion command-line tool on your PATH.
Or download the disk image, open it and drag Compagnion to Applications. The app is signed with a Developer ID and notarized by Apple, so it opens like any other app.
Sign in
The first time you open Compagnion it asks you to sign in with GitHub. You do this once: Compagnion only reads your name and email address, and after that it works offline too.
Where things live
Everything stays on your Mac:
~/.compagnionholds the daemon's database: your projects, workspaces, sessions and their history.- New workspaces go in
~/.compagnion/workspaces/<project>/<workspace>. You can pick another folder under Settings → Advanced; it applies to new workspaces, existing ones keep working where they are.
Claude Code, Codex and gh
Compagnion looks for claude, codex and gh on the PATH of your login shell, so what works in Terminal works in the app. If one of them lives somewhere else, set its path under Settings → Advanced. Use system Claude Code fills in what your shell finds, and shows the version that new sessions will run.
The command line
Everything the app does, the compagnion tool can do too: add projects, create workspaces, start sessions, send messages and follow them. Homebrew links it for you; with the disk image, link it yourself:
ln -s /Applications/Compagnion.app/Contents/Helpers/compagnion ~/.local/bin/compagnion
compagnion --help