Yeachan-Heo/oh-my-claudecode

⭐ 33,270  ·  TypeScript  ·  GitHub Repo

Teams-first Multi-agent orchestration for Claude Code

agentic-coding ai-agents automation claude claude-code multi-agent-systems oh-my-opencode opencode

1-Sentence Summary

Zero-config multi-agent orchestration for Claude Code, enabling parallel execution across Claude, Codex, and Gemini.

🔥 Key Capabilities & USP

• Team Mode Pipeline: Orchestrates a staged workflow (team-plan → team-prd → team-exec → team-verify → team-fix) with configurable worker counts per agent type. Solves the pain of sequential, single-model coding sessions by enabling parallel, specialized execution across multiple AI providers.
• Multi-Provider tmux Workers: Spawns real terminal panes for Codex CLI and Gemini CLI alongside Claude, enabling parallel code review, architecture analysis, and UI/UX design. Eliminates the bottleneck of waiting for one model to finish before starting another task.
• Deep Interview Skill: Socratic questioning workflow that clarifies requirements and exposes hidden assumptions before any code is written. Solves the pain of vague specifications leading to wasted development cycles.
• Autopilot & Specialized Skills: In-session commands like /autopilot, /ralph, /ultrawork, and /ccg for tri-model advisor synthesis. Provides expert-level code review, security analysis, and architectural guidance without context switching.
• Plugin-First Installation: Installs as a Claude Code marketplace plugin with zero learning curve—no config files, no environment setup. USP: Users leverage advanced team-based workflows without learning Claude Code's native interface.

Technical Architecture

Component	Description
Plugin + CLI Dual Architecture	Operates as both a Claude Code marketplace plugin (in-session skills via / commands) and an npm CLI tool (oh-my-claude-sisyphus)
tmux-based Worker Management	Spawns on-demand terminal panes for Codex and Gemini workers that automatically terminate when tasks complete
Staged Pipeline	Team mode runs as a sequential pipeline: plan → PRD → execution → verification → fix
Dependencies	Uses better-sqlite3 native addon (via prebuild-install), with a known non-blocking deprecation warning
Language	TypeScript

Quick Start Guide

# Marketplace/plugin install (recommended)
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

# npm CLI install
npm i -g oh-my-claude-sisyphus@latest

# Setup
/setup
/omc-setup
omc setup

# Build something
/autopilot "build a REST API for managing tasks"
autopilot: build a REST API for managing tasks

# Team mode
/team 3:executor "fix all TypeScript errors"
omc team 2:codex "review auth module for security issues"
omc team 2:gemini "redesign UI components for accessibility"
omc team 1:claude "implement the payment flow"
omc team status auth-review
omc team shutdown auth-review

# Deep interview
/deep-interview "I want to build a task management app"

# Tri-model advisor
/ccg Review this PR — architecture (Codex) and UI components (Gemini)

# Update
npm i -g oh-my-claude-sisyphus@latest
/plugin marketplace update omc
/setup
/omc-doctor

Pros, Cons & Use Cases

Pros

• Zero learning curve: Plugin-first installation means no config files or environment setup
• Multi-provider support: Parallel execution across Claude, Codex, and Gemini in a single session
• Active community: Discord support and growing ecosystem
• Plugin + CLI flexibility: Use as a Claude Code plugin or standalone npm CLI tool

Cons

• Known npm deprecation warning: Upstream dependency prebuild-install@7.1.3 produces non-blocking warnings
• Environment variable required: Team mode needs CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS enabled
• External dependencies: tmux workers require codex/gemini CLIs installed and an active tmux session

Who should NOT use this?

• Single-model purists: If you only use Claude Code and have no interest in Codex or Gemini integration
• Non-tmux users: If you cannot or will not use tmux for terminal management
• Minimalist developers: If you prefer a single-agent, linear workflow without orchestration complexity
• Enterprise compliance teams: If your organization restricts third-party plugin installations or multi-provider AI usage

Ideal Use Cases

• Code review & security analysis: Parallel review of PRs using Codex for security and Claude for logic
• Full-stack development: Simultaneous backend (Claude), frontend (Gemini), and architecture (Codex) work
• UI/UX design: Gemini for accessibility reviews while Claude handles implementation
• Complex refactoring: Team mode pipeline for planning, executing, and verifying large-scale changes
• Rapid prototyping: Autopilot mode for building REST APIs, microservices, or full applications

Community & Activity

With 33,270 stars and active development through May 2026, oh-my-claudecode has clearly struck a nerve in the AI coding community. The project demonstrates strong momentum with a dedicated Discord community and regular updates. The combination of zero-config installation and multi-provider orchestration has resonated deeply with developers who want to maximize their AI tooling without the overhead of managing multiple agents manually. The active maintenance cadence and responsive issue tracking signal a project that is not just popular, but actively evolving to meet user needs.