[DOCS] `/loop` docs omit pending wakeup cancellation and resume label behavior
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/scheduled-tasks
Section/Topic
How scheduled tasks run and /loop wakeup behavior while a run is waiting to resume
Current Documentation
The scheduled-tasks page currently says:
The scheduler checks every second for due tasks and enqueues them at low priority. A scheduled prompt fires between your turns, not while Claude is mid-response. If Claude is busy when a task comes due, the prompt waits until the current turn ends.
The commands reference currently says:
/loop [interval] [prompt]| Skill. Run a prompt repeatedly while the session stays open. Omit the interval and Claude self-paces between iterations. Omit the prompt and Claude runs an autonomous maintenance check, or the prompt in.claude/loop.mdif present.
The terminal guide currently says:
* Press Esc to interrupt Claude if it's running.
I could not find any code.claude.com page that explains what a pending /loop wakeup looks like before it resumes, that pressing Esc cancels those pending wakeups, or that the resume event now displays as Claude resuming /loop wakeup.
What's Wrong or Missing?
Changelog v2.1.113 added user-visible /loop wakeup behavior, but the docs still stop at generic scheduling details.
Users currently cannot learn from the docs:
A. That /loop wakeups can sit pending while Claude finishes the current turn
The docs say due prompts wait until the current turn ends, but they do not explain this as a distinct pending /loop wakeup state that users may need to recognize and manage.
B. That pressing Esc now cancels pending /loop wakeups
The generic Esc documentation only says it interrupts Claude while it is running. It does not mention that Esc also cancels a queued /loop wakeup before that wakeup resumes.
C. What text users should expect to see when a /loop wakeup resumes
The docs do not mention the new Claude resuming /loop wakeup label, so users have no documented explanation for that transcript/status text.
Suggested Improvement
Add a short /loop wakeup lifecycle note to https://code.claude.com/docs/en/scheduled-tasks, near How scheduled tasks run, that explains:
- when a due
/looprun becomes a pending wakeup instead of starting immediately - that pressing
Esccancels pending/loopwakeups - that resumed wakeups are labeled
Claude resuming /loop wakeup
Also add a brief note or cross-reference in https://code.claude.com/docs/en/commands so users reading the /loop command entry know that queued wakeups can be cancelled with Esc.
For example:
If a/looprun becomes due while Claude is still busy, the wakeup waits until the current turn ends. While that wakeup is pending, pressEscto cancel it. When it resumes, Claude Code labels the runClaude resuming /loop wakeupso you can tell it apart from a normal prompt.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/scheduled-tasks | Primary /loop and scheduler behavior documentation; should explain pending wakeups, Esc cancellation, and the resume label |
| https://code.claude.com/docs/en/commands | Primary command reference for /loop; should link to or summarize the pending wakeup behavior |
| https://code.claude.com/docs/en/terminal-guide | Generic Esc interruption docs; useful cross-reference because /loop now adds a queued-wakeup cancellation case |
Total scope: 3 pages affected
Source: Changelog v2.1.113
Exact changelog entry: Improved /loop: pressing Esc now cancels pending wakeups, and wakeups display as "Claude resuming /loop wakeup" for clarity
3 Comments
Still relevant as of 2026-05-18. This documentation gap has not been addressed in the docs yet.
Issue #50122 Verification
Title: [DOCS]
/loopdocs omit pending wakeup cancellation and resume label behaviorIssue Date: 2026-04-17
Verification Date: 2026-06-04
Status: RESOLVED
---
Issue Summary
This issue reports that the
/loopand scheduled-task documentation did not explain three wakeup-lifecycle details: that a due/looprun can wait pending until the current turn ends, that pressingEsccancels a pending/loopwakeup, and that resumed wakeups display the labelClaude resuming /loop wakeup.---
Verification Results
Claim 1: The docs do not explain that
/loopwakeups can wait pending until Claude finishes the current turnStatus: RESOLVED
At https://code.claude.com/docs/en/scheduled-tasks, line 169, the docs state:
If Claude is busy when a task comes due, the prompt waits until the current turn ends.At https://code.claude.com/docs/en/tools-reference, line 37, the docs further state:
The pending wakeup appears in session_crons in Stop hook input.Verdict: The current docs now describe both the wait-until-idle behavior and the existence of a pending wakeup state for
/loop.---
Claim 2: The docs do not explain that pressing
Esccancels a pending/loopwakeupStatus: RESOLVED
At https://code.claude.com/docs/en/scheduled-tasks, line 127, the docs state:
To stop a /loop while it is waiting for the next iteration, press Esc. This clears the pending wakeup so the loop does not fire again.At https://code.claude.com/docs/en/commands, line 90, the
/loopcommand entry points readers to the scheduled-tasks page:See Run prompts on a schedule.Verdict: The current scheduled-tasks documentation explicitly says that
Escclears a pending/loopwakeup, and the/loopcommand reference links readers to that page.---
Claim 3: The docs do not mention the
Claude resuming /loop wakeuplabel users see when a wakeup resumesStatus: RESOLVED
At https://code.claude.com/docs/en/changelog, line 1116, the docs state:
Improved /loop: pressing Esc now cancels pending wakeups, and wakeups display as "Claude resuming /loop wakeup" for clarity.Verdict: The current documentation set now explicitly names the resume label, so this specific claim is no longer current.
---
Current State
| Claim | Status |
|-------|--------|
| Pending
/loopwakeups while Claude is busy are undocumented | RESOLVED ||
Esccancellation of pending/loopwakeups is undocumented | RESOLVED || The
Claude resuming /loop wakeuplabel is undocumented | RESOLVED |---
Suggested Fix
N/A - issue has been resolved.
---
References
Escwhile/loopis waiting clears the pending wakeup. Line 169: documents that due tasks wait until the current turn ends if Claude is busy./loophas a pending wakeup visible insession_crons./loopcommand entry directs readers to the scheduled-tasks page.Claude resuming /loop wakeuplabel.---
Conclusion & Recommendation
Primary Concern: The issue reported that
/loopwakeup behavior and user-visible wakeup text were not documented clearly enough for readers to understand pending wakeups, cancellation, and resumed-run labeling.Resolution Status: RESOLVED
Recommendation: CLOSE
The reported documentation gaps are now covered in the current docs set. Pending wakeups,
Esccancellation, and theClaude resuming /loop wakeuplabel are all documented with current evidence.This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.