ouroboros

English | 한국어

◯ ─────────── ◯



O U R O B O R O S

◯ ─────────── ◯

Stop prompting. Start specifying.
_{Agent OS for replayable, specification-first AI coding workflows}

Quick Start · Why · Results · How It Works · Commands · Philosophy

Turn a vague idea into a verified, working codebase -- across Claude Code, Codex CLI, OpenCode, and Hermes.

Ouroboros is an Agent OS for AI coding: a local-first runtime layer that turns non-deterministic agent work into a replayable, observable, policy-bound execution contract. It replaces ad-hoc prompting with a structured specification-first workflow: interview, crystallize, execute, evaluate, evolve.

Why Ouroboros?

Most AI coding fails at the input, not the output. The bottleneck is not AI capability -- it is human clarity.

Quick Start

Install — one command, everything auto-detected:

curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | bash

Build — open your AI coding agent and go:

> ooo interview "I want to build a task management CLI"

Works with Claude Code, Codex CLI, OpenCode, and Hermes. The installer detects Claude Code, Codex CLI, and Hermes CLI automatically and registers the MCP server. For OpenCode, run ouroboros setup --runtime opencode after installation.

claude plugin marketplace add Q00/ouroboros && claude plugin install ouroboros@ouroboros

pip install ouroboros-ai                # base
pip install ouroboros-ai[claude]        # + Claude Code deps
pip install ouroboros-ai[litellm]       # + LiteLLM multi-provider
pip install ouroboros-ai[mcp]           # + MCP server/client support
pip install ouroboros-ai[tui]           # + Textual terminal UI
pip install ouroboros-ai[all]           # everything (claude + litellm + mcp + tui + dashboard)
ouroboros setup                         # configure runtime

ouroboros uninstall

Python >= 3.12 required. See pyproject.toml for the full dependency list.

What You Get

After one loop of the Ouroboros cycle, a vague idea becomes a verified codebase: