Codeman Session Orchestrator
Drive the Codeman session manager over its HTTP API to spawn, prompt, wait on, and clean up worker sessions across any installed agent CLI.
AutomationAdvanced★ 832⑂ 129AI score 8/10Last updated: Nov 8, 2026
What it does
- From inside a Codeman-managed terminal session, calls the Codeman HTTP API to list, spawn, prompt, watch and delete other sessions.
- Starts worker sessions in any installed CLI (Claude Code, Codex, Gemini CLI, OpenCode, Antigravity, Grok, DeepSeek Harness, OMP), sends them prompts, and blocks until they finish via
wait/wait-output/send-and-wait. - Runs the local model Codeman installed on your Mac as a worker, and supports direct cross-session messaging between Claude workers.
- Reads saved Codex conversation history offline — no server or managed session required.
- Ships hard-won guards in code: fail-closed self-delete protection, reading the workspace-trust dialog instead of blindly pressing Enter, and re-pressing Enter until a Claude composer actually accepts the prompt.
Who it's for
- Existing Codeman users who want to parallelize work across multiple worker sessions.
- Anyone who wants a second opinion from a different CLI or model on the same task.
- Power users running several worktrees or long jobs concurrently.
Examples
- "Split this refactor across three workers" → spawn three workers, task each, wait for all, collect answers.
- "Get Codex to review this design too" →
codeman agent spawn --working-dir /path/to/project --mode codex. - "Use the local model on this Mac" → spawn a
localworker; the skill starts the runtime, waits for the composer, then sends the prompt.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Ark0N/Codeman/HEAD/plugins/codeman/skills/codeman/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
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 AI Skill Mart. Copy the plugins/codeman/skills/codeman folder from the GitHub repo Ark0N/Codeman into my ~/.claude/skills/codeman/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Ark0N/Codeman.git /tmp/codeman && mkdir -p ~/.claude/skills && cp -r /tmp/codeman/plugins/codeman/skills/codeman ~/.claude/skills/codeman⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/Ark0N/Codeman.git /tmp/codeman - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/codeman/plugins/codeman/skills/codeman ~/.claude/skills/codeman - Note: Codeman normally installs this skill automatically where each CLI looks for it (
.claude/skills/,.agents/skills/) when it spawns a session — manual install is only a fallback. - Live API operations require a Codeman-managed session: check that
echo $CODEMAN_MUXprints1. - Make sure
curlandjqare available (jq --version; install withbrew install jqif missing). - Restart Claude Code and try: "spawn two Codeman workers and run these tasks in parallel."
View source on GitHub ↗License: MIT