ralphctl 0.19.0 → 0.21.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -65,7 +65,14 @@ npm install -g ralphctl
|
|
|
65
65
|
|
|
66
66
|
> Needs [Node.js](https://nodejs.org/) ≥ 24 — `mise use node@24` or `nvm install 24`.
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
Want to poke around before setting up a provider CLI? `ralphctl demo` seeds a throwaway sandbox
|
|
69
|
+
project (three sprints, one per pre-flow state) and launches straight into it — zero setup:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
ralphctl demo
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Otherwise, install one of the supported CLIs and authenticate it:
|
|
69
76
|
|
|
70
77
|
| CLI | Install | Auth |
|
|
71
78
|
| ---------------------------------------------------------------------------------- | ------------------------------------ | --------------------- |
|
|
@@ -77,9 +84,13 @@ Install one of the supported CLIs and authenticate it:
|
|
|
77
84
|
Then confirm ralphctl can see it:
|
|
78
85
|
|
|
79
86
|
```bash
|
|
80
|
-
ralphctl doctor #
|
|
87
|
+
ralphctl doctor # checks your provider CLI is on PATH — and reports auth for the CLIs that can answer — the #1 first-run failure
|
|
81
88
|
```
|
|
82
89
|
|
|
90
|
+
`doctor`'s auth check is only as honest as each CLI lets it be: Claude Code and OpenAI Codex answer locally via their own
|
|
91
|
+
`auth status` / `login status` verbs, OpenCode reports whether it has a saved credential (its free tier works with zero),
|
|
92
|
+
and GitHub Copilot has no non-interactive auth-status command at all — that row always reports `unknown`, not a guess.
|
|
93
|
+
|
|
83
94
|
When `doctor` is green, launch:
|
|
84
95
|
|
|
85
96
|
```bash
|
|
@@ -377,6 +388,7 @@ export RALPHCTL_HOME="/path/to/custom/dir"
|
|
|
377
388
|
| ---------------------------- | -------------- | ---------------------------------------------------- |
|
|
378
389
|
| `RALPHCTL_HOME` | `~/.ralphctl/` | Override application root (data + config + state) |
|
|
379
390
|
| `RALPHCTL_SKIP_LEGACY_CHECK` | unset | Bypass the v0.6.x legacy-layout detector at boot |
|
|
391
|
+
| `RALPHCTL_DEBUG_TRACE` | unset | Write a `<sprintDir>/events.ndjson` debug trace |
|
|
380
392
|
| `RALPHCTL_NO_TUI` | unset | Suppress implicit interactive prompts in `implement` |
|
|
381
393
|
| `NO_COLOR` | unset | Suppress ANSI colors |
|
|
382
394
|
| `CI` | auto-detected | Suppress implicit interactive prompts in `implement` |
|
|
@@ -422,11 +434,14 @@ readiness / create sprint) stay TUI-only by design. The CLI exposes inspection +
|
|
|
422
434
|
| Command | Description |
|
|
423
435
|
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
424
436
|
| `ralphctl` | Interactive TUI (primary surface) |
|
|
437
|
+
| `ralphctl demo` | Seed a throwaway sandbox project and launch straight into it — zero setup, no provider CLI required to look around (`--no-launch` to seed only, `--home <dir>` to relocate) |
|
|
425
438
|
| `ralphctl doctor` | Check environment health |
|
|
426
439
|
| `ralphctl settings show` | Print current settings |
|
|
427
440
|
| `ralphctl settings set <key> <value>` | Set a single settings key |
|
|
428
441
|
| `ralphctl settings apply-preset <name>` | Stamp the entire `ai` section — 21 presets: `standard` / `economic` / `strong-gate` / `fast` / `frontier` families, each in `mixed` / `*-only` variants, plus `opencode-only` |
|
|
429
442
|
| `ralphctl completion <shell>` | Print shell tab-completion script |
|
|
443
|
+
| `ralphctl agents list` | List bundled + operator agent definitions and the implement role each is bound to |
|
|
444
|
+
| `ralphctl skills list` | List bundled + manually-dropped skills — tier, enabled flows, provenance |
|
|
430
445
|
|
|
431
446
|
### Project & Sprint Inspection
|
|
432
447
|
|
|
@@ -443,6 +458,7 @@ readiness / create sprint) stay TUI-only by design. The CLI exposes inspection +
|
|
|
443
458
|
| `ralphctl ticket list / show <id>` | Inspect tickets |
|
|
444
459
|
| `ralphctl ticket remove <id>` | Remove a ticket from a draft sprint |
|
|
445
460
|
| `ralphctl task list / show <id>` | Inspect tasks (planning generates them) |
|
|
461
|
+
| `ralphctl task evaluation <id>` | Print the latest evaluator verdict (`evaluation.md`) for the task's last attempt |
|
|
446
462
|
| `ralphctl task unblock <id>` | Reset a blocked task to `todo` |
|
|
447
463
|
|
|
448
464
|
### Sprint Lifecycle
|
|
@@ -463,10 +479,11 @@ readiness / create sprint) stay TUI-only by design. The CLI exposes inspection +
|
|
|
463
479
|
|
|
464
480
|
### Maintenance
|
|
465
481
|
|
|
466
|
-
| Command | Description
|
|
467
|
-
| ------------------------------------------------------------------------------------------ |
|
|
468
|
-
| `ralphctl runs list [--flow <name>]` | List per-run forensic artifacts grouped by flow
|
|
469
|
-
| `ralphctl runs
|
|
482
|
+
| Command | Description |
|
|
483
|
+
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
|
|
484
|
+
| `ralphctl runs list [--flow <name>]` | List per-run forensic artifacts grouped by flow |
|
|
485
|
+
| `ralphctl runs stats [--sprint <id>] [--project <id>] [--since <date>] [--json]` | Harness outcome rollup — outcome mix, first-pass rate, plateaus, escalation efficacy |
|
|
486
|
+
| `ralphctl runs prune [--older-than 7d] [--keep-last <n>] [--flow <name>] [--dry-run] [-y]` | Delete per-run forensic artifacts |
|
|
470
487
|
|
|
471
488
|
Run `ralphctl <command> --help` for flag-level detail.
|
|
472
489
|
|