space-agents

Structure work into plans and Beads. Three modes: plan from brainstorm, plan from scratch, or create Beads from existing plan.

Execute a single task with Pathfinder/Builder/Inspector crew. Self-fetches work from Beads.

Select feature, select mode, delegate to execution skill.

Start a Space-Agents session. Displays welcome screen with project status.

HOUSTON spawns Pathfinder, Builder, Inspector per task. Best for medium features (4-10 tasks).

Launch ralph.sh in background. Lightweight mode (default) or full Pod crew (--pod). Best for large features (10+ tasks).

Explore ideas through conversation. HOUSTON asks questions, has opinions, and suggests background agents when investigation would help.

Select mode, delegate to analysis skill.

Use to install Space-Agents in a project. Creates .space-agents/ directory and initializes Beads for issue tracking. Run once per project.

End session. Reconciles exploration folders, appends context to CAPCOM, syncs Beads, displays session stats.

Produce structured spec.md from brainstorm conversations. Creates a consistent format that feeds cleanly into the planning phase.

HOUSTON executes feature tasks directly. No agents. Best for small features (1-3 tasks).

Interactive code review through conversation. HOUSTON guides review, spawns specialized agents, and helps create Beads for issues found.

Interactive debugging through conversation. HOUSTON guides through 4 phases, asks questions, and suggests agents for investigation.

Run test and lint validation gate. Use after implementation to verify code quality.

Check mission status and progress via fresh subagent. Queries Beads for features, tasks, bugs, and recent work activity. Keeps HOUSTON context lean.