Launch ralph.sh in background. Automatic execution until completion or critical blocker.
View on GitHubthebrownproject/space-agents
space-agents
skills/mission-go-ralph/SKILL.md
January 22, 2026
Select agents to install to:
npx add-skill https://github.com/thebrownproject/space-agents/blob/main/skills/mission-go-ralph/SKILL.md -a claude-code --skill mission-go-ralphInstallation paths:
.claude/skills/mission-go-ralph/# /mission-go-ralph - Automatic Background Execution
Launch the Ralph loop in background. Runs automatically until all tasks complete or a critical blocker halts execution.
## The Process
1. **Validate feature** - Check feature exists and has tasks
2. **Activate feature** - Run `bd update FEATURE_ID --status in_progress`
3. **Launch Ralph** - Run script in background
4. **Inform user** - Tell them how to monitor progress
5. **Exit** - HOUSTON's job is done, Ralph takes over
## Launch Command
```bash
bash skills/mission-go/scripts/ralph.sh FEATURE_ID &
```
Or with visible mode (mprocs TUI):
```bash
bash skills/mission-go/scripts/ralph.sh FEATURE_ID --visible
```
## What Ralph Does
Ralph spawns fresh Pods for each task in a loop:
1. Get next ready task via `bd ready`
2. Spawn Pod (Worker -> Inspector -> Analyst -> Airlock)
3. Handle result (complete, retry, or create blocking bug)
4. Continue until no tasks remain or critical halt
## User Communication
After launching:
```
HOUSTON: Ralph loop launched for feature FEATURE_ID.
Ralph runs automatically in background.
Check progress: /capcom
You'll be notified on:
- Feature completion
- Critical blocker (requires intervention)
Safe to close this session.
```
## Monitoring
- `/capcom` - Check feature status and task progress
- `bd list --parent FEATURE_ID` - See all tasks
- `bd ready` - See what's next in queue
- `bd dep tree FEATURE_ID` - See task hierarchy and status
## Exit Codes
| Code | Meaning |
|------|---------|
| 0 | Feature complete |
| 1 | Critical blocker - check `/capcom` |
| 2 | Configuration error |