`/note-loop`

Task Loop

Turn Claude Code into an autonomous task executor. Create tasks inline, loop from an existing note, or schedule for later in a new Terminal session. Built-in pause, skip, stop, and resume. The Stop hook blocks Claude from exiting while tasks remain — each completed task auto-checks in SlashNote.

Quick Example

Claude Code

/note-loop Write tests, Implement feature, Update docs

Creates green pinned note with 3 checkboxes and starts executing immediately.

Screenshot Placeholder

Result: Task Loop sticky note (green color) created from the command above

Key Features

🔄

Auto-Execute Loop

Claude works through each task sequentially, auto-checks items in SlashNote, and moves to the next. No manual intervention needed.

📅

Schedule for Later

Use --new-session to schedule loops in a new Terminal. Pick a preset time or enter custom delay. Choose model (Opus/Sonnet/Haiku) and permission mode.

⏸️

Pause, Skip, Stop

/note-loop pause (immediate), pause after (graceful), skip <reason> (move on), stop (end loop). Progress summary on every action.

🛡️

Safety Limits

Max iterations scale with task count. Each task gets 3 attempts before marked blocked. Blocked tasks stay unchecked for manual follow-up.

Real-World Examples

New task loop

/note-loop Write tests, Implement feature, Update docs

Creates green pinned note with 3 checkboxes and starts executing immediately.

From existing note

/note-loop A550DE30-9B73-4CE5-A138-38F848471329

Reads unchecked items from an existing note and starts executing them.

Schedule for later

/note-loop  --new-session 2h --sonnet

Schedules loop in a new Terminal in 2 hours with Sonnet model.

How the Loop Works

You provide tasks (inline text, existing note UUID, or resume)
A green pinned note is created with checkboxes
Claude starts executing the first task
The Stop hook intercepts Claude’s exit and loads the next task
Each completed task auto-checks in SlashNote
Repeat until all tasks are done or you pause/stop

The Stop hook is the key mechanism — it blocks Claude from exiting while tasks remain.

Modes

New Tasks (Inline)

/note-loop Write tests, Implement feature, Update docs

Creates a green pinned note with checkboxes and starts executing immediately.

From Existing Note (UUID)

/note-loop A550DE30-9B73-4CE5-A138-38F848471329

Reads unchecked checkboxes from an existing note and starts executing them.

Schedule for Later (New Terminal)

/note-loop <uuid> --new-session 2h
/note-loop <uuid> --new-session --sonnet

Opens a new Terminal session with the specified delay. Choose model (Opus, Sonnet, Haiku) and permission mode (plan, acceptEdits, bypassPermissions).

Resume

/note-loop

Finds the existing note-loop note and resumes from unchecked items.

Loop Control

Command	Effect
`/note-loop pause`	Immediate pause — resume later with `/note-loop`
`/note-loop pause after`	Graceful pause — finish current task, then stop
`/note-loop skip <reason>`	Skip current task with reason, move to next
`/note-loop stop <reason>`	Stop loop entirely, show final summary
`/note-loop list`	List all active/scheduled loops
`/note-loop cancel <uuid>`	Cancel a scheduled loop

Every pause/stop action shows a progress summary: Done, Skipped, Remaining with completion percentage.

Safety Mechanisms

Safety	Description
Max iterations	`max(30, tasks * 3)` — scales with task count
Per-task attempts	3 tries before marking as blocked
Pause/stop	`/note-loop pause` or `/note-loop stop` at any time
State file	JSON state survives session restarts
Blocked tasks	Stay unchecked for manual follow-up

Progress Tracking

A live progress chart on the pinned note shows:

Done tasks (green)
Remaining tasks (gray)

The chart updates automatically as the Stop hook processes each task.

When using --new-session without a time, a menu appears:

Option	Description
Run now	Opens new Terminal and starts immediately
In 1 minute	Short delay to verify setup
In 30 minutes	Finish current work first
In 2 hours	Schedule for later

You can also enter a custom time (1h 30m, at 18:00).