space-agents
NewMulti-agent orchestration system for Claude Code. HOUSTON coordinates Voyages, Missions, and Objectives while fresh Pods execute work autonomously.
Overview
███████╗██████╗ █████╗ ██████╗███████╗
██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝
███████╗██████╔╝███████║██║ █████╗
╚════██║██╔═══╝ ██╔══██║██║ ██╔══╝
███████║██║ ██║ ██║╚██████╗███████╗
╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝
█████╗ ██████╗ ███████╗███╗ ██╗████████╗███████╗
██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝██╔════╝
███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ███████╗
██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ╚════██║
██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ███████║
╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚══════╝Agent orchestration plugin for Claude Code, powered by Beads and the Ralph loop.
Features
- •Multi-session persistence: Beads tracks issues, dependencies, and context across sessions
- •Structured exploration: Brainstorm ideas, create plans, review code, debug issues
- •Agent orchestration: Solo (direct), Orchestrated (agents per task), or Ralph loop (background automation)
- •Session logging: CAPCOM log preserves decisions and progress for future sessions
Prerequisites
- •Beads CLI (
npm install -g beads-cli) - •Optional: mprocs (
npm install -g mprocs) for watching Ralph loop live
Install
1. Add the plugin (in Claude Code):
/plugin marketplace add thebrownproject/space-agents
/plugin install space-agents@thebrownproject-space-agents2. Initialize in your project:
/installThis creates the .space-agents/ directory structure and initializes Beads for issue tracking. Run once per project.
Workflow
/launch → /exploration → /mission → /land| Command | Purpose |
|---|---|
/launch | Start session, see project status |
/exploration | Brainstorm, plan, review, or debug |
/mission | Execute work from Beads |
/land | End session, save context to CAPCOM |
Exploration Modes
| Mode | Output |
|---|---|
brainstorm | Ideas and analysis in exploration/ideas/ |
plan | Implementation plans in exploration/planned/ |
review | Code review findings as Beads |
debug | Investigation results as Beads |
Mission Modes
| Mode | Best for |
|---|---|
solo | Small work (1-3 tasks). HOUSTON executes directly |
orchestrated | Medium work (4-10 tasks). Agent per task |
ralph | Large work (10+ tasks). Background automation |
Multi-Agent Execution
In orchestrated and ralph modes, each task is executed by a 3-agent crew:
Pathfinder → Builder → Inspector| Agent | Role |
|---|---|
| Pathfinder | Explores codebase, gathers context, identifies patterns and risks |
| Builder | Implements the task using TDD approach |
| Inspector | Two-pass review: requirements verification, then quality/patterns/security |
The Ralph loop spawns these as Pods with fresh context each iteration, looping until all tasks complete or a blocker halts execution. When issues are found, bugs are inserted into Beads as blockers; Ralph resolves these before continuing to the next task.
Install & Usage
mkdir -p .claude/skillsmkdir -p .claude/skills && curl -o .claude/skills/space-agents.md https://raw.githubusercontent.com/thebrownproject/space-agents/main/SKILL.md/space-agentsFrequently Asked Questions
What is space-agents?
Multi-agent orchestration system for Claude Code. HOUSTON coordinates Voyages, Missions, and Objectives while fresh Pods execute work autonomously.
How to install space-agents?
To install space-agents, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /space-agents.
What is space-agents best for?
space-agents is a community categorized under General. It is designed for: agent. Created by Fraser Brown.