Ballet

Ballet is a work-orchestration platform for AI software development. A human engineer plans work together with a planner agent; the plan becomes tickets; tickets are executed by autonomous coding agents (Claude Code, opencode, …) run by a fleet of agents in the projects’ devcontainer environments. Ballet does not build coding agents — it choreographs them: it decides what runs when, gives every run complete context, enforces process, and keeps humans in control.

Note

Ballet is young: its first version targets an unattended night of work on a real project. New here? Start with Quickstart.

Getting started

• Getting started
  • Quickstart
  • Your first real project

User guide

• User guide
  • Organizations and projects
  • Planning with the planner
  • Tickets and the board
  • Sessions and questions
  • The night shift
  • Pipelines and skills
  • Users and access

Concepts

• Concepts
  • Vision
  • Domain Model
  • Workflow
  • Ticket Pipeline
  • Questions and Human Involvement
  • Unattended Operation
  • Scheduling
  • Knowledge
  • Feature map
  • Skills
  • Ballet and the alternatives

Architecture

• Architecture
  • Architecture Overview
  • Components
  • Data
  • Security
  • Observability
  • APIs and Protocols
  • Architecture Decisions

How-to

• How-to Guides
  • Run Ballet locally
  • Install Ballet on one host
  • Build an agent pool from a devcontainer
  • Run Ballet on Ballet
  • Configure OIDC Authentication

Reference

• Reference
  • Configuration
  • REST API
  • Realtime API
  • Planner
  • Pipelines
  • Agents
  • LLM Gateway
  • Metrics
  • Knowledge MCP
  • Tracker MCP
  • Run Tokens

Development

• Development
  • Code Layout
  • Persistence
  • Changing the REST API
  • Web UI Development
  • Website and documentation publishing
  • Workflow
  • Make targets
  • Continuous integration
  • Failure injection