A self-hosted orchestration layer for coding agents that runs on your own machine or hardware, without a cloud subscription. Markdown files are a useful starting point, but Coleo adds task management and collaboration tools for both agents and humans.
Current status: works great with opencode. Additional harnesses are in active development (for example, Codex CLI, Claude Code, Gemini CLI, Kimi, and future tools).
Most agent frameworks rely on rigid control hierarchies or specialized agent instances. Coleo emphasizes independent exploration and ad hoc coordination so agents can evaluate each other and share what they learn. Agent sessions are ephemeral generalists that learn quickly and repeatedly solve problems in concert.
Two-thirds of an octopus's neurons are in its arms, not its head. Coleo arms have their own memory, tools, and decision capacity.
The Brain does not command — it evaluates. Arms submit structured proposals, log discoveries, and query the Brain for clarification.
Coleo is coordination, not blind autonomy: file claims, security rules, and proposals keep multi-agent work inspectable and safe while offering surprising velocity.
The central coordination point that prompts all agents, evaluates proposals, offers tasks to consider, and shares status updates with you.
Arms are general-purpose agent sessions that run in popular CLI coding tools. Arms are managed through harnesses. Today, Coleo can run multiple opencode sessions; the architecture is designed to support any CLI coding agent as new harnesses are implemented.
Read the Harness Contract for the adapter interface and event model that makes this possible.
A living map of the workspace: file claims, activity, and conflict zones that help arms avoid collisions. Coming soon
A clean web UI and a CLI provide two ways to observe, direct, and improve your agent workflows: choose visual oversight, terminal speed, or both.
You instantiate arms, and the Brain assigns tasks from the database. The database syncs with Markdown files in your repo.
Arms work independently and cooperatively within their Gardens. Humans can observe activity through the CLI or web UI.
Arms submit structured proposals, discoveries, and complaints to the Brain as well as regular status reports.
The Brain continuously assigns tasks, drives consensus, and keeps agents busy with new work.
Plan in one place, execute across many agents, and inspect outcomes in either the web UI or CLI without losing control of prompts, plans, or runtime state.
src/harness/__tests__/opencode-tui.test.ts, src/harness/__tests__/event-stream.test.ts, and src/harness/__tests__/model-resolver.test.ts. Traditional orchestration dictates. Coleo converses. Each interaction is a proposal that can be accepted, rejected, or debated.
Arms communicate through typed proposals with reasoning, not raw diffs. They post events to a stream for the Brain to process.
Reputation systems and internal debate resolve disagreements.
Humans can observe and correct arms, or delegate oversight to the Brain, which can intervene at any point. Coleo gracefully handles stuck agents and reboots sessions that are not making progress.
A Garden is your workspace made visible: who is touching what, what they claim, and where conflicts are forming.
Released under Business Source License 1.1, balancing sustainable development with individual access.
Free for individual developers. Install locally, use commercially, experiment freely.
For teams and companies. Contact us for commercial licensing options.
Business Source License 1.1 (BSL)
Becomes Apache 2.0 on the Change Date (four years after release).