Yeachan-Heo/oh-my-claudecode

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Yeachan-Heo/oh-my-claudecode.svg?style=card)](https://bestofgithub.dev/repo/Yeachan-Heo/oh-my-claudecode)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Yeachan-Heo/oh-my-claudecode.svg)](https://bestofgithub.dev/repo/Yeachan-Heo/oh-my-claudecode)

Loading README…

Name	GitHub	Commits
JunghwanNA	@shaun0927	65
riftzen-bit	@riftzen-bit	52
Seunggwan Song	@Nathan-Song	20
BLUE	@blue-int	20
Junho Yeo	@junhoyeo	15

Feature	Terminal CLI	In-session skill	Notes
Setup	`omc setup`	`/omc-setup`	Both are real entrypoints.
Ask providers	`omc ask codex "review this patch"`	`/ask codex "review this patch"`	Both route through the same advisor flow. Providers: `claude`, `codex`, `gemini`, `antigravity`, `grok`, `cursor`, `muse`.
Team orchestration	`omc team 2:codex "review auth flow"`	`/team 3:executor "fix all TypeScript errors"`	Both exist, but they are different runtimes: `omc team` launches tmux CLI workers; `/team` runs the in-session native team workflow.
Pre-flight danger scan	`omc lookout scan --brief "..." [--json] [--strict]`	—	Advisory only: scans the task briefing and workspace before an unattended run and reports danger findings (findings/severity contract). Exit codes: 0 for successful non-strict scans (and strict scans without high-risk signals), 1 `--strict` with high-risk signals, 2 usage/scan error.
Autopilot / Ralph / Execute / Deep Interview	—	`/autopilot ...`, `/ralph ...`, `/execute ...`, `/deep-interview ...`	These are in-session skills. There is no `omc autopilot` / `omc ralph` / `omc execute` CLI subcommand in this repo.
Autoresearch	`omc autoresearch` (hard-deprecated shim)	`/deep-interview --autoresearch ...` + `/oh-my-claudecode:autoresearch`	Setup stays in deep-interview; execution now belongs to the stateful skill.

Surface	Workers	Best For
`omc team N:codex "..."`	N Codex CLI panes	Code review, security analysis, architecture
`omc team N:gemini "..."`	N Gemini CLI panes	UI/UX design, docs, large-context tasks (enterprise/API-key)
`omc team N:antigravity "..."`	N Antigravity (`agy`) panes	UI/UX design, docs, large-context tasks
`omc team N:grok "..."`	N Grok Build CLI panes	Code review, analysis cross-check
`omc team N:cursor "..."`	N Cursor agent panes	Implementation and reviewer-style tasks
`omc team N:claude "..."`	N Claude CLI panes	General tasks via Claude CLI in tmux
`/ask codex` + `/ask antigravity`	Tri-model advisor synthesis	Mixed Codex + Antigravity review in one pass

Mode	What it is	Use For
Team (recommended)	Canonical staged pipeline (`team-plan → team-prd → team-exec → team-verify → team-fix`)	Coordinated Claude agents on a shared task list
omc team (CLI)	tmux CLI workers — real `claude`/`codex`/`gemini`/`antigravity`/`grok`/`cursor-agent` processes in split-panes	Codex/Gemini/Antigravity/Grok/Cursor CLI tasks; on-demand spawn, die when done
Tri-model advisor (`/ask codex` + `/ask antigravity`)	Claude synthesizes both advisors' output	Mixed backend+UI work needing both Codex and Antigravity
Autopilot	Autonomous execution (single lead agent)	End-to-end feature work with minimal ceremony
Execute	Persistent execution with verify/fix loops, from plan to working code	Tasks that must complete fully (no silent partials)
Verify	Evidence-based completion checks until tests/build/lint/typecheck goals pass	Quality gates that need repeat diagnose/fix cycles
Claude Code `/goal`	Native Claude Code cross-turn goal loop	One measurable session completion condition; not an OMC evidence ledger
Artifact-only Ultragoal	Durable goal/checkpoint/evidence artifacts without starting a loop	Handoffs, audits, or unavailable/conflicting loop runtimes

	Project Scope	User Scope
Path	`.omc/skills/`	`~/.omc/skills/`
Shared with	Team (commit the skill file to keep it across worktrees)	All your projects
Priority	Higher (overrides user)	Lower (fallback)

In-session form	Kind	Effect	Example
`/team`	Slash skill	Canonical Team orchestration	`/team 3:executor "fix all TypeScript errors"`
`/autopilot` / `autopilot`	Skill / prompt trigger	Full autonomous execution	`/autopilot "build a todo app"`
`/execute`	Slash skill	Carry an approved task through to verified code	`/execute "refactor auth"`
`/ralph` / `ralph`	Skill / prompt trigger	Persistence mode	`/ralph "refactor auth"`
`/ralplan` / `ralplan`	Skill / prompt trigger	Iterative planning consensus	`/ralplan "plan this feature"`
`/deep-interview`	Slash skill	Socratic requirements clarification	`/deep-interview "vague idea"`
`deepsearch`	Prompt trigger	Codebase-focused search routing	`deepsearch for auth middleware`
`ultrathink`	Prompt trigger	Deep reasoning mode	`ultrathink about this architecture`
`cancelomc`, `stopomc`	Prompt trigger	Stop active OMC modes	`stopomc`

Variable	Description
`OMC_OPENCLAW=1`	Enable OpenClaw
`OMC_OPENCLAW_DEBUG=1`	Enable debug logging
`OMC_OPENCLAW_CONFIG=/path/to/config.json`	Override config file path

Event	Trigger	Key template variables
`session-start`	Session begins	`{{sessionId}}`, `{{projectName}}`, `{{projectPath}}`
`stop`	Claude response completes	`{{sessionId}}`, `{{projectName}}`
`keyword-detector`	Every prompt submission	`{{prompt}}`, `{{sessionId}}`
`ask-user-question`	Claude requests user input	`{{question}}`, `{{sessionId}}`
`pre-tool-use`	Before tool invocation (high frequency)	`{{toolName}}`, `{{sessionId}}`
`post-tool-use`	After tool invocation (high frequency)	`{{toolName}}`, `{{sessionId}}`

Variable	Description
`OPENCLAW_REPLY_CHANNEL`	Reply channel (e.g. `discord`)
`OPENCLAW_REPLY_TARGET`	Channel ID
`OPENCLAW_REPLY_THREAD`	Thread ID

Platform	tmux provider	Install
macOS	tmux	`brew install tmux`
Ubuntu/Debian	tmux	`sudo apt install tmux`
Fedora	tmux	`sudo dnf install tmux`
Arch	tmux	`sudo pacman -S tmux`
Windows	psmux (native)	`winget install psmux`
Windows (WSL2)	tmux (inside WSL)	`sudo apt install tmux`

Provider	Install	What it enables
Antigravity CLI (`agy`)	Install per the official instructions (provides the `agy` binary)	Design review, UI consistency — Google's successor to the Gemini CLI
Gemini CLI	`npm install -g @google/gemini-cli`	Design review, UI consistency (1M token context) — enterprise/API-key access unaffected
Codex CLI	`npm install -g @openai/codex`	Architecture validation, code review cross-check
Grok Build	Download from build.grok.com (`grok` at `~/.grok/bin/grok`)	Code review, analysis cross-check

oh-my-claudecode

Core Maintainers

Ambassadors

Document Specialists

Top Collaborators

Quick Start

Named autopilot stage profiles (v1)

CLI Commands vs In-Session Skills

VS Code, Agent SDK, and automation scope

Not Sure Where to Start?

Team Mode (Recommended)

tmux CLI Workers — Codex, Gemini & Antigravity (v4.4.0+)

Updating

Your Claude Just Have been Steroided.

Why oh-my-claudecode?

Features

Orchestration Modes

Goal Workflow Guidance

Intelligent Orchestration

Developer Experience

Contributing

Custom Skills

.omc/ state and git

Multi-repo workspaces

In-session shortcuts

Utilities

Provider Advisor (omc ask / /ask)

Autoresearch (stateful skill)

Rate Limit Wait

Monitoring & Observability

Jev Judgment Configuration

Notification Tags (Telegram/Discord/Slack)

OpenClaw Integration

Documentation

Requirements

Platform & tmux

Optional: Multi-AI Orchestration

License

Featured by OmC Contributors

Star History

💖 Support This Project

Why sponsor?

Other ways to help

GEO visibility benchmark

`.omc/` state and git

Provider Advisor (`omc ask` / `/ask`)