Oh My OpenAgent
An OpenCode and Codex CLI layer for orchestrated coding workflows and integrated developer tools.
- Source repo
- code-yeongyu/oh-my-openagent
- Stars
- ★ 71k
- Last updated
- today
- License
- NOASSERTION
- Primary language
- TypeScript
- FA score
- 49/100 · Major gaps
At a glance
- How it runs
- Works with
- Portable with changesClaude CodeCodex · OpenAI API · Claude API (Partial support)
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- An OpenCode team wants a lead agent to delegate frontend, deep-execution, quick-change, and architecture tasks to specialized task categories.
- Not a fit if
- Users who want to stay on Claude Code or Cursor and won't install an OpenCode/Codex host
- Individuals unwilling to set up multi-provider model auth and subscriptions
- Source review
- 49/100 · Major gaps
What does this agent do, and when should you use it?
Oh My OpenAgent is a software-development agent extension delivered as an Ultimate Edition for OpenCode and a Light Edition for Codex CLI. The OpenCode edition includes named agents such as Sisyphus, Hephaestus, and Prometheus, background agents, Team Mode, 54+ lifecycle hooks, built-in MCPs, and tmux integration. The Codex CLI edition is installed through lazycodex-ai and supplies rules, comment checking, git-bash, LSP, ultrawork, ulw-loop, start-work continuation, telemetry, and plugin-scoped MCPs including grep_app, context7, and codegraph. Both editions expose ultrawork/ulw, LSP support, and rules injection, while agent orchestration and team_* tools are Ultimate-only. It fits developers prepared to install and configure a local CLI extension in a supported agent harness.
Its installers write local plugin and configuration state: bunx oh-my-openagent install for Ultimate and npx lazycodex-ai install for Light. At runtime, it can load applicable context from AGENTS.md, README.md, and .omo/rules/**; Ultimate can also route work by category and coordinate members through tools including team_create, team_send_message, team_task_create, and team_status. It exposes code operations such as lsp_rename, lsp_goto_definition, lsp_find_references, and lsp_diagnostics, alongside AST-Grep, tmux, websearch, context7, and grep_app integrations. ultrawork or ulw starts a shared persistent-work mode, while ulw-loop stores multi-goal state under .omo/ulw-loop/. Ultimate's Hashline editing uses LINE#ID content hashes to validate the lines an edit targets.
- An OpenCode team wants a lead agent to delegate frontend, deep-execution, quick-change, and architecture tasks to specialized task categories.
- A Codex CLI user wants rules injection, LSP, ultrawork, and MCP components without adopting the full OpenCode edition.
- An engineer working in a large repository needs rename, definition lookup, reference search, and diagnostics through LSP tools.
- A developer wants
/start-workto invoke Prometheus for interview-style planning before implementation begins. - An OpenCode user wants to enable Team Mode and observe a lead plus up to eight parallel members in a tmux layout.
- A project maintainer needs to override agent models, permissions, hooks, or Team Mode through
.opencode/oh-my-openagent.jsonc.
How do you install or deploy this agent?
For OpenCode Ultimate Edition, run bunx oh-my-openagent install, then follow the installer’s model-selection and provider-authentication prompts. For Codex CLI Light Edition, run npx lazycodex-ai install in a Node.js/npm environment; a non-interactive autonomous-permissions setup is npx lazycodex-ai install --no-tui --codex-autonomous. Light does not require Bun and writes its managed plugin, marketplace, and configuration state under ~/.codex/.
How do you use this agent?
After installation, type ultrawork or ulw in the relevant harness to begin the workflow. OpenCode users can enable Team Mode in .opencode/oh-my-openagent.jsonc, setting team_mode.enabled to true and configuring max_parallel_members and tmux_visualization; restart OpenCode to unlock team_* tools. Use /start-work for the Prometheus planning flow, and /init-deep when you want hierarchical AGENTS.md files generated for project context.
What are this agent's strengths and limitations?
- It has two explicitly scoped delivery modes: a full OpenCode edition and a portable Codex CLI edition with documented feature boundaries.
- Ultimate includes category-based delegation, background agents, and Team Mode with dedicated team_* coordination tools and tmux visualization.
- It combines LSP, AST-Grep, MCPs, and hash-validated Hashline edits for code navigation, search, and guarded editing.
- Rules injection supports AGENTS.md and
.omo/rules/**, while configuration can override agents, models, permissions, and hooks.
- Full orchestration, Team Mode, AST-Grep, and tmux integration are limited to OpenCode Ultimate; Codex Light has no team_* tools.
- Installation and operation require a local shell, filesystem, network access, and a specific host: OpenCode plus Bun for Ultimate, or Codex CLI plus Node/npm for Light.
- Provider authentication and model selection are part of setup; the documented paths include Anthropic, Gemini, Copilot, Z.ai, and OpenCode Zen, so cost depends on the chosen provider and subscription.
- Anonymous telemetry is enabled by default; it is described as at most once per machine per UTC day with a hashed installation identifier, but opting out requires configuration or environment variables.
How does this agent compare with similar options?
Compared with using Codex CLI alone, the Light Edition adds rules, LSP, git-bash, ultrawork, ulw-loop, and plugin-scoped MCPs, but it does not include Ultimate's agent orchestration or Team Mode. Compared with Claude Code, the project states compatibility with Claude Code hooks, commands, skills, MCPs, and plugins; that compatibility claim does not make Claude Code the runtime host for this product.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Oh My OpenAgent This agent | 49 · Major gaps | Agent plugin / skillFree + model costs | ★ 71k | today | TypeScript | Claude Code |
| Oh My OpenCode Slim | 50 · Major gaps | Agent plugin / skillFree + model costs | ★ 10k | today | TypeScript | OpenAI API |
| Claudexor | 76 · Good | CLIFree + model costs | ★ 522 | today | TypeScript | Codex · Claude Code |
| Rovai AI | 49 · Major gaps | — | ★ 251 | today | Rust | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence: LSP daemon has authentication and ownership checks, tests cover permission modes (0o700/0o600) and symlink attack protection, indicating handling of sensitive data (e.g., auth tokens). However, overall permission model is not explicit, telemetry (PostHog) is enabled by default, and no user confirmation mechanism is provided. Deductions: telemetry default-on, lack of user confirmation; data flow transparency insufficient; dependency security not fully addressed.
Evidence: CI workflows (test, typecheck, codex-compatibility) and test files exist, indicating some consistency. However, dependency availability not verified, failure messages not detailed. Deductions: dependency availability not verified; failure messages not detailed.
Evidence: README describes multiple use scenarios (Ultimate/Light editions, Team Mode, different models), capability boundaries are stated (e.g., Light edition has only 8 components), trigger method (ultrawork command) is clear, environment fit (OpenCode/Codex) is documented. Deductions: capability boundaries rely on README assertions, not deep code verification.
Evidence: Installation guide, configuration docs, feature docs exist, information architecture clear; install notes detailed; naming has compatibility notes (oh-my-opencode/oh-my-openagent); examples and FAQ present; license is SUL-1.0 (non-standard); version number exists (4.19.4), CI auto-generates changelog; maintenance responsibility clear (author). Deductions: license non-standard, may restrict use; known limitations not explicitly listed.
Evidence: Output usability high (provides many tools and features), marginal value high (solves real problems), but cost-benefit not quantified. Deductions: cost-benefit not quantified, relies on external model subscriptions.
Evidence: README includes user testimonials and performance data (e.g., success rate improvement), but no reproducible method provided; cross-source verification insufficient; facts and inferences not clearly separated. Deductions: claims lack traceability, cross-source verification insufficient.
- Anonymous telemetry (PostHog) is enabled by default, requiring user opt-out, which may raise privacy concerns.
- License is SUL-1.0, a non-standard open-source license, which may restrict commercial use.
- Relies on external model subscriptions (e.g., ChatGPT, Kimi), which may incur significant costs.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
Release notes excerpt
Runs on senpi 2026.11.3-3: Claude Opus and Fable get their full system prompt back (the pre-diet wording; every other model keeps the slimmer prompt), Anthropic Subscription no longer refuses a working Claude login as blocked when an older omo process is still running or when Claude Code can't read its login behind a locked keychain, a usage limit with an ISO reset time blocks that account until the reset instead of retrying every minute, a goal waits for the first limited account to come back instead of spending turns, and Shift+Enter inserts a newline in macOS Terminal.app. ([#12311](https:/ …View on GitHub ↗ -
Release notes excerpt
Changed - Built-in reasoning defaults are back to their values before 5.1.59: daily mode runs Claude Opus 5.5 at medium effort again, and every other rung raised to high in 5.1.59 returns to its previous medium or xhigh setting. ([#12271](https://github.com/code-yeongyu/oh-my-openagent/issues/12271)) ([#12272](https://github.com/code-yeongyu/oh-my-openagent/pull/12272)) …View on GitHub ↗ -
Release notes excerpt
Runs on senpi 2026.11.2-3: the first message of a new session no longer stalls for several seconds, and agent kill/pkill/killall commands that would hit protected processes are refused. ([#12200](https://github.com/code-yeongyu/oh-my-openagent/pull/12200)) Fixed - Memory sync refuses a received item on Windows whose working path git cannot stage (at or past MAX_PATH, which git for Windows opens without core.longpaths), dropping it with a receipt before anything is rendered instead of failing the sync commit and wedging the device on every resume (#12199). POSIX behaviour is unchanged. …View on GitHub ↗
FAQ
Do I have to use OpenCode?
Does it require a paid model plan?
Does Light automatically grant full autonomous permissions?
--codex-autonomous explicitly enables it in the documented non-interactive command.Does it send telemetry?
OMO_DISABLE_POSTHOG=1 can opt out.