Ce Ai

`ce-ai` — Compound Engineering CLI Orchestrator & Workflow FSM Engine

`ce-ai` is a fast, safe Rust CLI for orchestrating the **[Compound Engineering Plugin](https://github.com/EveryInc/compound-engineering-plugin)** across 10 native AI agent harnesses (`opencode`, `claude`, `pi`, `cursor`, `copilot`, `codex`, `grok`, `kimi`, `agy`, `fx`) plus custom fallback mode. It governs the **7-stage Compound Engineering Flywheel** via a stage-gated FSM whose bookkeeping (stage transitions, checkpoint recording) is deterministic — agent execution itself is probabilistic — with workspace scope isolation, atomic POSIX disk writes, and FSM-validated workflow checkpoints (recording is opt-in).

[!NOTE] `ce-ai` orchestrates distributions of the open-source **[Compound Engineering Plugin](https://github.com/EveryInc/compound-engineering-plugin)** — a suite of specialized skills, roles, and workflow guidelines for AI coding assistants.

Quick Path

**1. Install the binary** (pick one):

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/mastepanoski/ce-ai/main/scripts/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/mastepanoski/ce-ai/main/scripts/install.ps1 | iex

# Homebrew (macOS & Linux) — auto-taps mastepanoski/ce-ai
brew install mastepanoski/ce-ai/ce-ai

# From source
cargo install --path .

Every release publishes `SHA256SUMS.txt` alongside its binaries — verify any download before running it (ISO/IEC 27002 integrity control).

**2. Preview the plugin installation** (modifies nothing):

ce-ai install --all --dry-run

**3. Verify system health:**

ce-ai doctor

That's it — your harnesses are ready for Compound Engineering. Run your first 7-stage cycle with the [Quick Start Workflow Guide](docs/user-guide/quick-start-workflow-guide.md).

**First install hitting `403 Forbidden`?** GitHub allows 60 unauth requests/hour per IP. `ce-ai install/upgrade` queries `api.github.com` — without a token yo