◯ ─────────── ◯
O U R O B O R O S
◯ ─────────── ◯
It gets smarter on its own. We just hold the line.
Skip the prompt engineering. The agent runs, fails, and gets smarter every generation. The grading command and expected result never make it into the success contract we hand it.
The Agent OS for replayable AI coding workflows
Quick Start · Why · Results · How It Works · Commands · Philosophy · Guide
# macOS / Linux / WSL 2
curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | OUROBOROS_INSTALL_REF=readme-hero bash
# Windows (PowerShell) — no Python needed; installs Git and uv for you
irm https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.ps1 | iex
One command installs it. Then run ooo setup once inside your coding agent — details in Quick Start.
Demo videos for each runtime.
![]() Terminal CLI — a task-management CLI: ouroboros init start asking aboutordering and scope, then reporting an ambiguity score |
![]() ChatGPT (Codex) — called as an integration, on a video-publishing harness: the interview, its advisory lanes, and the ambiguity ledger |
![]() Claude Code — a YouTube automation task, with the six advisory lanes running in parallel before the interview submits |
![]() Hermes (Discord) — a kart-racing game, run as a chat bot, ending at Final ambiguity: 0.15 |
![]() DeepSeek Harness — an OSS-trend outreach script, driven from a dsh chat: mcp__ouroboros__ouroboros_interviewturn by turn, fan-out results submitted between rounds |
![]() Kiro — the Kiro CLI running the Ouroboros interview flow, turning a vague request into a structured, testable Seed |
![]() Antigravity — a YouTube-publishing automation interview: asks what to automate, shows advisory lanes, and submits the selected answer |
Turn a vague idea into a verified, working codebase -- across Claude Code, Codex CLI, OpenCode, Hermes, Gemini, Kiro, Copilot, Pi, OMP, Zcode, Goose, GJC, Antigravity, and Grok.
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.
Like any OS, Ouroboros is split into a stable OS layer of primitives, an application layer of domain workflows, and a shell that humans actually sit in front of. Three repos, one stack:
| Layer | Repo | Role | What it gives you |
|---|---|---|---|
| Shell (terminal client) | Ouro-labs/ourocode |
Native terminal UI for running ooo workflows across Claude / Codex / Gemini CLIs in one session |
TUI, wonderTool decision pickers, MCP pane state, command discovery |
| Apps (domain workflows) | Ouro-labs/ouroboros-plugins |
UserLevel plugin contract — composes core primitives into installable domain programs (PR ops, Jira sync, incidents, releases) | Plugin manifest, scoped permissions, audit/provenance, reference plugins |
| OS (this repo) | Q00/ouroboros |
Agent OS core — Seed, Ledger, Runtime, MCP, safety boundaries | ooo commands, spec-first workflow engine, multi-runtime adapter |
| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|