CompozyOS
CompozyOS is an operating system for AI agents that provides a complete environment to create, automate, and supervise agent work using agent CLIs like Claude Code, OpenClaw, and Hermes. It solves the engineering challenges of running agents continuously—loops, triggers, cron, memory, permissions, approvals, and observability—by turning them into core objects. Built for developers and technical operators who want a local-first, daemon-based runtime for durable agent sessions.
✨ Key features
- Create reusable sessions, agents, loops, and capabilities as objects.
- Automate with cron schedules, webhooks, and triggers.
- Supervise with approvals, permissions, and inspectable run state.
- Daemon-owned state survives terminal closure.
- Runs ACP-compatible CLIs: Claude Code, OpenClaw, Hermes.
- Local-first with one Go binary and SQLite-backed stores.
🎯 Use cases
- Run long-lived agent sessions that continue after closing the terminal.
- Schedule recurring agent tasks with cron and webhooks.
- Build custom tools and extensions using the extension SDK.
- Manage multiple agents and workspaces from a single daemon.
- Integrate agent workflows with MCP, HTTP/SSE, and native tools.
📦 Installation
🧰 Requirements: Requires macOS or Linux, with Go or npm for installation; no API keys mentioned.
Verified installer
curl -fsSL https://compozy.com/install.sh | sh
NPM
npm install -g @compozy/cli@beta
Go
go install github.com/compozy/compozy@<release-tag>
From Source
git clone https://github.com/compozy/compozy.git
cd compozy
go build -o ./bin/compozy .
🚀 Usage
compozy install
compozy daemon start
compozy session new --agent general --name first-run
⚠️ Good to know
The v0.3 line is in beta; the previous v0.2.15 product is deprecated and maintained only for critical fixes on the legacy/v0.2 branch.
❓ FAQ
What agent CLIs does CompozyOS support?
It runs ACP-compatible agent CLIs including Claude Code, OpenClaw, and Hermes.
How do I install the beta version?
Use the verified installer, npm with @compozy/cli@beta, or go install with the release tag from the latest release.
Is CompozyOS local-first?
Yes, it is local-first by default, with one Go binary and SQLite-backed stores keeping runtime state on the operator's machine unless a configured provider or extension owns an external boundary.
What is the migration path from v0.2?
The v0.2.15 product is deprecated; start with the migration guide (MIGRATION_GUIDE.md) before replacing an existing v0.2 installation.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.