The Local-First AI Operating System

An enterprise-grade orchestration layer that transforms single AI coding agents into a fully functional engineering organisation.

---

⚡ Built Different. By Design.

CEO-in-a-Box plugs into your local environment and provisions an autonomous engineering workforce. Powered by 94 distinct domain engines, it replaces the fragile "prompt-and-pray" loops of single agents with a structured, resilient, and verifiable organisation.

• 100% Local-First: No accounts. No tracking. No telemetry.
• Provider Agnostic: 32 supported providers and 83 models out-of-the-box (OpenAI, Anthropic, Gemini, Ollama, LM Studio, etc.).
• One OS. Three Interfaces: Interact via the Desktop App (Tauri), the CLI, or the integrated TUI.
• Enterprise Governance: Built-in accountability, compliance, and quality gates that enforce your architectural rules before code is ever merged.

---

🛠 Quickstart

Download the latest native binary for macOS, Windows, or Linux directly from the Releases page.

Alternatively, install via script or package manager:

# MacOS / Linux install script
curl -fsSL https://ceoinabox.dev/install | bash

# NPM / Bun
bunx @ceoinabox/cli

Launch the Terminal User Interface:

ceo

---

🏗 Architecture

CEO-in-a-Box is built on a highly modular runtime foundation. All features are strictly decoupled via a dependency-injection container and a global event bus.

graph TD
    classDef layer fill:#1a1a1a,stroke:#333,stroke-width:1px,color:#fff;
    classDef engine fill:#ff3333,stroke:#ff3333,stroke-width:1px,color:#000;

    subgraph Interfaces
        A1[Desktop App]:::layer
        A2[CLI]:::layer
        A3[TUI]:::layer
    end

    subgraph CEO Orchestration
        B1[Executive Intent]:::layer
        B2[Organisation]:::layer
        B3[Forge Workflow]:::layer
    end

    subgraph Domain Engines
        C1[Engineering]:::engine
        C2[Governance]:::engine
        C3[Finance]:::engine
        C4[Quality]:::engine
    end

    subgraph Abstraction Layer
        D1[Provider APIs]:::layer
        D2[Knowledge Graph]:::layer
        D3[System Prompts]:::layer
    end

    Interfaces --> CEO_Orchestration
    CEO_Orchestration --> Domain_Engines
    Domain_Engines --> Abstraction_Layer

Loading

---

📖 Key Features

Capability	Description
Agents & Workforce	Spawn, suspend, resume, and terminate agents per department. Full lifecycle management.
Work Queue	Prioritised work items with dependencies, assignees, and blocking relationships.
Knowledge Graph	Organisational memory that persists locally in a graph format.
Plugin System	Drop a .tsx file in .opencode/plugins/ — screens and commands register automatically.
Visual Forge	Node editor with 67+ node types. Design data pipelines and execute them from the CLI.
Governance Gates	Policy-driven configurable quality gates for every stage of your SDLC.

---

🤝 Contributing

We welcome contributions! Please review our CONTRIBUTING.md for detailed guidelines.

Important Rules:

• The nightly branch is the primary integration branch. All Pull Requests must target nightly.
• The main branch is strictly protected for production-stable releases. Nobody commits directly to main.
• All development must conform to docs/ARCHITECTURE.md.

git clone https://github.com/millsydotdev/CEO-in-a-Box.git
cd CEO-in-a-Box
git checkout nightly
bun install
bun run typecheck
bun run test

📜 License

This project is licensed under the MIT License — see the LICENSE file for details. No tracking. No analytics. Your code remains yours.