Compagnion

Your agents do the work.
You keep the overview.

Compagnion is a native Mac app for Claude Code and Codex. Every task gets its own git worktree, so several agents can work at once without getting in each other's way. You follow along, approve, review and merge.

Download for Mac

macOS 14 or later · Apple silicon

Native Windows app Coming soon

CodeCompagnion / vdboots/42-search-the-sidebar Create PR ⇧⌘P
Add a search field to the sidebar that filters by name and branch.
Read SidebarView.swift
Edit SidebarView.swift
Edit AppModel.swift
Bash swift build

There's now a search field above the workspaces (⌘F). It filters on title and branch, ignores case, and Esc clears it. A repo without matches collapses.

SidebarView.swift +84 −6 AppModel.swift +31 −2 +2 more
Ask anything, or give the next task… Opus 5.5 ▾

Everything you need to let agents do the work

⑂ Parallel, each in its own worktree

A workspace is a git worktree with its own branch. Start as many as you like: agents never touch each other's files, and your own checkout stays untouched.

◐ Claude Code and Codex

Pick the agent and model per session. Both show up in the same chat, with the same tools and the same approvals: allowing a command is one click.

↺ What every turn changed

Compagnion snapshots the working tree at the start and end of every turn. See which files each turn changed, and revert a turn with one click.

# From issue to merge

Start a workspace from a GitHub issue and the agent gets the ticket as its first task. A model writes the pull request; you follow the checks and merge from the app.

▦ Dashboard

Every workspace as a card, in a column per status: in progress, in review, done. With the branch, +N −M, the agent's last reply and the next step.

▶ Setup, run and terminals

Give a repo a setup script, a run script and actions of your own, like Test. They run in the worktree, and Preview opens a dev server on localhost.

◷ Keeps working

The agents run in a daemon, not in the window. Close the app and the work carries on. While an agent is busy, your Mac stays awake.

⌘ Native, all the way

Built in SwiftUI: no Electron, no web view. It feels like part of macOS, and ⌘K takes you anywhere. The Windows app will be just as native.

⌂ Everything on your own Mac

No account and no server in between. Repos, sessions and history live locally in ~/.compagnion; the agents use your own subscription or API key.

How it works

  1. 1

    Add a project

    Pick a git repo on your Mac or clone one from GitHub. Optionally give it a setup script, like npm ci.

  2. 2

    Start a workspace

    From an issue or with a name of your own. Compagnion creates the worktree, runs the setup and starts the agent.

  3. 3

    Review and merge

    Read the diff, steer in the chat, open a pull request and merge. Then archive the workspace.

Install

With Homebrew

brew install --cask innovative365nl/tap/compagnion

Installs the app and the compagnion CLI.

Or download it

  1. Download Compagnion and open the disk image.
  2. Drag Compagnion to the Applications folder.
  3. Open the app. It's signed with a Developer ID and notarized by Apple, so it opens like any other app.
  4. Add a project and start your first workspace.

From the command line too

The app ships with the CLI. Put it on your PATH:

ln -s /Applications/Compagnion.app/Contents/Helpers/compagnion ~/.local/bin/compagnion

What you need

  • macOS 14 Sonoma or later, on a Mac with Apple silicon
  • git (comes with the Xcode Command Line Tools)
  • Claude Code and/or Codex, signed in
  • For pull requests and issues: the GitHub CLI (gh auth login)

Compagnion looks for claude, codex and gh on the PATH of your login shell. If they live elsewhere, set the path under Settings → Advanced.

Updates itself

Compagnion checks for a new release every six hours, installs it and switches to it as soon as no agent is busy. You can turn that off under Settings → General.

Let the agents do the work.

Download for Mac

macOS 14 or later · Apple silicon

Native Windows app Coming soon