Skip to content
/

oh-my-openagent (omo)

oh-my-openagent · code-yeongyu/oh-my-openagent · ★ 60k · last commit 2026-05-26

Multi-provider AI agent orchestration for OpenCode: escape vendor lock-in by routing Sisyphus (Claude/Kimi/GLM) and Hephaestus (GPT-5.5) as a coordinated team.

Best whenClaude Code is a nice prison; the future of AI coding is orchestrating multiple competing model providers, not locking into one.
Skip ifPaying $200/month for a single provider, Vendor lock-in
vs seeds
claude-flow(code-class subagents, MCP architecture, multi-agent) but targets OpenCode rather than Claude Code and uses true multi-p…
Primitive shape 93 total
Skills 10 Subagents 11 Hooks 52 MCP tools 20
00

Summary

oh-my-openagent (omo) — Summary

oh-my-openagent (omo) by code-yeongyu is the largest framework in this batch (59,562 stars, 30 contributors), originally named oh-my-opencode and undergoing a multi-harness refactor to support OpenCode, Codex, Pi, and other agent runtimes. Built as a native OpenCode plugin (TypeScript + Bun), it ships 11 named agent personas (Sisyphus, Hephaestus, Oracle, Librarian, Explore, Atlas, Prometheus, Metis, Momus, Multimodal-Looker, Sisyphus-Junior), ~52 lifecycle hooks, 20-39 tools (config-gated), a 3-tier MCP system, the Hashline LINE#ID edit tool, IntentGate keyword detection, Team Mode (lead + up to 8 parallel members in tmux), and a Boulder feature for work tracking. The flagship model assignment is Sisyphus (planner/orchestrator) on claude-opus-4-7/kimi-k2.6/glm-5.1 and Hephaestus (deep worker) on gpt-5.5 — making this the most aggressive multi-model framework in the batch. The framework received notable notoriety for reportedly causing Anthropic to block OpenCode due to OAuth token handling. Closest seed comparison: resembles claude-flow in its code-class subagents and MCP architecture, but targets OpenCode rather than Claude Code and adds multi-provider model routing as a first-class feature.

01

Overview

oh-my-openagent (omo) — Overview

Origin

Created by code-yeongyu (@yeon_gyu_kim), developed and maintained by an AI assistant called Jobdori (running on a customized fork of OpenClaw). Named oh-my-opencode originally; dual-published during transition as oh-my-opencode and oh-my-openagent.

Notable Background

"Anthropic blocked OpenCode because of us. Yes, this is true. They want you locked in. Claude Code is a nice prison, but it's still a prison."

"You don't need to pay $200 for 2 hours of work. The future isn't picking one winner; it's orchestrating them all."

The framework is philosophically positioned as anti-vendor-lock-in, routing work across Claude (Anthropic), GPT-5.5 (OpenAI), Kimi K2.6 (Moonshot), and GLM-5.1 (Zhipu).

Agent Philosophy: Named Mythological Agents

  • Sisyphus: main orchestrator — plans, delegates, drives to completion with parallel execution, does not stop halfway. Runs on claude-opus-4-7/kimi-k2.6/glm-5.1
  • Hephaestus: autonomous deep worker — explores codebase, researches, executes end-to-end. Runs on gpt-5.5. Nicknamed "The Legitimate Craftsman" (irony at Anthropic's "legitimate" framing)
  • Prometheus: strategic planner — interview mode, asks questions before any code. Runs on claude-opus-4-7/kimi-k2.6/glm-5.1
  • Oracle: research specialist
  • Librarian: documentation/knowledge specialist
  • Explore: codebase exploration specialist
  • Atlas: unknown
  • Metis: craftsmanship/quality
  • Momus: critic/adversarial reviewer
  • Multimodal-Looker: visual/multimodal
  • Sisyphus-Junior: lightweight orchestration

Key Differentiators

  1. Multi-provider model routing: hard-assigns specific models to specific agent roles
  2. Hashline LINE#ID edit tool: content-hash validated edits eliminating stale-line errors
  3. IntentGate: analyzes true user intent before classifying/acting
  4. Team Mode: tmux-based lead + 8 parallel members with real-time visualization
  5. Boulder: work tracking state machine with CLI (cli/boulder)
  6. Comment Checker: prevents AI-generated filler in code comments
  7. Skill-Embedded MCPs: each skill carries its own MCP servers (no context bloat)
  8. LSP + AST-Grep via built-in MCP servers
02

Architecture

oh-my-openagent (omo) — Architecture

Distribution

  • npm package: oh-my-opencode (dual-published as oh-my-openagent during transition)
  • Version: 4.5.0
  • Primary runtime: OpenCode plugin (TypeScript + Bun)
  • Platform binaries: pre-built for darwin-arm64, darwin-x64, linux-arm64, linux-x64, linux-musl variants, windows-x64

Install

Copy and paste to LLM agent:

Install and configure oh-my-openagent by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Or fetch install guide via curl:

curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Required Runtime

  • OpenCode (primary)
  • Bun (build)
  • Claude Code (compatibility layer)
  • tmux (Team Mode)

Directory Tree

oh-my-openagent/
├── src/
│   ├── index.ts              — Plugin entry (18-line wrapper)
│   ├── plugin-config.ts      — JSONC multi-level config (Zod v4)
│   ├── plugin-interface.ts   — 11 OpenCode hook handlers
│   ├── create-managers.ts    — 4 managers (Tmux, Background, SkillMcp, ConfigHandler)
│   ├── create-tools.ts       — ToolRegistry
│   ├── create-hooks.ts       — 5-tier hook composition
│   ├── agents/               — 11 agent definitions
│   ├── hooks/                — ~52 lifecycle hooks (57 dirs)
│   ├── tools/                — 13 native tool dirs
│   ├── features/             — 20 feature modules
│   ├── shared/               — 297 utility files
│   ├── config/               — Zod v4 schema (30 files)
│   ├── cli/                  — install, run, doctor, boulder, mcp-oauth
│   └── mcp/                  — 5 built-in MCPs (3 remote + lsp + ast_grep)
├── packages/
│   ├── oh-my-opencode-{platform}/ — platform binaries (11)
│   ├── lsp-tools-mcp/        — LSP MCP server
│   ├── ast-grep-mcp/         — AST grep MCP server
│   ├── boulder-state/        — work tracking state machine
│   ├── hashline-core/        — Hashline edit primitives
│   ├── model-core/           — model resolution pipeline
│   ├── prompts-core/         — prompt loading + bundled mode prompts
│   ├── rules-engine/         — rule discovery + matching
│   └── web/                  — Marketing site (Next.js 15 + Cloudflare Workers)
├── bin/                      — platform-detection shim
├── .opencode/                — project-scope skills + commands
├── .omo/                     — AI agent workspace (plans, tasks)
└── docs/                     — user guide, reference, legal

Target AI Tools

  • Primary: OpenCode
  • Secondary: Claude Code (compatibility layer)
  • Supports: any MCP client (3-tier MCP system)

State Root

.omo/ — agent workspace (run-continuation, plans, tasks, notepads)

03

Components

oh-my-openagent (omo) — Components

11 OpenCode Hook Handlers (Plugin Interface)

Handler Hook Purpose
config config 6-phase config pipeline
tool tool 20-39 registered tools (config-gated)
chat.message chat.message Session setup, keyword detection
chat.params chat.params Anthropic effort, think mode
chat.headers chat.headers Copilot x-initiator header
command.execute.before command.execute.before Pre-command guards
event event Session lifecycle, openclaw dispatch
tool.execute.before tool.execute.before Write guard, label truncation, rules injection
tool.execute.after tool.execute.after Comment checker, hashline enhancer
experimental.chat.messages.transform messages.transform Context injection, thinking validation
experimental.chat.system.transform system.transform System-message transforms
experimental.session.compacting session.compacting Context + todo preservation
experimental.compaction.autocontinue compaction.autocontinue Auto-resume after compaction

Agent Personas (11)

Agent Model Role
Sisyphus claude-opus-4-7/kimi-k2.6/glm-5.1 Main orchestrator; plans, delegates, drives to completion
Hephaestus gpt-5.5 Autonomous deep worker; end-to-end execution
Prometheus claude-opus-4-7/kimi-k2.6/glm-5.1 Strategic planner; interview mode
Oracle unknown Research specialist
Librarian unknown Documentation/knowledge
Explore unknown Codebase exploration
Atlas unknown unknown
Metis unknown Quality/craftsmanship
Momus unknown Critic/adversarial review
Multimodal-Looker unknown Visual/multimodal tasks
Sisyphus-Junior unknown Lightweight orchestration

Tools (Always-on, 20)

lsp_goto_definition, lsp_find_references, lsp_symbols, lsp_diagnostics, lsp_prepare_rename, lsp_rename, grep, glob, ast_grep_search, ast_grep_replace, session_list, session_read, session_search, session_info, background_output, background_cancel, call_omo_agent, task (delegate), skill, skill_mcp

Built-in MCP Servers (5)

  • LSP tools MCP (local stdio)
  • AST-grep MCP (local stdio)
  • 3 remote MCPs: Exa (web search), Context7 (official docs), Grep.app (GitHub search)

Skills (ultrawork, search, analyze, team, hyperplan, security-research + more)

Loaded from .opencode/ project-scope skills.

Boulder (Work Tracking)

CLI subcommand: cli/boulder
State machine: packages/boulder-state/
Commands: boulder create, list, complete, status, split, etc.

Hook Presets (~52 hooks in 57 dirs)

Categories: session, tool-guard, transform, continuation, skill
Notable: zauc-mocks (5), team-session-events (1)

05

Prompts

oh-my-openagent (omo) — Prompts

Verbatim Excerpt 1: AGENTS.md (Plugin Architecture Overview)

Prompting technique: Architecture-first documentation with initialization flow; tool count disclosure

## 13 OPENCODE HOOK HANDLERS

11 wired in src/plugin-interface.ts + 2 wired directly in src/testing/create-plugin-module.ts
(experimental.session.compacting + experimental.compaction.autocontinue).

## INITIALIZATION FLOW

pluginModule.server(input, options)
  ├─→ installAgentSortShim()       # patches Array.prototype for canonical agent ordering
  ├─→ initConfigContext()          # opencode-vs-openagent layout flag
  ├─→ detectExternalSkillPlugin()  # warn on conflicts
  ├─→ injectServerAuthIntoClient() # auth headers into shared SDK client
  ├─→ loadPluginConfig()           # JSONC parse → user/project merge → Zod validate → migrate
  ├─→ initializeOpenClaw()         # if openclaw config present
  ├─→ checkTeamModeDependencies()  # if team_mode.enabled
  ├─→ createManagers()             # TmuxSessionManager, BackgroundManager, SkillMcpManager, ConfigHandler
  ├─→ createTools()                # SkillContext + AvailableCategories + ToolRegistry
  ├─→ createHooks()                # 5-tier: Session + ToolGuard + Transform + Continuation + Skill
  └─→ createPluginInterface()      # 11 OpenCode hook handlers → PluginInterface

Verbatim Excerpt 2: README.md (Agent Philosophy)

Prompting technique: Role-locked model assignment; mythological persona framing

**Sisyphus** (claude-opus-4-7 / kimi-k2.6 / glm-5.1) is your main orchestrator.
He plans, delegates to specialists, and drives tasks to completion with aggressive parallel execution.
He does not stop halfway.

**Hephaestus** (gpt-5.5) is your autonomous deep worker. Give him a goal, not a recipe.
He explores the codebase, researches patterns, and executes end-to-end without hand-holding.
*The Legitimate Craftsman.*

**Prometheus** (claude-opus-4-7 / kimi-k2.6 / glm-5.1) is your strategic planner.
Interview mode: he asks questions, identifies scope, and builds a detailed plan
before a single line of code is touched.

Every agent is tuned to its model's specific strengths. No manual model juggling.

Verbatim Excerpt 3: README.md (Team Mode)

Prompting technique: Parallel coordination with real-time tmux visualization; human-readable progress

One agent is fast. A coordinated team is *devastating*.

Team Mode (v4.0, opt-in): Lead agent + up to 8 parallel members, real-time tmux visualization,
dedicated `team_*` tools. Powers `hyperplan` (5 hostile critics) and `security-research`
(3 hunters + 2 PoC engineers).
09

Uniqueness

oh-my-openagent (omo) — Uniqueness

Differs From Seeds

Closest seeds are claude-flow (code-class subagents, MCP architecture, multi-agent coordination) and superpowers (skills-based behavioral framework). Unlike claude-flow, omo targets OpenCode rather than Claude Code and uses real model diversity (Claude, GPT-5.5, Kimi, GLM) rather than a single provider. Unlike superpowers, omo ships a full code-class agent architecture with 13 OpenCode hook handlers (not skill files), explicit model assignments, and the Hashline edit tool for correctness. omo is the only framework in the corpus with a documented Anthropic policy incident (alleged blocking of OpenCode due to this tool's OAuth usage patterns), though the framework claims compliance through subprocess spawning rather than direct API access.

Positioning

  • Highest star count in the batch (59,562)
  • Primary competitive claim: escape vendor lock-in, orchestrate across Claude/GPT-5.5/Kimi/GLM
  • Boulder work tracking is unique in the batch — a state machine for tasks, not just markdown files
  • Hashline LINE#ID edit tool is a technical contribution not present in any seed or other batch member
  • /init-deep for hierarchical AGENTS.md generation is a unique token-efficiency feature

Observable Failure Modes

  • Multi-harness refactor in progress (AGENTS.md explicitly warns: "DO NOT TRUST THE STRUCTURE BELOW AS STABLE")
  • Anthropic policy incident: claimed blocking event creates adoption uncertainty
  • Package naming confusion: dual-published as both oh-my-opencode and oh-my-openagent during transition
  • Anonymous telemetry: default-on PostHog tracking may concern privacy-conscious users
  • ~313k LOC / 2167 TypeScript files: significantly more complex than other batch members; high audit surface
  • Bun runtime dependency: limits deployment environments vs pure Node.js

Canonical Status

Not a derivative of the oh-my-codex naming line — independent project that targets OpenCode rather than Codex CLI. The naming similarity ("oh-my-...") is intentional but architecturally distinct.

04

Workflow

oh-my-openagent (omo) — Workflow

Primary Entry Point

ultrawork  → Sisyphus orchestrates Hephaestus, Oracle, Librarian, Explore
             → Team Mode: lead + up to 8 parallel members in tmux

Workflow Modes

Mode Description
ultrawork / ulw Full orchestration: all discipline agents activate
/ulw-loop Ralph loop; doesn't stop until 100% done
Team Mode (v4.0) Lead + 8 parallel members, real-time tmux visualization
hyperplan 5 hostile critics review plan before execution
security-research 3 hunters + 2 PoC engineers for security research
Background Agents Fire 5+ specialists in parallel, results when ready
/init-deep Auto-generate hierarchical AGENTS.md files throughout project

Phases and Artifacts

Phase Agent Artifact Gate
Intent analysis IntentGate Intent classification Auto
Strategic planning Prometheus Plan artifact User approval
Orchestration Sisyphus Task assignments Auto
Implementation Hephaestus Code changes none
Parallel work Team workers Per-task commits Orchestrator review
Review Momus Review findings none
Completion Todo Enforcer Completion signal Agent idle detection

Approval Gates

  1. IntentGate: analyzes intent before acting — prevents literal misinterpretation
  2. hyperplan gate: 5 hostile critics must agree before execution (opt-in)
  3. Todo Enforcer: if agent goes idle before task is done, system yanks it back
  4. Comment Checker: rejects AI-generated filler comments before commit

Hashline Edit Tool

Every edit validated by LINE#ID content hash before applying. Zero stale-line errors. Inspired by oh-my-pi.

06

Memory Context

oh-my-openagent (omo) — Memory & Context

State Storage

Path Content Persistence
.omo/ Agent workspace (run-continuation, plans, tasks, notepads) Project
.opencode/ Project-scope skills + commands + background-tasks state Project
.agents/ Mirrored project-scope skills + commands Project
oh-my-opencode.log in os.tmpdir() Plugin log (50 MB cap, .1/.2 backups) Session

Boulder Work Tracking

packages/boulder-state/ — state machine for work items
Split storage: issue state + task graph persisted to filesystem
CLI: cli/boulder for managing work items

Context Compaction

Three hooks for compaction:

  1. experimental.session.compacting — preserves context + todo list across compaction
  2. experimental.compaction.autocontinue — auto-resumes after compaction completes
  3. Context + todo preservation explicitly documented

Session Recovery

  • .omo/run-continuation/ — allows interrupted runs to resume
  • Boulder state tracks task completion across sessions
  • AGENTS.md hierarchical files (via /init-deep) provide token-efficient project context

MCP-Based Memory

session_list, session_read, session_search, session_info tools provide structured session access.

Background Agents

background_output and background_cancel tools for managing background agent results.
Background agent results cached until consumed by foreground session.

07

Orchestration

oh-my-openagent (omo) — Orchestration

Multi-Agent: Yes

Full multi-agent architecture:

  • Team Mode: lead + up to 8 parallel members via tmux
  • Background Agents: fire 5+ specialists in parallel
  • call_omo_agent tool for direct agent dispatch
  • team_* tool group for team lifecycle management

Orchestration Pattern

hierarchical + parallel-fan-out (Sisyphus orchestrates specialists; Team Mode runs N workers in parallel)

Multi-Model: Yes — most explicit in batch

Hard-assigned model-to-agent mappings:

Agent Model Provider
Sisyphus claude-opus-4-7 / kimi-k2.6 / glm-5.1 Anthropic / Moonshot / Zhipu
Hephaestus gpt-5.5 OpenAI
Prometheus claude-opus-4-7 / kimi-k2.6 / glm-5.1 Anthropic / Moonshot / Zhipu

The README explicitly recommends Kimi K2.6 + GPT-5.5 as cost-effective alternative to Claude Code Pro.

Isolation Mechanism

process (tmux workers run separate OpenCode sessions)

Execution Mode

interactive-loop (OpenCode session) + background-daemon (background agents) + continuous-ralph (ulw-loop)

Consensus Mechanism

hyperplan: 5 hostile critic agents must agree before execution proceeds (opt-in)

Prompt Chaining

Yes: Prometheus plan → Sisyphus orchestration → Hephaestus execution is a chained pipeline

Context Compaction

Explicitly handled: experimental.session.compacting + experimental.compaction.autocontinue hooks

Max Concurrent Agents

Team Mode: lead + 8 = up to 9 simultaneous agents
Background Agents: 5+ mentioned

08

Ui Cli Surface

oh-my-openagent (omo) — UI & CLI Surface

CLI Binary

Binary: oh-my-opencode / oh-my-openagent (dual names, same bin/oh-my-opencode.js)
Subcommands: install, run, doctor, mcp-oauth, refresh-model-capabilities, get-local-version, boulder

Web Dashboard

packages/web/ — Marketing site (Next.js 15 + Cloudflare Workers). Not a local control panel — it's a public website.

Local UI: tmux Team Mode

  • Team Mode provides real-time tmux visualization of parallel agent work
  • Lead agent pane + N worker panes
  • team_* tools for runtime team management

IDE Integration

  • Claude Code compatibility layer (loads Claude Code plugins)
  • No native VSCode extension

MCP Integration (3-tier)

  1. Built-in MCPs (lsp-tools, ast-grep)
  2. .mcp.json project-scope servers
  3. Skill-embedded MCPs (each skill can carry its own MCP servers)

Observability

  • oh-my-opencode.log in os.tmpdir() — 50 MB rotating log
  • Session tools: session_list, session_read, session_search, session_info
  • Boulder state tracking via cli/boulder

Anonymous Telemetry

PostHog telemetry enabled by default (DAU/WAU/MAU tracking, hashed machine ID).
Disable: OMO_SEND_ANONYMOUS_TELEMETRY=0 or OMO_DISABLE_POSTHOG=1

Notification / External Integration

openclaw: Discord/Telegram/HTTP/shell reply listener daemon (src/openclaw/)
Triggered when openclaw config is present in plugin config.

Related frameworks

same archetype · same primary tool · same memory type

Claude-Flow / Ruflo ★ 55k

Eliminates single-agent context limits and sequential bottlenecks by orchestrating fault-tolerant swarms of specialized AI agents…

Hermes Agent (NousResearch) ★ 168k

Self-improving personal AI agent with closed learning loop, 7 terminal backends, and messaging gateway — not tied to any AI…

OpenCode ★ 165k

Terminal-first AI coding agent with multi-model routing, native desktop app, and a typed .opencode/ configuration system for…

OpenHands ★ 75k

Open-source AI software development platform (open-source Devin alternative) with Docker sandbox isolation, 77.6% SWE-bench…

DeerFlow ★ 70k

Long-horizon superagent that researches, codes, and creates by orchestrating parallel sub-agents with isolated contexts in Docker…

gpt-engineer ★ 55k

ARCHIVED — the original LLM-driven code generation experiment that generates entire applications from a prose specification file.