@manojlds/ralphi

ralphi

A standalone Pi extension package for autonomous phased workflows and loop execution.

What this is

ralphi is intentionally separate from vaibhav so loop behavior can evolve without impacting the existing vaibhav extension.

Key behavior:

• Commands are namespaced under /ralphi-*
• Completion is driven by tool calls via ralphi_phase_done
• Loop completion is tool-only (complete: true), not marker-text based
• Loop iteration sessions are named from prd.json next pending story when available

Commands

• /ralphi-init
• /ralphi-prd <name> <description> (prompts in TUI if omitted)
• /ralphi-convert <prd-file>
• /ralphi-finalize <runId>
• /ralphi-loop-start [--max-iterations N]
• /ralphi-loop-next <loopId>
• /ralphi-loop-stop [loopId]
• /ralphi-loop-open [loopId] (interactive selector when omitted in TUI)
• /ralphi-loop-controller [loopId] (interactive selector when omitted in TUI)
• /ralphi-loop-status

Tool contract

ralphi_phase_done:

• runId (required)
• phase (required)
• summary (required)
• outputs (optional)
• complete (optional, defaults to false; set true to end loop)

CLI

ralphi ships a small CLI for project-local quality checks:

npx --no-install ralphi check

It reads .ralphi/config.yaml and runs configured commands in order.

Local development

npm install
npm run check
npm run ralphi:check
npm pack --dry-run