OMO开源AI代理框架

Installation

oh-my-openagent ships in three editions of the same product: two plugins that load into a host you already run, plus one standalone edition.

• Ultimate Edition (omo for OpenCode) — full omo. 11 agents, 54+ lifecycle hooks, 4 built-in MCPs (websearch, context7, grep_app, lsp), all slash commands, Team Mode, /goal, ultrawork — everything. Hashline edits are opt-in (hashline_edit: true).
• Light Edition (omo for Codex CLI) — the portable components that fit Codex's plugin system: rules, comment-checker, git-bash, lsp, ultrawork, ulw-loop, ulw-execute-continuation, and telemetry at the core, plus teammode and supporting components (bootstrap, lcx, and more), plugin-scoped MCPs for grep_app, context7, git_bash, and lsp, and the shared ast-grep skill. It installs Codex agent TOMLs into ~/.codex/agents/. No OpenCode team_* tools — Codex CLI's own spawn/collaboration surface does that work.
• Senpi Edition (standalone, beta) — the native omo command with the OMO extension built in. It installs from omo-ai@beta rather than loading into OpenCode or Codex.

Pick the edition(s) you want.

Uninstallation

To remove oh-my-openagent:

1. Remove the plugin from your OpenCode config

Edit ~/.config/opencode/opencode.json (or opencode.jsonc) and remove either "oh-my-openagent" or the legacy "oh-my-opencode" entry from the plugin array:

   # Using jq
   jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
       ~/.config/opencode/opencode.json > /tmp/oc.json && \
       mv /tmp/oc.json ~/.config/opencode/opencode.json
   

1. Remove configuration files (optional)

   # Remove the runtime config files
   rm -f ~/.omo/omo.jsonc ~/.omo/omo.json

   # Remove project config (if exists)
   rm -f .omo/omo.jsonc .omo/omo.json

   # Remove leftover legacy migration backups (if any)
   rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
         ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json \
         .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
         .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
   

1. Verify removal

   opencode --version
   # Plugin should no longer be loaded
   

1. Remove omo-codex (Codex CLI Light edition)

   npx lazycodex-ai uninstall
   # backward-compatible alias:
   npx lazycodex-ai cleanup

   omo-agent-toolkit uninstall --platform=codex
   # backward-compatible alias:
   omo-agent-toolkit cleanup --platform=codex
   

The uninstall command removes managed sisyphuslabs Codex cache/marketplace state, strips omo@sisyphuslabs plugin and hook-state blocks from ~/.codex/config.toml after writing a backup, and removes agent TOML links listed in the install manifest. If a specific project still has old project-local Codex plugin state, run the command from that project or pass --project <path>; it repairs known project-local .codex/config.toml conflicts and reports project-local .codex artifacts without deleting project-owned files.

Configuration

Opinionated defaults, adjustable if you insist.

See Configuration Documentation.

Quick Overview: - Config Locations: User ~/.omo/omo.jsonc plus walked project .omo/omo.jsonc configs up to $HOME; closest wins. Legacy oh-my-* files are migrated once into omo.jsonc. - JSONC Support: Comments and trailing commas supported - Agents: Override models, temperatures, prompts, and permissions for any agent - Built-in Skills: playwright (browser automation), git-master (atomic commits) - Sisyphus Agent: Main orchestrator with Prometheus (Planner) and Metis (Plan Consultant) - Background Tasks: Configure concurrency limits per provider/model - Categories: Domain-specific task delegation (visual-engineering, ultrabrain, deep, artistry, quick, unspecified-low, unspecified-high, writing, plus custom names) - Hooks: 54+ lifecycle hooks (61 with Team Mode), all configurable via disabled_hooks - MCPs: Built-in websearch (Exa), context7 (docs), grep_app (GitHub search), lsp — runtime-injected, not shown in opencode mcp list - LSP: Full LSP support with refactoring tools - Experimental: Aggressive truncation, preemptive compaction, and more

Note on package and command names

The published npm package and CLI binary are still named oh-my-opencode (dual-published as oh-my-openagent during the rename transition). Inside opencode.json, the compatibility layer prefers the plugin entry oh-my-openagent, while legacy oh-my-opencode entries still load with a warning. Runtime config is ~/.omo/omo.jsonc plus walked project .omo/omo.jsonc. Legacy oh-my-openagent.json[c] / oh-my-opencode.json[c] files are imported once by the migration engine and are not read afterward.

The recommended bunx/npx invocation is oh-my-openagent install (or the original oh-my-opencode install). Once installed, the short command is omo-agent-toolkit. The omo bin was removed from these packages in this major release; the name now belongs to the senpi-native edition, installed with npm i -g omo-ai@beta (beta channel only). Do not use bunx omo or npx omo: omo on npm is a different, unrelated package by a different author, and those commands resolve to it. The senpi edition's package name is omo-ai. lazycodex-ai is a single-purpose Node/npm installer package: npx lazycodex-ai install routes directly to the Codex Light installer. It is not the Codex marketplace name (the marketplace repository is code-yeongyu/lazycodex). Codex sees marketplace sisyphuslabs and plugin omo, enabled as omo@sisyphuslabs.