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.

Your task	Start here	First request
Review AI-written code	bunx skills use first-fluke/oh-my-agent@oma-qa	"Review this diff for bugs and missing checks. Cite the affected lines."
Design an admin screen	bunx skills use first-fluke/oh-my-agent@oma-design	"Review the hierarchy and table density of our admin page."
Fix a failing test	bunx skills use first-fluke/oh-my-agent@oma-debug	"Reproduce this test failure, fix its cause, and run the affected checks."
Review system boundaries	bunx skills use first-fluke/oh-my-agent@oma-architecture	"Review the boundary between our API and worker."
Run the whole team	Install oma	/orchestrate add login to this app

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.

	What it gives you	Try it
12 specialist roles	PM, architect, backend, frontend, mobile, database and infra engineers, QA reviewer, debugger, refactorer, docs curator, researcher (meet them)	/orchestrate build a TODO app with login
21 workflows	Slash commands from /brainstorm and /plan to /review, /debug and /scm. Most also start from a plain request (keyword banks in up to 11 languages)	"review this PR"
33 skills	Domain know-how that loads only when a task needs it: UI, APIs, schemas, Terraform, CI, security, git, observability	loads by itself, e.g. "add a Terraform S3 bucket"
Files you can open	Plans, design docs, API contracts, ADRs, bug notes, per-agent results, security evidence, HTML explainers, recaps	ls .agents/results
Research and content	Cited search, market research, papers, slide decks, MP4 videos, images, local voice, PDF/HWP to Markdown	/video, /convert
One folder, 14 runtimes	One portable .agents/ directory, written into each runtime's own config files	oma link cursor

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

Preset	Skills
All	All 33 skills (recommended)
Fullstack	architecture, backend, brainstorm, db, debug, design, dev-workflow, frontend, mobile, pm, qa, scm, tf-infra
Fullstack Web	Fullstack without mobile and tf-infra
Fullstack Mobile	Fullstack without frontend and tf-infra
Frontend	architecture, brainstorm, debug, design, frontend, pm, qa, scm
Backend	architecture, backend, brainstorm, db, debug, dev-workflow, pm, qa, scm
Mobile	architecture, brainstorm, debug, mobile, pm, qa, scm
DevOps	architecture, brainstorm, debug, dev-workflow, observability, pm, qa, scm, tf-infra
Research	academic-writing, hwp, market, pdf, scholar, scm, search, translation
Content	academic-writing, design, image, scm, translation, voice
Custom	Pick skills one by one

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

   The report shows CLI and skill-file status. Its skill counts reflect the files present, including retained skills; they can differ from the current preset's selection. If oma is not found, open a new terminal or run bun install --global oh-my-agent.

3. Open an existing Git repository and run one read-only task. oma-scm is included in every named preset; include it when using Custom selection.

   Use oma-scm to inspect this repository's current branch and working tree. Do not edit, stage, commit, or contact remotes. Report staged, unstaged, and untracked changes, with the Git commands and exit statuses actually observed.
   

4. Check the result. The reported branch and changes should match the Git output. Loading instructions or completing installation does not establish that this task ran.

For larger work, choose a workflow whose referenced skills are installed. Start with /plan when its planning skill is present, then continue with /work or /orchestrate when their dependencies are available.

Meet the team

Your own agent leads the team. In /work, /orchestrate and /ultrawork it hands each job to the right specialist, which runs as its own subagent. /plan, /architecture and /docs run in your current session with that role's skill, and /review and /debug call in their specialist for large scopes. When a role is on another vendor's CLI, oma agent spawn runs it there.

Your specialist	Carries	Call them with	Leaves behind
Product manager (pm-planner)	oma-pm	/plan, or "plan the payment feature"	A plan JSON and a tracker in docs/plans/work/ for Medium and Complex work (Simple requests get a direct recommendation)
Architect (architecture-reviewer)	oma-architecture	/architecture	An ADR or recommendation in .agents/results/architecture/
Backend, frontend, mobile, database and infra engineers	oma-backend, oma-frontend + oma-design, oma-mobile, oma-db, oma-tf-infra	/work, /orchestrate	Code, tests, and a result-<agent> file per task
QA reviewer (qa-reviewer)	oma-qa	/review, or "review this PR"	Findings ranked CRITICAL to LOW, each with file:line and fix code
Debugger (debug-investigator)	oma-debug	/debug, or "fix this bug"	A minimal fix, a regression test, and a bug note in .agents/results/bugs/ when one is warranted

The other three roles, and the skills without a role

Your specialist	Carries	Call them with	Leaves behind
Refactorer (refactor-engineer)	oma-refactor	/ultrawork's REFINE phase	Behavior-preserving refactor: commits and a result-refactor-<session>.md report
Docs curator (docs-curator)	oma-docs	/docs, or "verify docs"	docs/generated/doc-refs.json and the doc patches you approve
Researcher (research-explorer)	oma-search, oma-market, oma-scholar	a research request	Cited sources with trust labels; market briefs in .agents/results/market/

The infra engineer (tf-infra-engineer) is told to ask before any destructive or production apply or destroy. The remaining skills (brainstorm, security, scm, dev-workflow, observability, explanation, recap, translation, coordination, orchestration, skill-creation, content and media) have no dedicated role. Your agent loads them itself, and for most of them the skill injector suggests the right one from your prompt.

How the team works together

 THINK   /brainstorm ......................... docs/plans/designs/<NNN>-<feature>.md
 PLAN    /plan · /architecture ............... plan JSON, API contracts, ADR
 DESIGN  /design ............................. DESIGN.md + tokens
 BUILD   /work · /orchestrate · /ultrawork ... code + result-<agent> files, engineers in parallel
 CHECK   /review · /security · /debug ........ findings, security evidence, regression test
 SHIP    /scm · /docs ........................ Conventional Commits, doc fixes

Each step hands a file to the next. /brainstorm saves a design that /plan reads, and /plan writes a plan in which every task has an agent, dependencies, acceptance criteria and a check command. /orchestrate runs that plan (it loads the most recent plan-*.json, or writes one). /work and /ultrawork start by having the PM write their own plan. Skip any stage you don't need; every stage also works on its own.

Which workflow should run the team?

You want	Run	How it ends
Just a plan	/plan	A plan file for multi-area work, or a direct recommendation for small work
A PM-led build you follow step by step	/work	PM, then engineers tier by tier, then QA. CRITICAL and HIGH findings go into a fix loop (up to 5 cycles)
A hands-off parallel build	/orchestrate	Only tasks whose checks pass count as done; each task gets up to 3 attempts, then is marked partial or failed
Five-phase workflow	/ultrawork	Five gated phases (PLAN, IMPL, VERIFY, REFINE, SHIP); every review runs in a fresh reviewer session
"Don't stop until it's really done"	/ralph	Repeats /ultrawork with a separately spawned, fresh-context judge until every criterion passes; stops with a partial report when criteria are blocked or after 5 iterations
The team on a timer	oma schedule create qa-reviewer "review open PRs" --every 2h	One Markdown log per run in ~/.oma/schedule/runs/<id>/

You don't need slash commands. On runtimes with a prompt hook, plain requests (keyword banks in up to 11 languages) can start most workflows: "review this PR" starts /review. Describing a whole app ("Build a TODO app with user authentication") suggests /orchestrate, and your agent decides whether to run it. Keywords inside code blocks are ignored.

/orchestrate, /work, /ultrawork and /ralph are persistent when you invoke them by name, as a slash command or in plain text ("ultrawork: add rate limiting"). The agent is then sent back to work when it tries to stop early (up to 5 times or 2 hours) until you say "workflow done". A loosely matching request only suggests them.

Measured, with caveats. In the benchmark (one prompt, Claude Code with five different add-on setups including plain, claude-opus-4-6, one build each), oma scored 80.6 against 70.7 for plain Claude Code, at 1.7x the cost ($4.04 vs $2.37) and 1.8x the time.

All 21 workflows

Command	What it does
/architecture	Weighs design tradeoffs and produces a recommendation, review, or ADR
/brainstorm	Explores ideas and constraints and produces an approved design before planning
/convert	Converts PDF/HWP to Markdown, or transcodes images, video, and audio with ffmpeg
/debug	Reproduces a bug, fixes the root cause, writes a regression test, and scans for similar patterns
/deepinit	Maps an existing codebase into AGENTS.md, ARCHITECTURE.md, and a docs/ knowledge base
/design	Builds a design system, DESIGN.md, and tokens with accessibility checks
/docs	Finds broken doc references and proposes patches for docs a diff touched
/explain	Turns a diff, PR, branch, or topic into a self-contained interactive HTML explainer
/orchestrate	Runs agents in parallel, coordinates them through file state, and verifies the result (persistent)
/plan	Breaks a feature into prioritized tasks with API contracts
/ralph	Repeats /ultrawork with a separately spawned judge, up to 5 iterations (persistent)
/recap	Summarizes your AI conversation history for a day or period
/review	Reviews security (OWASP Top 10), performance, accessibility (WCAG 2.2 AA), and code quality
/schedule	Registers an agent job that runs on a recurring interval
/scm	Handles branches, merges, conflicts, worktrees, and Conventional Commits
/security	Scans source, agent skills, and MCP components, validates findings, and sets up CI gates
/stack-set	Detects your tech stack and generates stack-specific references for domain skills
/tools	Lists, enables, and disables MCP tools in plain language
/ultrawork	Five phases (PLAN, IMPL, VERIFY, REFINE, SHIP), each review in a fresh reviewer session (persistent)
/video	Turns a brief into a finished MP4 through a key-optional pipeline
/work	Coordinates several agents on a multi-domain project with PM planning and QA review (persistent)

oma verify triggers evaluates the detector against a labeled English and Korean corpus of 212 prompts. CI fails above 10% false fires or 20% missed fires. Last measured: 0% missed-fire, 5.3% false-fire. Full reference: Workflows.

Everything in the box

Plan and design: /brainstorm, /plan, /architecture, /design

Command	What it does	Writes
/brainstorm	Asks one clarifying question at a time and proposes 2-3 approaches that work differently, then hands off to /plan. Writes no code	docs/plans/designs/<NNN>-<feature>.md
/plan	Sizes the work as Simple, Medium or Complex; for Medium and Complex work, splits it into tasks, each with an agent, dependencies, acceptance criteria and a check command, and defines API contracts when the work crosses a boundary	.agents/results/plan-<sid>.json, docs/plans/work/<NNN>-<name>.md, contracts in .agents/results/api-contracts/ when needed
/architecture	Reads earlier decisions first, compares at least 2 options, and marks replaced ADRs as superseded	An ADR or recommendation in .agents/results/architecture/
/design	Proposes 2-3 directions, then writes DESIGN.md with tokens and audits responsive layout and accessibility	DESIGN.md, CSS/Tailwind/shadcn tokens

Build: 7 domain skills, plus /stack-set to fit them to your stack

Skill	Builds
oma-frontend	React/Next.js or Angular UI that follows your tokens, i18n and accessibility rules
oma-backend	APIs, auth and data access, layered router → service → repository
oma-mobile	Flutter, React Native or Swift apps
oma-db	Schemas, migrations, query tuning, vector/RAG retrieval plans
oma-tf-infra	Terraform for any cloud, with drift, destructive-change and cost risks called out
oma-dev-workflow	mise tasks, lint/format/typecheck, commitlint, git hooks, CI/CD and releases
oma-observability	OpenTelemetry, SLOs, alerting and incident forensics

/stack-set reads your manifests and writes stack-specific references for the backend, frontend and mobile skills. In a monorepo, frontend, backend and mobile engineers are pointed at their workspace (pnpm, npm/yarn/bun workspaces, lerna, nx, turbo, mise.toml).

Review, fix and ship: /review, /security, /debug, refactor, /scm

Command or skill	What it does	Writes
/review	A dependency audit, then OWASP Top 10, performance, WCAG 2.2 AA and code quality. Every finding gets file:line and fix code	The report in chat plus a memory record; no report file
/security	Scans your source, agent skills and MCP servers (Deepsec, Cisco Skill and MCP Scanner) and, given a scoped test deployment, runs ARTEX pen tests. The workflow requires an engine that failed to run to be reported as failed, not as clean	.agents/results/security/<run-id>/
/debug	Reproduces the failure, fixes the root cause with a minimal change, adds a regression test, and scans for the same pattern elsewhere	The fix and test; a bug note in .agents/results/bugs/ when one is warranted
oma-refactor	Changes structure without changing behavior: characterization tests first, then refactor-only commits	.agents/results/refactor/
/scm	Conventional Commits split by logical change; branches, merges, rebases and worktrees	Commits and branches

Docs and knowledge: /deepinit, /docs, /explain, /recap, translation

Command or skill	What it does	Writes
/deepinit	Turns an existing repo into an agent-ready knowledge base	AGENTS.md, ARCHITECTURE.md, docs/
/docs	Finds broken references, patches the docs a diff touched (only the patches you approve), and finds stale translations	docs/generated/doc-refs.json, patched docs
/explain	Turns a PR, branch or staged change into an HTML walkthrough with a 5-question quiz, or a topic into a one-page visual explainer	.agents/results/explain/<date>-<slug>.html
/recap	Summarizes your AI conversations across tools for a day or a period	.agents/results/recap/<date>.md
oma-translation	Translation that reads natively; placeholders, code and locale keys stay unchanged	Translated text

Research: search, market, papers, academic writing

Skill	What it does	Writes
oma-search	Docs, web and code search, with a trust label on each source	Cited results
oma-market	Pain points, trends and competitors from community signals, framed with SWOT, Porter's 5 Forces and PESTEL	.agents/results/market/<topic>-<date>.md
oma-scholar	Paper search that reads a compact claims file (Knows format, about 700 tokens) instead of the full PDF (about 10K tokens)	<paper>.knows.yaml
oma-academic-writing	Drafts and audits academic prose against a rubric	Your file

Content and media: /video, /convert, slides, images, voice

Command or skill	What it makes	Writes
/video	Shorts, explainers or demos as a finished MP4; keyed providers have key-free fallbacks	.agents/results/videos/<run>/ with a manifest
oma-slide	1920×1080 HTML decks, exported to PDF, PNG or PPTX	.agents/results/slides/<session>/
oma-image	Images through the vendor CLIs you're signed into, compared side by side	.agents/results/images/<run>/
oma-voice	Local text-to-speech and transcription through the Voicebox app	.agents/results/voice/<run>/
/convert	PDF or HWP to Markdown; image, video and audio conversion through ffmpeg	Next to the input file

These pipelines report a missing source or vendor key instead of silently returning a thinner result.

Hooks that run without being asked

Hook	What it does	Off switch / limit
Keyword start	Starts the matching workflow from a plain request	Questions, pasted text and code blocks are skipped
Skill injector	Points your agent at the right skills for the prompt	Paused while a persistent workflow is active
Stop gate	Sends a persistent workflow back to work; with oma goal set --gate test, the stop is allowed when that script exits 0 within 25 s	Say "workflow done"; it also releases after 5 blocks or 2 hours
Refactor guard	At stop, flags edited files over 500 lines for refactor-engineer	Opt-in: refactor_guard.enabled
Secret guard	Blocks git add of *.env, *.pem, id_rsa*, *.tfstate and similar files	Prefix that one command with OMA_SCM_ALLOW_SECRETS=1
Code-search guard	Blocks native recursive search in the project so the agent uses Serena or Gortex	providers.code_intelligence_guard: off
Test filter	Keeps only failures and summaries from test output, so fewer tokens are spent	OMA_TEST_FILTER=0
Session memory	When you switch or resume a session (or after compaction), re-injects the active session's recent events plus AgentMemory recall	Memory provider none or OMA_NO_AGENTMEMORY=1 turns off the recall; the local event snapshot stays

oma hook probe checks that oma's prompt hooks accept each runtime's hook input (it does not launch the runtime). Which hooks each runtime wires is in Host differences.

Parallel agents, sessions and dashboards

• oma agent spawn <role> "<task>" <sid> runs a role on Antigravity, Claude Code, Codex, Cursor, Grok, Kimi Code, Kiro, OpenCode, pi or Qwen Code, with --isolation worktree and --fallback-vendors. oma agent parallel runs several at once. These 10 dispatch targets are a subset of the 14 installer integrations.
• Add --read-only to require a vendor restriction before launch. Codex uses its read-only sandbox, Claude uses plan mode, and Pi excludes edit, write, bash, and powershell. Other CLIs require an explicit read_only_flag; missing, empty, or known conflicting flags stop dispatch. Custom flags declare support in your CLI or wrapper. Pi's tool exclusions do not restrict arbitrary extension or MCP tools; OMA does not add an operating-system sandbox.
• oma state list --all-projects and oma state get <sid>: sessions and every recorded event.
• oma dashboard terminal / oma dashboard web: live agent status (the web dashboard listens on 127.0.0.1 only). Dashboard guide.
• oma stats get (productivity metrics), oma retro (a git retrospective), oma recap --window 7d (what you did across AI tools).
• oma visualize --affected <paths>: which skills, workflows, agents and checks depend on the .agents/ files you changed.

Code intelligence, memory and MCP

Slot	Default	Alternatives
Docs	Context7	—
Web search	Runtime native search	Brave Search
Code intelligence	Serena, one shared server per project	Gortex (experimental)
Semantic memory	AgentMemory	Honcho (experimental), none
Browser MCP	Aside	Chrome DevTools, Firefox DevTools

Serena supplies LSP-based code navigation and diagnostics, including native-edit feedback where supported. Provider selection is independent of the agent runtime; capabilities vary by provider and host.

Agents coordinate through plain files in .agents/state/, with no outside service. /tools turns MCP tools on or off in plain language. Details: Capability Providers.

Getting better over time

• oma skill eval measures a skill's lift over a baseline on held-out tasks. oma skill optimize proposes edits that raise it, and --apply keeps them (skill-eval guide).
• oma harness evolution enable --max-dispatches <n> schedules a nightly cycle that turns failed runs into regression fixtures and applies skill improvements that pass evaluation as project overlays. Add --mode propose to only record them.
• oma emit exports the .agents/ source as an Agent Skills package, an Agent Plugins package, a Claude Code plugin marketplace, or AGENTS.md.

Config and safety rails

• One user-owned .agents/oma-config.yaml survives updates (only oma update --force resets it); private .local.yaml or .local.cue overlays can sit on top of it. language sets the response language.
• 13 project rules (backend, commit, database, debug, design, and more) load as native rules in Claude Code and Cursor, and are indexed in the managed AGENTS.md block written for Codex, Qwen Code and Pi.
• Updates keep config and migration backups in .agents/backup/; shipped skills and workflows are replaced in place, so keep local changes outside them. oma uninstall --dry-run shows what would be removed. first-fluke/oma-update-action@v1 runs oma update in CI and opens a PR.

All 33 skills

Skill	What it does
oma-academic-writing	Drafts, revises, and audits academic prose.
oma-architecture	Weighs architecture tradeoffs and draws module boundaries, with ADR/ATAM/CBAM analysis.
oma-backend	Builds APIs, authentication, and data access in Python, Node.js, or Rust.
oma-brainstorm	Explores ideas with you before you commit to building.
oma-coordination	Guides manual, step-by-step coordination of PM, frontend, backend, mobile, and QA agents.
oma-db	Designs schemas, migrations, indexes, and vector stores.
oma-debug	Finds the root cause, fixes the bug, and writes a regression test.
oma-design	Builds design systems with tokens, accessibility, and responsive layouts.
oma-dev-workflow	Automates CI/CD, releases, and monorepo tasks.
oma-docs	Checks docs for broken references, syncs them with code changes, and flags translation drift.
oma-explanation	Turns a diff, PR, branch, or topic into a self-contained HTML explainer, with a quiz for code changes.
oma-frontend	Builds UI in React/Next.js or Angular.
oma-hwp	Converts HWP, HWPX, and HWPML files to Markdown.
oma-image	Generates images and reference-guided variations, and can compare AI vendors side by side.
oma-market	Researches your market from community signals and frames it with SWOT, 5F, and PESTEL.
oma-mobile	Builds mobile apps with Flutter, React Native, or native Swift.
oma-observability	Routes observability work across metrics, logs, traces, SLOs, and incident forensics.
oma-orchestration	Runs multiple agents in parallel from the CLI.
oma-pdf	Converts PDF files to Markdown.
oma-pm	Plans tasks, breaks down requirements, and defines API contracts.
oma-qa	Reviews changes for correctness, OWASP security, performance, and accessibility.
oma-recap	Recaps your conversation history into themed work summaries.
oma-refactor	Refactors without changing behavior, using hotspot targeting, characterization tests, and refactor-only commits.
oma-scholar	Searches academic literature and builds Knows paper sidecars for claims, evidence, and peer review.
oma-scm	Manages branches, merges, worktrees, and Conventional Commits.
oma-search	Routes each query to the best source and scores how much you can trust the result.
oma-security	Scans source, agent skills, and MCP components; tests deployed web apps and validates findings.
oma-skill-creation	Writes and audits new OMA skills.
oma-slide	Generates HTML presentation decks and exports them to PDF/PNG/PPTX.
oma-tf-infra	Provisions multi-cloud infrastructure with Terraform.
oma-translation	Translates so the result reads like a native speaker wrote it.
oma-video	Generates short-form, explainer, and demo videos through a key-optional HyperFrames pipeline.
oma-voice	Generates voiceovers and transcribes audio on-device.

Works with

14 installer targets: Claude Code, Codex CLI, Cursor, Antigravity, Qwen Code, Grok, Kiro, Kimi, OpenCode, Pi, GitHub Copilot, Hermes, CommandCode, and ZCode. Wire a runtime you skipped with oma link <vendor>. Runtimes differ in which hooks they offer; the full matrix is in Supported Agents.

• Orca IDE: OMA for Orca adds a sidebar panel and command-palette actions (Orca 1.4.197+ with experimental plugins).
• DeepSeek Harness: OMA for DeepSeek Harness connects OMA checks through a Cordis plugin. It needs oma on your PATH.

Runtime logos (installer targets plus Amp and DeepSeek Harness)

native = oma writes the runtime's own config files; adapter = oma also adds hook or agent shims. Amp reads .agents/skills/ by itself and is not an installer target.

Claude Code native + adapter	Codex CLI native + adapter	Antigravity native SSOT	Cursor native + adapter	Qwen Code native dispatch	DeepSeek Harness Cordis plugin
Pi native-compatible	OpenCode native-compatible	Amp reads .agents/skills	GitHub Copilot symlinked skills	Grok Build native hooks	Kiro CLI native hooks + agents

_{& more}

Host differences: which runtimes get keyword detection and the Stop gate

Runtime	Keyword detection	Stop gate
Claude Code, Codex CLI, Qwen Code, Grok, Kimi	yes	yes
Cursor	yes	yes (re-enters as a follow-up message)
Antigravity	yes	yes (runs handlers through bun, not the oma wrapper)
OpenCode, Pi	yes	best-effort (Pi needs a build with agent_settled)
Kiro	yes	no: Kiro ignores Stop hook output
CommandCode	no prompt hook	yes
GitHub Copilot, Hermes, ZCode	no hooks	no hooks

Per-agent models

model_preset in .agents/oma-config.yaml chooses which model each agent role uses. The default, auto, follows the running runtime's own agent and model settings.

language: en
model_preset: auto   # auto | free | antigravity | claude | codex | cursor | kiro | mixed | qwen | <custom_presets key>

# Optional per-agent overrides; they win over the preset
agents:
  backend: { model: openai/gpt-6.1-terra, effort: high }

• mixed uses Claude for orchestrator, architecture, QA, PM, and docs, and Codex gpt-6.1-terra for implementation roles, so it needs both Claude Code and Codex CLI.
• free routes through a FreeLLMAPI gateway and needs FREELLM_API_KEY plus a running server.
• kiro is not in the installer menu; set it in the config file.
• oma doctor --profile prints the resolved model for each role.
• Full guide: Per-agent models

FAQ

Do I need every skill?

No. See Skill presets; All is the safe default.

How do I know it is working?

oma doctor shows installed skills and warns when hooks can't find oma. During a persistent workflow, oma state list shows the active session and oma state get <sid> shows its gate events.

Does it cost more tokens?

Usually, yes. Skills load only when a task needs them, but multi-agent workflows and fresh-context reviews spend more. In the one-prompt benchmark, oma cost 1.7x plain Claude Code.

The Stop hook keeps blocking. How do I get out?

Say "workflow done" (or "workflow complete" / "workflow finished", or the equivalent in the other supported languages), or delete .agents/state/<workflow>-state-<sid>.json. If you do neither, it releases on its own after 5 blocks or 2 hours.

How do I update or uninstall?

oma update refreshes skills, workflows, and hooks and keeps your config (--with-new-skills adds skills new in the release; oma update mcp re-chooses the browser MCP). oma uninstall --dry-run shows what would be removed; oma uninstall removes it and keeps oma-config.yaml, mcp.json, and skills you wrote. More fixes: Troubleshooting.

What does oh-my-agent leave to the model?

Planning and choosing the next step stay with your agent's model; oma has no fixed workflow graph. What oma enforces outside the model: tool guardrails (secret and search guards), budgets, retry and stop limits, an event log, and, when you set a gate, a stop that waits for your own checks to pass.

Learn more

• Docs site: guides, tutorials, and CLI reference. Start with Quick Start and Installation.
• Why oh-my-agent: when to choose it and the trade-offs
• Benchmark Report: how it compares with superpowers, ECC, and oh-my-claudecode on one prompt, with method, scores, screenshots, and caveats
• Supported Agents: support matrix across runtimes
• Detailed Documentation: technical spec and architecture
• Capability Providers: experimental Gortex and Honcho configuration, routing, and limits
• Skill Compatibility Matrix: native skill content, references, and response contracts in Claude and Codex

Star the project on GitHub:

gh api --method PUT /user/starred/first-fluke/oh-my-agent

Starter template: fullstack-starter

Star History

References

Research this builds on (7 papers)

• Li, X., Liu, Y., Chen, W., You, B., Di, Z., He, Y., Zheng, S., Choe, K. W., Sun, J., Wang, S., Tao, C., Li, B., Zhao, X., Geng, H., Wu, X., Zhou, J., Chen, X., Xing, H., Li, Y., … Song, D. (2026). SkillsBench: Benchmarking how well agent skills work across diverse tasks (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2602.12670
• Yu, G., & Wang, X. (2026). Knows: Agent-native structured research representations (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.17309
• Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). From skill text to skill structure: The scheduling-structural-logical representation for agent skills (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026
• Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). The scaling laws of skills in LLM agent systems (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508
• Tang, L., Rashtchian, C., Ferng, C.-S., Tomkins, A., Juan, D.-C., & Vu, T. (2026). WikiSkill: Compiling agent experience into persistent knowledge for skill evolution [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2608.27454
• Huang, Z., Xu, J., Yang, Y., Gong, Z., Yang, Q., Tian, M., Wang, X., Lv, C., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, X., Chen, D., Zheng, X., & Luo, C. (2026). From raw experience to skill consumption: A systematic study of model-generated agent skills [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23899
• Hong, D. B., Imani, A., & Ahmed, I. (2026). From anatomy to smells: An empirical study of SKILL.md in agent skills (Version 2) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2607.01456

License

MIT