Codeman Session Orchestrator
Lets an agent inside a Codeman session drive the Codeman HTTP API to spawn, prompt, wait on, and clean up parallel worker sessions.
AutomationAdvanced★ 755⑂ 107AI score 8/10Last updated: Sep 14, 2026
What it does
- Calls the Codeman server's HTTP API from inside a Codeman-spawned terminal session to manage other sessions.
- Ships a pre-written shell preamble with four verbs —
spawn_workers,sendwait,last_text,delete_session— so one Bash call can spawn N workers concurrently, task them, and collect their answers. - Handles readiness detection (waiting for the composer to paint), auto-answering Claude Code's workspace-trust dialog, self-healing a swallowed Enter, and a fail-closed guard that can never delete the calling session.
- Supports
claudeworkers and DeepSeek Harness workers (beta:deepseek) through the same four verbs. - Resolves credentials from an inherited
CODEMAN_PASSWORDor the data dir's.env.
Who it's for
- Codeman users who want to parallelize work across sessions.
- Builders of multi-agent pipelines where one agent supervises several sub-agents.
- Anyone who has hit real-world issues: half-spawned workers, duplicate prompts, orphaned sessions.
Note: outside a
CODEMAN_MUX=1environment (a Codeman-managed session) the skill refuses to act. It is not a general-purpose skill.
Examples
- "Spawn alpha and beta workers, have each survey a different repo and summarize" → run the §1 block once: concurrent spawn, prompts dispatched, answers read, only finished workers deleted.
- "Run beta on DeepSeek" → name the case
beta:deepseek; the rest of the flow is unchanged. - "Watch another session until it prints X" → use the
wait-outputendpoint to block until the match. - After deleting workers, list leftover scratch directories via
GET /api/v1/cases/agent-createdand clean up.
· · · 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 Claude 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 && mkdir -p ~/.claude/skills && cp -r Codeman/plugins/codeman/skills/codeman ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Clone the repo:
git clone https://github.com/Ark0N/Codeman.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r Codeman/plugins/codeman/skills/codeman ~/.claude/skills/ - Confirm
~/.claude/skills/codeman/containsSKILL.mdand thereference/directory. - Run a Codeman server (1.18.3+ recommended) and launch Claude Code inside a Codeman-spawned session.
- In that session run
echo $CODEMAN_MUX $CODEMAN_API_URLto verify the environment variables are set; if they are empty, the skill will not run. - Ask something like "spawn two workers and run these tasks in parallel" to trigger it. If you see a 401, check
CODEMAN_USERNAME/CODEMAN_PASSWORDin the data dir's.env.
View source on GitHub ↗License: MIT