[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.md if 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 /loop run becomes a pending wakeup instead of starting immediately
• that pressing Esc cancels pending /loop wakeups
• 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 /loop run becomes due while Claude is still busy, the wakeup waits until the current turn ends. While that wakeup is pending, press Esc to cancel it. When it resumes, Claude Code labels the run Claude resuming /loop wakeup so 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