Install

Get Compagnion running on your Mac.

What you need

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:

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