Compozy CLI
Compozy runs Claude Code, Codex and Cursor sessions: a task board, scheduled check-ins and a call to you only when needed.
- 2,864 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- A local daemon runs agents that read and change files, and always-on mode can act without asking within a daily limit.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/compozyDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- A local daemon runs agents that read and change files, and always-on mode can act without asking within a daily limit.
This is third-party code. Review the repository files before installing.
What it does
CompozyOS runs the agent CLIs you already have as durable sessions that outlive the terminal window. Each session lands on a board in Needs you, Working, Waiting, In review or Done. Parallel agents get their own checkouts (worktrees) and a tool call can wait for your approval. Always-on agents review the project on a schedule in a hidden read-only session and write reports. Loops define a goal, a way to verify it and an iteration cap, while schedules and signed webhooks live in one place. Fifteen integrations are supported, including Claude Code, Codex, Cursor Agent, Gemini CLI, Copilot CLI and OpenCode.
Who it is for. People running several agents in parallel who get lost between terminals and cannot tell which one is waiting for a decision.
Good fit when
- Five agents work on different tasks and you need one screen showing who needs an answer.
- An agent should check new GitHub issues daily and write a report without your involvement.
- A session stopped on one agent's limit and the work must pass to another through a handoff.
- Risky tool calls should wait for your approval instead of running silently.
Not a fit when
- A single agent in a single terminal: a management layer would be excessive.
- You need fully isolated execution: agents work with your files and subscriptions.
- You want a no-setup install: the README itself calls the experience technical, with a local daemon and `config.toml`.
Example request
Start the local Compozy daemon and create a session with the `general` agent named `first-run` in this repository, then show it on the board.Limitations
Compozy itself does not resell model access: you use your own subscriptions and agent CLI keys. The installer from the README downloads and installs a binary, and always-on agent mode can carry out proposed actions without asking up to a daily limit you set, so set that limit conservatively. Scheduled check-ins need Claude, Codex or OpenCode. Today it is a terminal, a local daemon and `config.toml`, with a desktop app for macOS and Linux. Some features work through extensions, including ones from third parties.
How to disable. Stop the daemon with `compozy daemon stop`, remove the package (`npm uninstall -g @compozy/cli` or `brew uninstall compozy`) and the settings folder with `config.toml`.
FAQ
How do I install Compozy?
Through Homebrew (`brew install compozy/compozy/compozy`), npm (`npm install -g @compozy/cli`), `go install` or the installer with Sigstore provenance checks.
Which agents does it support?
Among 15 built-in integrations are Claude Code, Codex, Cursor Agent, Gemini CLI, Antigravity, Copilot CLI, OpenCode, Pi, Kimi CLI and Qwen Code.
What is a Loop?
A named contract: a goal, a way to verify it and a stop. It has an iteration cap and seven endings: done, no-op, blocked, failed, exhausted, stalled and canceled.
How do always-on agents work?
They review the project on a schedule in a hidden read-only session, report to a main session and propose actions. A quiet check costs no model call.
Is Compozy paid?
The README licenses the code as MIT and does not resell model access. You pay only for your own subscriptions and keys.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that lets agents in different terminals message, watch and spawn each other
A pixel-art office in the browser: each Claude Code or Codex session sits at a desk, types and raises a hand when it needs you.
A memory and coordination layer for coding agents: specs and issues live in git while agents work in parallel
PromptOps keeps Claude Code, Codex and Gemini CLI side by side by project and gives a lead agent MCP to launch helpers
A resumable workflow for long-running tasks and a skill platform: from requirements to delivery, with phase checks and skill evaluation
A desktop app where Claude Code, Codex, Gemini and other agents work as a team of specialists in a shared project
README in short
The README presents CompozyOS as a control plane for agent sessions: a board, always-on agents, verified loops and schedules. It installs through npm, Homebrew, Go or a verified installer.