Skip to content

feat: add ralph fleet command to run multiple ralphs in parallel#32

Closed
malpou wants to merge 4 commits into
computerlovetech:mainfrom
malpou:pm/fleet-parallel-ralphs
Closed

feat: add ralph fleet command to run multiple ralphs in parallel#32
malpou wants to merge 4 commits into
computerlovetech:mainfrom
malpou:pm/fleet-parallel-ralphs

Conversation

@malpou
Copy link
Copy Markdown
Contributor

@malpou malpou commented Mar 22, 2026

Summary

  • Adds ralph fleet <dir> command that discovers all subdirectories containing RALPH.md files and runs them concurrently using RunManager
  • Prefixes console output with the ralph name when multiple runs are active so users can distinguish which ralph produced each line
  • Ctrl+C gracefully stops all running ralphs

Changes

  • src/ralphify/cli.py — new fleet command with _discover_ralphs() helper
  • src/ralphify/_console_emitter.py — ralph name prefix in multi-run mode
  • tests/test_cli.py — tests for fleet discovery, validation errors, and concurrent execution
  • docs/cli.md — CLI reference for the fleet command
  • docs/contributing/codebase-map.md — updated architecture diagram and module descriptions

Test plan

  • All 447 existing tests pass
  • New tests cover ralph discovery, empty directory errors, and concurrent execution
  • mkdocs build --strict passes with zero warnings

malpou and others added 4 commits March 22, 2026 17:46
Discovers all subdirectories containing RALPH.md files under the given
path and runs them concurrently using RunManager. Ctrl+C gracefully
stops all running ralphs.

Co-authored-by: Ralphify <noreply@ralphify.co>
When multiple runs are active (fleet mode), ConsoleEmitter now prefixes
each output line with [ralph_name] so users can distinguish which ralph
produced which output. The live spinner is disabled in multi-run mode to
avoid conflicts between concurrent Live displays.

Co-authored-by: Ralphify <noreply@ralphify.co>
Co-authored-by: Ralphify <noreply@ralphify.co>
Document the fleet command options, directory layout, and behavior.
Update the codebase map with fleet command architecture flow.

Co-authored-by: Ralphify <noreply@ralphify.co>
@malpou malpou closed this Mar 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant