E2B Swarm
Spawn E2B sandbox instances in parallel to execute Claude Code tasks across isolated environments.
Installation
cd ~/.claude/skills/skill-e2bswarm && bun install
Or link from the repo:
ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/skill-e2bswarm ~/.claude/skills/skill-e2bswarm
Commands
Spawn instances with tasks
From a task list ID (loads from ~/.claude/tasks//):
skill-e2bswarm spawn \
--repo <github-url> \
--tasks <task-list-id> \
--instances <count>
From a local folder containing task JSON files:
skill-e2bswarm spawn \
--repo <github-url> \
--tasks-dir ./my-tasks/ \
--instances <count>
From inline JSON:
skill-e2bswarm spawn \
--repo <github-url> \
--tasks-json '[{"id":"1","subject":"Task 1","description":"Do something"}]' \
--instances <count>
From a JSON file:
skill-e2bswarm spawn \
--repo <github-url> \
--tasks-file ./tasks.json \
--instances <count>
Check status
skill-e2bswarm status
skill-e2bswarm status --instance <id>
Collect results
skill-e2bswarm collect --output ./results
Kill instances
skill-e2bswarm kill # Kill all
skill-e2bswarm kill --instance <id> # Kill specific
Options
| Option | Description |
|---|---|
--repo, -r |
Git repository URL (required) |
--tasks, -t |
Task list ID from ~/.claude/tasks/ |
--tasks-dir |
Local folder containing task JSON files |
--tasks-file |
Path to a JSON file with tasks array |
--tasks-json |
Inline JSON array of tasks |
--instances, -n |
Number of parallel instances (default: 1) |
--prompt, -p |
Additional context/instructions for Claude |
--branch, -b |
Git branch to clone |
--distribute, -d |
Task distribution mode: all, round-robin, by-dependency |
Task Distribution Modes
- all: Each instance receives all tasks (default)
- round-robin: Tasks distributed evenly across instances
- by-dependency: Tasks grouped by dependency chains
Environment Variables
E2B_API_KEY: Your E2B API key (required, add to ~/.secrets)
Examples
Spawn 4 instances to work on videoben tasks in parallel:
skill-e2bswarm spawn \
--repo git@github.com:hasnastudio/iapp-videoben.git \
--tasks iapp-videoben-dev \
--instances 4 \
--distribute round-robin \
--prompt "Complete all assigned tasks, run tests before marking complete"
Run tasks from a local JSON file:
skill-e2bswarm spawn \
--repo git@github.com:org/repo.git \
--tasks-file ./sprint-tasks.json \
--instances 2
Converted and distributed by TomeVault — claim your Tome and manage your conversions.