Repository navigation
v0.25.0
What's changed
Added
-
Housekeeping, from Home's SYSTEM group (
H). A dry-run scan lists orphaned sprints and memory, old done
sprints and old runs with their sizes (KiB / MiB / GiB); select what to delete and confirm. Removing a project asks
separately whether to remove its sprints and memory too. -
Doctor shows what to fix first.
!groups failing probes ahead of the passing ones, which↵reveals. -
Crash recovery. If ralphctl dies mid-run (crash,
kill -9, power loss), an interrupted task shows in
Home's NEEDS ATTENTION group with its attempt, age and uncommitted changes;↵resumes Implement. Active sessions
lists the dead run (ddismisses it). On a best-effort basis the generator continues its previous provider
session when provider, model and working directory are unchanged, and starts from the full brief otherwise. An
interruption does not use up a task attempt (up to three in a row). -
Quit asks first.
qon Home /ctrl+cwith runs live asks[y/N](default No) and stops them cleanly on yes,
even when a run is waiting on your answer. A run that does not stop within 5s is force-stopped. Stopping a run
yourself does not use up a task attempt either, and the attempt counter shows· resumedafter a free restart. -
Waiting runs say so. A run blocked on your answer shows
[WAITING]in NEEDS ATTENTION, the footer and the run
view, and fires an OS notification (honouringui.notifications). Runs that finish after two minutes notify too. -
Presets fit your account. Applying a preset (Settings,
ralphctl settings apply-preset, first-run setup)
now checks which models your account can actually use and swaps in a close stand-in for any it can't — e.g. a
Copilot plan withoutgpt-6-lunagetsgpt-5.6-luna— and says which rows changed. Copilot now asks the Copilot
CLI for your account's models, so the Settings model picker lists only those too.
Changed
- New models, and the presets use them. Codex and Copilot gain
gpt-6.1-sol, which replacesgpt-6-solas the
Codex flagship in the Codex presets, the Codex defaults, the default implement evaluator and the top of the Codex
escalation ladder (same token price). Copilot gainsclaude-sonnet-5.5, which replaces Sonnet 5 in the Copilot
presets and its escalation ladder (Haiku → Sonnet 5.5 → Opus 4.8). Copilot's light flows move fromgpt-5.6-luna
togpt-6-luna(half the price). On Copilot,gpt-6.1-solis Pro+ only, so no Copilot preset uses it. - Copilot models GitHub retired on 2026-10-02 are gone.
gemini-3.5-flash/gemini-3.6-flash→
gemini-3.8-flash,kimi-k2.7-code→kimi-k3,claude-opus-4.7→claude-opus-4.8; a saved setting on one of
them is moved over on load. The models Copilot retires on 2026-10-19 (gpt-5.5,gpt-5.4,gpt-5.4-mini,
gpt-5-mini,gemini-3.7-flash,grok-4.5) still work until then, but no preset or escalation step uses them. - No more orphaned AI processes. AI CLIs run in their own process group; abort and the idle watchdog stop the
whole group, and a helper cleans up what a dead ralphctl left behind (on POSIX; on Windows the next launch
does it). Session ids are saved as soon as the CLI reports them. - Stale locks recover faster. A repository lock records its owner; a dead owner on the same machine is reclaimed
at once, and a held lock names the process that holds it. - Overlays outrank prompts. An open overlay stays closable while a prompt is queued, and
qnever quits through
one. The header and footer clip to one line at narrow widths.
Fixed
- Create sprint checks the name as you type. An empty, punctuation-only or too-long name (its slug may not
exceed 64 characters) stays at the prompt with an inline error instead of failing the run. - Project slugs are unique. Creating a project whose slug another project already uses is refused, and the
wizard says so at the slug step. - Review's distill question defaults to No, matching its
[y/N]label (close sprint's too).escon the
feedback prompt now leaves the sprint in review without journaling a close; an empty submission still closes it. - Detect scripts, Detect skills and Review check the AI CLI is on PATH before starting, like the other AI
flows, instead of failing on a spawn error. - progress.md's
State:line follows the sprint to active, review and done. - Refine's unavailable reason no longer says "add at least one ticket" when every ticket is already approved.
- Create PR checks the sprint first. An ineligible sprint is refused before anything is pushed, and if any AI
authoring step fails the PR opens with the template text instead of failing. - A PR without a URL is an error. When
gh/glabexits 0 without printing a URL, create PR now reports it
instead of storing the last line of output as the PR URL. - Context-file writes never overwrite blind. Readiness and distill refuse to replace an existing file they
can't read for a backup. - Cancelling a task settles its attempt. The running attempt is marked
abortedinstead of staying running. - Parallel implement stops after a failed setup. It no longer runs the closing steps when the prologue failed.
- Sprint delete respects running flows.
ralphctl sprint removeis refused while a flow runs, including a
flow in another process that holds no lock. - A blank task description is rejected instead of silently clearing the field.
ralphctl task evaluationprints an error to stderr and exits 1 when the artifact can't be read.- Effort follows the model, not just the provider. Copilot
claude-haiku-4.5gets no effort flag (its CLI
rejects any level), and Copilot / Codex models that support fewer levels get the closest one they accept — e.g.
maxbecomeshighon Copilotgpt-5-miniandxhighon Codexgpt-5.5. A globalmaxnow reaches the Codex
models that accept it instead of always flooring toxhigh. - A rejected effort or model blocks the task once, with the reason. When the AI CLI refuses the configured
effort or model, the task blocks after one attempt and names the setting to change (e.g.
ai.implement.generator.effort), instead of retrying until "AI process repeatedly crashed". Codex errors that it
reports only on stdout are now read too.
Removed
scm.postRefinementCommentsetting. It had no effect; existing settings files still load and drop it.
Full changelog: v0.25.0...HEAD
npm: https://www.npmjs.com/package/ralphctl/v/0.25.0