Teammode
Orchestrate a named team of cooperating Codex workers under one leader session, with durable on-disk team state.
AutomationAdvanced★ 67,531⑂ 5,507AI score 7/10Last updated: Aug 9, 2026
What it does
Teammode turns several Codex workers into a coordinated team run by your main session as leader.
- Transport selection first: inspects the active tool surface (including
tool_searchfor deferred tools) and announces whether it will run on native MultiAgentV2 agents, Codex App threads, or fall back to a plain-subagent split. - Durable state via script: a bundled dependency-free Node script (
team.mjs) writes.omo/teams/{session_id}/withteam.json, an auto-generated member manualguide.md, and a sharedartifacts/folder, all behind a per-team lock. - Composition by ownership, not job title: each member owns one concrete slice — a code area, an ownership boundary, or a perspective — so responsibilities never overlap.
- Worktree isolation and integration: colliding members get their own git worktree;
integratemerges member branches back with a merge commit. - Enforced teardown: archive every member, then delete team state so no zombie teams leak.
Who it's for
- Codex users running large refactors or investigations across multiple parallel threads/agents.
- Anyone with a decision-complete plan in
.omo/plans/who wants to execute its waves in parallel. - Teams that need file-level isolation between concurrent agents.
- Not for you if the work is perfectly isolated or the goal is still ambiguous — the skill itself tells you to use plain subagents then.
Example uses
- Deep bug hunt: "Investigate this slow shutdown as a team" — the leader spawns
app-server-lifecycleandmailbox-deliverymembers, relays findings between them, and synthesizes the diagnosis. - Parallel plan execution: map the three independent todos of wave 1 in
.omo/plans/auth-refactor.mdto three members, give worktrees to the ones touching shared files, thenintegrateafter all report. - Clean shutdown: notify members, copy evidence into
artifacts/,archive,worktree-remove, anddeletethe team state.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the packages/omo-codex/plugin/components/teammode/skills/teammode folder from the GitHub repo code-yeongyu/oh-my-openagent into my ~/.claude/skills/teammode/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/packages/omo-codex/plugin/components/teammode/skills/teammode ~/.claude/skills/teammode⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and go to your working directory.
- Clone the repository:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r oh-my-openagent/packages/omo-codex/plugin/components/teammode/skills/teammode ~/.claude/skills/teammode - Confirm that
scripts/team.mjscame along — without it no team state can be created. - Make sure Node.js (or Bun) is installed:
node -v - Restart your Claude Code / Codex session and ask something like "run this as a team" to trigger the skill.
- Note: real teams require Codex's MultiAgentV2 or
codex_app.*tools; otherwise the skill will report the limitation and continue serially.
View source on GitHub ↗License: NOASSERTION