mrkeyoor.com_
Thu 17 Sept 20:45 UTC
AI Toolsevaluationupdated 25 Aug 2026

oh-my-claudecode review

oh-my-claudecode is a Claude Code plugin and Node.js runtime that coordinates agents, repeat-until-verified workflows, and optional external coding CLIs. It gives developers a packaged control layer for work that would otherwise require many Claude Code commands, prompts, and local state files.

+136stars / 7d
Verdict

Our run installed 326 packages and built successfully, but 38 of 12,127 tests failed and npm audit found 14 vulnerabilities, so oh-my-claudecode is best treated as a powerful local operator that needs review before adoption. It suits committed Claude Code users who want persistent, multi-agent workflows and accept a fast-changing command surface. Pin v5.0.0 or another tested release, audit the hooks and dependency report, then trial it on a disposable branch before giving it a valuable repository.

We ran it

Lab card: what happened when we ran oh-my-claudecodeScreenshot of oh-my-claudecode (oh-my-claudecode.dev)
Install✓ · 10s326 packages · 326 MB
Build✓ · 40s
Tests✗ · 769s12069 passed · 38 failed · 20 skipped of 12127 (vitest)
Known vulns144 critical · 8 high · 1 moderate · 1 low (npm audit)
Repo1691 files~507,445 lines of source · 28.6 MB · 8 CI workflows · tests dir

Answers from our run

Does oh-my-claudecode build from source?

Dependencies installed in 10 seconds (326 packages), and the build succeeded in 40 seconds. We cloned commit 94e71c3 into a clean Debian container with 3 CPUs and no project-specific setup.

Do oh-my-claudecode's tests pass?

Not all of them: 12069 of 12127 passed and 38 failed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Does oh-my-claudecode have known vulnerabilities in its dependencies?

npm audit flagged 14 known advisories in the dependency tree, including 4 critical at the time of our run.

Who should not use oh-my-claudecode?

Developers who do not use Claude Code: the README lists Claude Code as a requirement, and the in-session workflows depend on it.

What are the alternatives to oh-my-claudecode?

Superpowers, Everything Claude Code, gajae-code. Our run installed 326 packages and built successfully, but 38 of 12,127 tests failed and npm audit found 14 vulnerabilities, so oh-my-claudecode is best treated as a powerful local operator that needs review before adoption.

Setup3/5Fast install, but Claude Code and tmux modes add setup choices
Docs4/5Detailed command matrix, migration guide, and platform notes
Community5/538,796 stars, current pushes, and only 5 open issues and PRs
Maturity2/5Large suite, yet 38 tests failed and 14 advisories remain

Who it’s for

Claude Code users who want team execution, planning, review, and verification as installed workflows.
Developers already paying for Claude Pro, Max, or API access who want longer tasks to keep state.
Terminal users willing to install tmux and provider CLIs for multi-process worker panes.
Teams prepared to pin releases and test their local hooks after upgrades.

Who it’s NOT for

Developers who do not use Claude Code: the README lists Claude Code as a requirement, and the in-session workflows depend on it.
Anyone expecting one consistent command surface: terminal commands and in-session skills are separate, with different team runtimes and capabilities.
Windows users who need every worker feature without extra terminal software: tmux features require psmux, WSL2, or another documented tmux path.
Teams that cannot absorb breaking workflow changes: v5.0.0 removed 17 legacy names instead of retaining aliases.
Security-sensitive users unwilling to audit hooks and local state: the tool can launch provider CLIs and stores prompts, transcripts, plans, and session artifacts under .omc/.

Setup reality

In our sandbox, npm installed 326 packages in 10 seconds and used 326 MB. The build finished in 40 seconds. Tests ran for 769 seconds, with 12,069 passing, 38 failing, and 20 skipped out of 12,127; npm audit reported 14 known vulnerabilities, including 4 critical and 8 high.

Normal use needs Claude Code plus a Claude subscription or Anthropic API key. External worker modes also need the selected provider CLIs installed and authenticated, while notifications require their own tokens or webhook URLs.

The plugin and npm CLI expose different commands. tmux-backed workers need tmux on macOS or Linux, psmux on native Windows, or tmux inside WSL2. Named autopilot stage profiles v1 are limited to Linux systems with flock.

326 packages buy a large Claude Code control layer

Our clean npm install pulled 326 packages and occupied 326 MB, which tells you more about oh-my-claudecode than the slogan does. This is a substantial TypeScript runtime wrapped around Claude Code. It installs skills, agents, hooks, commands, session tracking, and a terminal CLI. The appeal is concentration: one project supplies planning, execution, review, team coordination, and recovery conventions that a heavy Claude Code user might otherwise assemble by hand. The cost is that OMC becomes part of how your coding session starts, delegates work, records state, and decides that a task is done.

The command matrix in the README is essential reading because the product has two surfaces. omc setup, omc ask, and omc team are terminal commands from the npm package. /autopilot, /execute, /team, and /deep-interview run inside Claude Code. The two team commands even use different runtimes: one launches tmux processes, while the other uses Claude Code's native team workflow. Developers who assume every example works in either place will hit avoidable confusion.

What happened when we ran it

In our 3 CPU, 8 GB sandbox, installation succeeded in 10 seconds, placed 326 packages on disk, and consumed 326 MB. The build also succeeded in 40 seconds. Those results make a source checkout practical to inspect and compile, even though the repository is large: the measured clone contained 1,691 files and about 507,445 lines of source. There was no Dockerfile to define an alternate environment, but the repository did include 8 CI workflow files and a tests directory.

The test result is the reason for caution. Vitest ran for 769 seconds and reported 12,069 passing tests, 38 failures, and 20 skips out of 12,127. The tail names a session-end worker test involving fake timers, then summarizes 22 failed test files out of 655; it does not establish why those failures occurred. npm audit separately found 14 known vulnerabilities: 4 critical, 8 high, 1 moderate, and 1 low. A passing build does not cancel either finding.

Claude Code and tmux define who can use it

The project requires Claude Code plus a Claude subscription or Anthropic API key. Its most distinctive terminal feature, omc team, also expects tmux and authenticated provider CLIs for whichever workers you select. The README documents 6 provider choices for that command, including Claude, Codex, Gemini, Antigravity, Grok, and Cursor. OMC can work without those optional providers, but its cross-tool orchestration pitch gets narrower when only Claude Code is installed.

Platform details matter because some modes depend on terminal process control. The README directs macOS and Linux users to tmux, Windows users to psmux, and WSL2 users to tmux inside Linux. Named autopilot stage profiles add another hard boundary: v1 requires Linux and the flock utility. These limits are documented, which is better than discovering them after setup, but mixed operating-system teams should choose a small shared feature set before putting OMC commands into project instructions.

Version 5.0.0 makes upgrades a migration task

The August 24, 2026 v5.0.0 release removed 17 legacy workflow and command names, including ultrawork, swarm, pipeline, and mcp-setup. The release provides replacements and a migration table, so the break is deliberate and documented. Even so, prompt files, team habits, and internal guides that name old commands need edits. For an individual experiment that is manageable. A team-wide install should pin a version and assign ownership for migrations.

Health signals are unusually strong for a project moving this quickly. GitHub showed 38,796 stars, a last push on August 25, 2026, and 5 open issues and pull requests combined. The latest release landed one day earlier. That activity argues against abandonment, while the major release's large change list shows why maturity cannot be inferred from popularity. Rapid maintenance can close bugs quickly and still create upgrade work for users whose workflows depend on exact command names.

Local state and hooks deserve a security review

OMC writes plans, session data, logs, handoffs, research notes, and replay artifacts under .omc/. The README warns that these local files may contain prompts, transcripts, and machine-specific paths, while allowing selected project skills to be committed. That boundary is useful only if a team's ignore rules and review habits preserve it. A stray artifact from a 507,445-line checkout is easy to overlook, especially when several worktrees share a parent state root.

The tool also sits close to command execution. Team modes launch real provider processes, notifications can call remote webhooks, and hooks react to session events. None of that is automatically disqualifying, and the 8 CI workflow files show serious engineering attention. The 14 audit findings and 38 failed tests still justify a direct inspection of configured hooks, notification targets, provider permissions, and generated state before OMC touches a sensitive repository. Start on a disposable branch with no production credentials.

The best fit is a committed Claude Code power user

OMC earns its place when a developer already uses Claude Code daily and wants repeatable orchestration instead of maintaining a private folder of prompts. The 12,069 passing tests suggest broad behavior is exercised, and the documentation explains many boundaries that similar projects hide. Superpowers is easier to reason about when structured skills are enough. Everything Claude Code is better for borrowing individual pieces, while gajae-code is the author's own answer for users who find OMC too large.

Adoption should be a controlled trial, not a global install copied from a screenshot. Install the pinned package, run the 12,127-test suite on your platform, review every failure and audit item, then inspect what setup changes in Claude Code and .omc/. If the team runtime saves more coordination than those checks cost, OMC is unusually capable. If you only want a few planning commands, 326 packages and a breaking v5 migration surface are too much machinery.

Alternatives

ProjectWhat it isPick it when
Superpowers gh↗A smaller collection of disciplined coding workflows and skills for coding agents.pick this instead when you want structured planning and execution without OMC's large orchestration runtime.
Everything Claude Code gh↗A broad collection of Claude Code agents, commands, hooks, and configuration examples.pick this instead when you want parts to study and assemble yourself instead of one opinionated coordinator.
gajae-codeA lighter tool from the same author for users who find OMC excessive.pick this instead when you want the author's simpler SDK-based path and less orchestration machinery.

Sources

  1. oh-my-claudecode README
  2. oh-my-claudecode v5.0.0 release
  3. oh-my-claudecode issue and pull request queue

More ai tools reviews

rowboat · skills · superpowers-zh · yolov5 · eve · MemOS · the whole board →