Replace removed top-level 'entire explain' with 'entire checkpoint explain' - #42
Merged
Conversation
…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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The CLI removed the top-level
explaincommand when commands moved into noun groups (entireio/cli5da62d086, Apr 2026). The command is nowentire checkpoint explain; the--checkpoint/-cflag is unchanged. Eight skills still tell agents to runentire 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 explain→entire checkpoint explainacross 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 onlyentire checkpoint explain.checkpoint checkpointmatches nothing).entire explain --checkpoint <id>fails;entire checkpoint explain --checkpoint <id>is the current spelling perentire 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 explaininstead of the removed top-levelentire explain.The change is a mechanical string update across
explain,recall,replay,review,session-to-skill,teach,using-entire, andwhat-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.