Introduction
What Compagnion is, and where to start in the docs.
Compagnion is a native Mac app for coding agents. It runs Claude Code and Codex side by side, each task in a workspace of its own: a git worktree on its own branch. Several agents can work at once without touching each other's files, while you follow along, approve what they want to run, review the diff of every turn, open a pull request and merge.
The agents run in a small background program, the daemon, not in the window. Close the app and the work carries on; open it again and you're back where you were.
Get started
- Install: get Compagnion on your Mac and sign in.
- Your first workspace: add a project and put an agent to work.
- Set up a project: give a project a setup script, a run script and actions, so every workspace comes up ready.
Concepts
- Workspaces and worktrees: what a workspace is, how it's named, and what archiving keeps.
- Agents and sessions: Claude Code and Codex, models, permission modes and approvals.
- What every turn changed: the files each turn touched, their diff, and reverting a turn.
- From issue to merge: start from a GitHub issue, open a pull request, follow the checks and merge.
Features
- Secrets: paste a token, password or key and it stays out of the chat.