Compozy Reference Guide

Comprehensive reference for the Compozy CLI and its AI-assisted development workflow.

What Is Compozy

Compozy is a Go CLI that orchestrates the full lifecycle of AI-assisted development. It covers product ideation, technical specification, task decomposition, automated execution via AI coding agents, and PR review remediation.

Key characteristics:

• Agent-agnostic. Supports claude, codex, copilot, cursor-agent, droid, gemini, opencode, and pi as ACP runtimes.
• Skills-based. Bundled skills (installed via compozy setup) teach agents how to execute each workflow phase.
• Artifact-driven. Planning and review artifacts live as markdown under .compozy/tasks/<slug>/, versioned alongside the codebase.
• Daemon-backed runtime. A home-scoped daemon owns run state, workspace registration, snapshots, streams, and the synced global.db catalog under ~/.compozy/.
• Single binary, local-first. The daemon is launched from the same binary; there are no external control planes.

Workflow Pipeline Overview

The standard development pipeline follows these phases in order. Each phase produces artifacts consumed by the next.