context7

oh-my-agent

Ship 400+ commits a day.

한국어 | 中文 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch | Tiếng Việt | ภาษาไทย

oh-my-agent (oma) turns Claude Code, Codex CLI, Cursor and 11 other coding agents into a team. A planner splits the work, engineers build in parallel, a reviewer checks the result, and a debugger fixes the root cause.

Run this from your project root.

curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

Then open your agent and type /orchestrate build a TODO app with login.

Start with your task

Pick a task. Load one skill into the agent you already use, or install the whole team.

Run the skills use command in your agent's terminal. It loads that one skill. For the full team with workflows, install oma. Other options are in Choose a setup.

After installing, run oma doctor. Your first 5 minutes starts with a read-only task before team workflows.

What you get

Workflows are what you type (or just say). They call in roles, the specialists. Skills are the know-how: each role carries its own, and your agent loads the rest whenever a task needs them.

Install · First 5 minutes · The team · Which workflow? · Everything in the box · Works with · FAQ · Docs

Install

The script installs bun if it is missing, installs the oma command globally (bun install --global oh-my-agent, skipped when oma is already on your PATH), then starts the interactive setup. The hooks (keyword detection and the Stop gate) and several workflows call the globally installed oma command. The hooks silently do nothing if they cannot find it. If you skip the script, install it yourself with bun install --global oh-my-agent (npm install --global oh-my-agent or brew install oh-my-agent also work).

Windows, or without the install script

# Windows (PowerShell)
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex

# Any OS with bun installed: the same setup, plus the global `oma` command
bun install --global oh-my-agent
oma

On Windows the installer hides Antigravity, Hermes, and Kimi, and the hook wrapper is a bash script. The default Aside browser MCP installs through bash, so deselect it if you have no bash.

The setup asks for your response language, which agent runtimes to wire up, capability providers, a browser MCP, a model preset, and a skill preset. Choose All for the skill references used across every workflow: domain presets omit some of those skills. Provider availability and task verification remain separate checks.

Choose a preset explicitly when you want a domain's skills:

oma install --preset frontend --yes

This selects the eight frontend-preset skills. The installer still configures the runtime, providers, and shared workflow files, and retains previously installed skills. Custom selection is available in the interactive installer. See preset values and workflow dependencies.

What the installer also does by default

• Installs bun (required). Tries uv, Serena (uv tool install), and CUE (brew install cue or winget), and continues with a warning if any of them fails.
• Pre-selects the Aside browser MCP in the interactive setup, and installs it with curl -fsSL https://releases.aside.com/install.sh | bash only if you keep it selected. Deselect it in the browser MCP step, or change it later with oma update mcp.
• Uses AgentMemory for semantic memory, which runs bun install -g @agentmemory/agentmemory and registers it as a login service (launchd, systemd user unit, or Windows scheduled task). Choose provider none or set OMA_NO_AGENTMEMORY=1 to skip it.
• Asks before linking skills into home-directory vendor folders (Antigravity, Hermes, Kimi). In $HOME without --global it asks for confirmation.
• Writes some files outside the project without asking: ~/.claude.json (marks the project as a trusted Claude Code workspace), ~/.serena/ (OMA context, answer-size floor, project registration), ~/.cursor/cli-config.json (turns off Cursor's commit attribution), ~/.grok/config.toml (telemetry), and ~/.gemini/antigravity-cli/ (HUD), each only for a vendor you selected.
• Writes telemetry opt-outs into vendor settings (Claude DISABLE_TELEMETRY=1, which also turns off Claude Code Remote Control; Gemini, Qwen, Codex, and Grok usage stats). Set telemetry: true to keep vendor defaults.
• Disables Qwen Code automatic memory saving by adding memory.enableManagedAutoMemory: false when the setting is absent. Explicit true or false preferences and other memory settings are preserved.
• Adds unset Claude Code settings to .claude/settings.json, including skipDangerousModePermissionPrompt: true, effortLevel: high, cleanupPeriodDays: 180, and env flags that turn off auto memory, adaptive thinking, error reporting, and built-in git instructions. Values you already set are kept.
• Adds a co-author trailer: Claude Code's commit attribution becomes Co-Authored-By: First Fluke <our.first.fluke@gmail.com> and PRs get a "Generated with oh-my-agent" line. Set scm.co_author.enabled: false to turn this off.
• Installs a commit-msg guard in .githooks/ that rejects unlisted Co-authored-by addresses, and sets git config --local core.hooksPath .githooks when no other hooks are active. Set scm.co_author.enforce_hook: false to opt out.
• oma update updates the oma CLI in the background (auto_update_cli: false or OMA_SKIP_VERSION_CHECK=1 to stop it) and runs uv tool upgrade serena-agent --prerelease=allow (serena.auto_update: false).
• With Serena in the default bridge mode, the first agent session that starts a shared Serena server registers a cleanup timer that stops idle shared Serena servers every 5 minutes (launchd dev.oma.serena-daemon-gc, systemd user timer oma-serena-daemon-gc.timer, or Windows scheduled task OMA Serena Daemon GC). Set serena.mode: stdio to skip the shared server and its timer. oma uninstall does not remove the timer.
• Non-interactive runs (-y, OMA_YES=1, CI=true) use the All skill preset unless --preset selects another, plus model_preset: auto and Python as the backend language. They select no browser MCP (and skip the Aside install script) unless mcp.devtools_browsers already lists one.

Skill presets

Of the named presets, only All includes coordination, orchestration, docs, security, refactor, explanation, recap, video, slide, and skill-creation (or pick them under Custom). Research and Content lack the skills behind /plan, /review, /debug, /architecture, and /brainstorm. See Workflows that need skills outside a preset.

Your first 5 minutes

1. Choose your setup. For the task below, load oma-scm with bunx skills use first-fluke/oh-my-agent@oma-scm, or use the runtime install command above. Choose a setup explains both paths.

2. For a runtime installation, check the install:

   oma doctor