Skip to content

Replace removed top-level 'entire explain' with 'entire checkpoint explain' - #42

Merged
evisdren merged 1 commit into
mainfrom
fix/stale-top-level-explain
Aug 31, 2026
Merged

Replace removed top-level 'entire explain' with 'entire checkpoint explain'#42
evisdren merged 1 commit into
mainfrom
fix/stale-top-level-explain

Conversation

@evisdren

@evisdren evisdren commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Why

The CLI removed the top-level explain command when commands moved into noun groups (entireio/cli 5da62d086, Apr 2026). The command is now entire checkpoint explain; the --checkpoint/-c flag is unchanged. Eight skills still tell agents to run entire explain ..., which exits 1 with a root usage error — agents burn several failed attempts before self-correcting (observed live with recall on CLI 0.10.3).

What changed

Mechanical replace of entire explainentire checkpoint explain across 8 SKILL.md files (39 occurrences): explain, recall, replay, review, session-to-skill, teach, using-entire, what-happened. The search skill was already fixed by #40; session-handoff was already correct.

Validation

  • grep -r "entire explain" skills/ now matches only entire checkpoint explain.
  • No double replacements (checkpoint checkpoint matches nothing).
  • Verified against CLI 0.10.3: entire explain --checkpoint <id> fails; entire checkpoint explain --checkpoint <id> is the current spelling per entire agent-help.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only skill markdown updates with no application or CLI code changes; low risk aside from agents following the new command spelling.

Overview
Updates eight Entire agent skills so documented CLI invocations match the current Entire CLI, where transcript lookup lives under entire checkpoint explain instead of the removed top-level entire explain.

The change is a mechanical string update across explain, recall, replay, review, session-to-skill, teach, using-entire, and what-happened — guardrails, auth notes, shell examples (--checkpoint, --commit, --full, --json, --no-pager), and failure-mode text. Flags and workflow logic are unchanged; only the command path is corrected so agents do not hit exit 1 on modern CLI versions.

Reviewed by Cursor Bugbot for commit d48fb86. Configure here.

…plain'

The CLI removed the top-level explain command when commands moved into
noun groups (entireio/cli 5da62d086, Apr 2026); the command is now
'entire checkpoint explain'. Eight skills still instructed agents to run
'entire explain --checkpoint <id>', which exits 1 with a usage error and
costs agents several failed attempts before they self-correct.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@evisdren
evisdren merged commit 9966927 into main Aug 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant