runpane 2.4.199 → 2.4.201

package/dist/generated/contract.js

@@ -1509,6 +1509,120 @@ exports.RUNPANE_CONTRACT = {
                 "prWatchResult"
             ],
             "localControl": true
+        },
+        {
+            "name": "loops list",
+            "summary": "List loops (scheduled tasks) with their schedule, next run, and recent runs.",
+            "usage": [
+                "runpane loops list [--json] [--pane-dir <path>]"
+            ],
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopListResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops create",
+            "summary": "Create a loop: a cron schedule that starts a new Pane in a fresh worktree for each run, or sends a prompt to a Session's agent. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+            "usage": [
+                "runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--paused] [--dry-run] --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "additive": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopInput",
+                "loopResult",
+                "loopDryRunResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops update",
+            "summary": "Change a loop's repo or Session, name, schedule, agent or command, prompt, or worktree template. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+            "usage": [
+                "runpane loops update --loop <id> [--repo <selector>|--session <id|name|new>] [--name <name>] [--cron <expr>] [--agent <claude|codex|cursor>|--tool-command <command>] [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--dry-run] --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "idempotent": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopInput",
+                "loopResult",
+                "loopDryRunResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops run",
+            "summary": "Start a run of a loop now. The schedule stays the same.",
+            "usage": [
+                "runpane loops run --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "additive": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops pause",
+            "summary": "Pause a loop: it starts no scheduled runs until resumed.",
+            "usage": [
+                "runpane loops pause --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "idempotent": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops resume",
+            "summary": "Resume a paused loop from its next scheduled time.",
+            "usage": [
+                "runpane loops resume --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "idempotent": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopResult"
+            ],
+            "localControl": true
+        },
+        {
+            "name": "loops delete",
+            "summary": "Delete a loop. It starts no more runs.",
+            "usage": [
+                "runpane loops delete --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "mutates": true,
+            "idempotent": true,
+            "toolsets": [
+                "loops"
+            ],
+            "jsonSchemas": [
+                "loopDeleteResult"
+            ],
+            "localControl": true
         }
     ],
     "flags": {
@@ -1629,12 +1743,12 @@ exports.RUNPANE_CONTRACT = {
             {
                 "name": "--name",
                 "value": "<name>",
-                "description": "Name for the registered repository, created/renamed pane session, or named lock."
+                "description": "Name for the registered repository, created/renamed pane session, named lock, or loop."
             },
             {
                 "name": "--worktree-name",
                 "value": "<name>",
-                "description": "Worktree name to request. Defaults to --name."
+                "description": "Worktree name to request. Defaults to --name. For a loop, the worktree and branch name template; defaults to loop-<name>."
             },
             {
                 "name": "--branch",
@@ -1855,6 +1969,16 @@ exports.RUNPANE_CONTRACT = {
                 "value": "<text>",
                 "description": "What a named lock is for. Outside a Pane terminal it also names the owner, so pass the same note to release it."
             },
+            {
+                "name": "--loop",
+                "value": "<id>",
+                "description": "Loop id, from `runpane loops list`."
+            },
+            {
+                "name": "--cron",
+                "value": "<expr>",
+                "description": "Five-field cron schedule in this machine's local time zone, such as \"0 3 * * *\". Runs must be at least 60 minutes apart."
+            },
             {
                 "name": "--message",
                 "value": "<message>",
@@ -2065,6 +2189,10 @@ exports.RUNPANE_CONTRACT = {
             {
                 "name": "--all",
                 "description": "inbox ack only: clear every item of the --session."
+            },
+            {
+                "name": "--paused",
+                "description": "loops create only: create the loop paused."
             }
         ]
     },
@@ -2098,6 +2226,9 @@ exports.RUNPANE_CONTRACT = {
                 "  runpane lock acquire --name <name> --ttl <duration> [--wait <milliseconds>] [--note <text>] [--pane <pane-id>] [--panel <panel-id>] [--json] [--pane-dir <path>]",
                 "  runpane lock release --name <name> [--force] [--session <id|name>] [--note <text>] [--pane <pane-id>] [--panel <panel-id>] [--json] [--pane-dir <path>]",
                 "  runpane lock list [--session <id|name>] [--json] [--pane-dir <path>]",
+                "  runpane loops list [--json]",
+                "  runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>] --yes",
+                "  runpane loops update|run|pause|resume|delete --loop <id> --yes",
                 "  runpane panes list [--repo <selector>] [--json]",
                 "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
                 "  runpane workspace state [--repo <selector>] [--json]",
@@ -3282,6 +3413,147 @@ exports.RUNPANE_CONTRACT = {
                 "  --session <id|name>          Named Session whose locks to list or release.",
                 "  --json                       Print JSON output."
             ],
+            "loops": [
+                "Usage:",
+                "  runpane loops <list|create|update|run|pause|resume|delete> [options]",
+                "",
+                "Loops (scheduled tasks) start a new Pane in a fresh worktree on a cron schedule.",
+                "A Session loop instead sends its prompt to a Session's agent each run.",
+                "Loops are for large recurring jobs and run at most once an hour.",
+                "For short waits, use your agent harness's own sleep and wake.",
+                "Runs start only while Pane is running, in this machine's local time zone.",
+                "",
+                "Commands:",
+                "  runpane loops list [--json] [--pane-dir <path>]",
+                "  runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--paused] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "  runpane loops update --loop <id> [--repo <selector>|--session <id|name|new>] [--name <name>] [--cron <expr>] [--agent <claude|codex|cursor>|--tool-command <command>] [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "  runpane loops run --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  runpane loops pause --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  runpane loops resume --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  runpane loops delete --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "loops list": [
+                "Usage:",
+                "runpane loops list [--json] [--pane-dir <path>]",
+                "",
+                "List loops (scheduled tasks) with their schedule, next run, and recent runs.",
+                "",
+                "Options:",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops create": [
+                "Usage:",
+                "runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--paused] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "",
+                "Create a loop: a cron schedule that starts a new Pane in a fresh worktree for each run, or sends a prompt to a Session's agent. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "With --repo, each run is a new Pane in a fresh worktree from the repo's default base branch.",
+                "A Session loop sends its prompt to that Session's agent each run instead of creating a new Pane.",
+                "",
+                "Options:",
+                "  --repo <selector>               Repository: active, id, exact path, or saved name.",
+                "  --session <id|name|new>         Session whose agent gets the prompt each run, instead of",
+                "                                  a new Pane; `new` creates a Session named after the loop.",
+                "                                  That agent then skips permission prompts for every message",
+                "                                  it gets, not only loop runs.",
+                "  --name <name>                   Loop name.",
+                "  --cron <expr>                   Five-field cron in local time, such as \"0 3 * * *\"; at least 1 hour apart.",
+                "  --agent <claude|codex|cursor>   Agent each run starts; for a Session loop, the Session's agent.",
+                "                                  Runs skip permission prompts.",
+                "  --tool-command <command>        Command each run starts instead of an agent, such as",
+                "                                  ./scripts/nightly-report.sh. Project loops only. On Windows it runs",
+                "                                  in Pane's terminal shell, Git Bash by default, so write bash or",
+                "                                  `cmd //c`: \"cmd //c echo hi > loop.txt\" works, \"cmd /c ...\" hangs.",
+                "  --prompt <text>                 Text typed into the agent or command after it starts; for a",
+                "                                  Session loop, the message sent to the Session's agent each run.",
+                "  --prompt-file <path|->          Read the prompt from a file or stdin.",
+                "  --worktree-name <template>      Worktree and branch name; defaults to loop-<name>. Project loops only.",
+                "  --paused                        Create the loop paused.",
+                "  --dry-run                       Check the schedule and print what would be saved.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops update": [
+                "Usage:",
+                "runpane loops update --loop <id> [--repo <selector>|--session <id|name|new>] [--name <name>] [--cron <expr>] [--agent <claude|codex|cursor>|--tool-command <command>] [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "",
+                "Change a loop's repo or Session, name, schedule, agent or command, prompt, or worktree template. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "With --repo, each run is a new Pane in a fresh worktree from the repo's default base branch.",
+                "A Session loop sends its prompt to that Session's agent each run instead of creating a new Pane.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop to change; other flags replace its values.",
+                "  --repo <selector>               Repository: active, id, exact path, or saved name.",
+                "  --session <id|name|new>         Session whose agent gets the prompt each run, instead of",
+                "                                  a new Pane; `new` creates a Session named after the loop.",
+                "                                  That agent then skips permission prompts for every message",
+                "                                  it gets, not only loop runs.",
+                "  --name <name>                   Loop name.",
+                "  --cron <expr>                   Five-field cron in local time, such as \"0 3 * * *\"; at least 1 hour apart.",
+                "  --agent <claude|codex|cursor>   Agent each run starts; for a Session loop, the Session's agent.",
+                "                                  Runs skip permission prompts.",
+                "  --tool-command <command>        Command each run starts instead of an agent, such as",
+                "                                  ./scripts/nightly-report.sh. Project loops only. On Windows it runs",
+                "                                  in Pane's terminal shell, Git Bash by default, so write bash or",
+                "                                  `cmd //c`: \"cmd //c echo hi > loop.txt\" works, \"cmd /c ...\" hangs.",
+                "  --prompt <text>                 Text typed into the agent or command after it starts; for a",
+                "                                  Session loop, the message sent to the Session's agent each run.",
+                "  --prompt-file <path|->          Read the prompt from a file or stdin.",
+                "  --worktree-name <template>      Worktree and branch name; defaults to loop-<name>. Project loops only.",
+                "  --dry-run                       Check the schedule and print what would be saved.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops run": [
+                "Usage:",
+                "runpane loops run --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Start a run of a loop now. The schedule stays the same.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops pause": [
+                "Usage:",
+                "runpane loops pause --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Pause a loop: it starts no scheduled runs until resumed.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops resume": [
+                "Usage:",
+                "runpane loops resume --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Resume a paused loop from its next scheduled time.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops delete": [
+                "Usage:",
+                "runpane loops delete --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Delete a loop. It starts no more runs.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
             "workspace list": [
                 "Usage:",
                 "  runpane workspace list [--json] [--pane-dir <path>]",
@@ -3497,6 +3769,9 @@ exports.RUNPANE_CONTRACT = {
                 "  runpane lock acquire --name <name> --ttl <duration> [--wait <milliseconds>] [--note <text>] [--pane <pane-id>] [--panel <panel-id>] [--json] [--pane-dir <path>]",
                 "  runpane lock release --name <name> [--force] [--session <id|name>] [--note <text>] [--pane <pane-id>] [--panel <panel-id>] [--json] [--pane-dir <path>]",
                 "  runpane lock list [--session <id|name>] [--json] [--pane-dir <path>]",
+                "  python -m runpane loops list [--json]",
+                "  python -m runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>] --yes",
+                "  python -m runpane loops update|run|pause|resume|delete --loop <id> --yes",
                 "  runpane help [command]",
                 "",
                 "Quick start:",
@@ -4588,6 +4863,147 @@ exports.RUNPANE_CONTRACT = {
                 "  --session <id|name>          Named Session whose locks to list or release.",
                 "  --json                       Print JSON output."
             ],
+            "loops": [
+                "Usage:",
+                "  python -m runpane loops <list|create|update|run|pause|resume|delete> [options]",
+                "",
+                "Loops (scheduled tasks) start a new Pane in a fresh worktree on a cron schedule.",
+                "A Session loop instead sends its prompt to a Session's agent each run.",
+                "Loops are for large recurring jobs and run at most once an hour.",
+                "For short waits, use your agent harness's own sleep and wake.",
+                "Runs start only while Pane is running, in this machine's local time zone.",
+                "",
+                "Commands:",
+                "  python -m runpane loops list [--json] [--pane-dir <path>]",
+                "  python -m runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--paused] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "  python -m runpane loops update --loop <id> [--repo <selector>|--session <id|name|new>] [--name <name>] [--cron <expr>] [--agent <claude|codex|cursor>|--tool-command <command>] [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "  python -m runpane loops run --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  python -m runpane loops pause --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  python -m runpane loops resume --loop <id> --yes [--json] [--pane-dir <path>]",
+                "  python -m runpane loops delete --loop <id> --yes [--json] [--pane-dir <path>]"
+            ],
+            "loops list": [
+                "Usage:",
+                "python -m runpane loops list [--json] [--pane-dir <path>]",
+                "",
+                "List loops (scheduled tasks) with their schedule, next run, and recent runs.",
+                "",
+                "Options:",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops create": [
+                "Usage:",
+                "python -m runpane loops create (--repo <selector>|--session <id|name|new>) --name <name> --cron <expr> (--agent <claude|codex|cursor>|--tool-command <command>) [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--paused] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "",
+                "Create a loop: a cron schedule that starts a new Pane in a fresh worktree for each run, or sends a prompt to a Session's agent. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "With --repo, each run is a new Pane in a fresh worktree from the repo's default base branch.",
+                "A Session loop sends its prompt to that Session's agent each run instead of creating a new Pane.",
+                "",
+                "Options:",
+                "  --repo <selector>               Repository: active, id, exact path, or saved name.",
+                "  --session <id|name|new>         Session whose agent gets the prompt each run, instead of",
+                "                                  a new Pane; `new` creates a Session named after the loop.",
+                "                                  That agent then skips permission prompts for every message",
+                "                                  it gets, not only loop runs.",
+                "  --name <name>                   Loop name.",
+                "  --cron <expr>                   Five-field cron in local time, such as \"0 3 * * *\"; at least 1 hour apart.",
+                "  --agent <claude|codex|cursor>   Agent each run starts; for a Session loop, the Session's agent.",
+                "                                  Runs skip permission prompts.",
+                "  --tool-command <command>        Command each run starts instead of an agent, such as",
+                "                                  ./scripts/nightly-report.sh. Project loops only. On Windows it runs",
+                "                                  in Pane's terminal shell, Git Bash by default, so write bash or",
+                "                                  `cmd //c`: \"cmd //c echo hi > loop.txt\" works, \"cmd /c ...\" hangs.",
+                "  --prompt <text>                 Text typed into the agent or command after it starts; for a",
+                "                                  Session loop, the message sent to the Session's agent each run.",
+                "  --prompt-file <path|->          Read the prompt from a file or stdin.",
+                "  --worktree-name <template>      Worktree and branch name; defaults to loop-<name>. Project loops only.",
+                "  --paused                        Create the loop paused.",
+                "  --dry-run                       Check the schedule and print what would be saved.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops update": [
+                "Usage:",
+                "python -m runpane loops update --loop <id> [--repo <selector>|--session <id|name|new>] [--name <name>] [--cron <expr>] [--agent <claude|codex|cursor>|--tool-command <command>] [--prompt <text>|--prompt-file <path|->] [--worktree-name <template>] [--dry-run] --yes [--json] [--pane-dir <path>]",
+                "",
+                "Change a loop's repo or Session, name, schedule, agent or command, prompt, or worktree template. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "With --repo, each run is a new Pane in a fresh worktree from the repo's default base branch.",
+                "A Session loop sends its prompt to that Session's agent each run instead of creating a new Pane.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop to change; other flags replace its values.",
+                "  --repo <selector>               Repository: active, id, exact path, or saved name.",
+                "  --session <id|name|new>         Session whose agent gets the prompt each run, instead of",
+                "                                  a new Pane; `new` creates a Session named after the loop.",
+                "                                  That agent then skips permission prompts for every message",
+                "                                  it gets, not only loop runs.",
+                "  --name <name>                   Loop name.",
+                "  --cron <expr>                   Five-field cron in local time, such as \"0 3 * * *\"; at least 1 hour apart.",
+                "  --agent <claude|codex|cursor>   Agent each run starts; for a Session loop, the Session's agent.",
+                "                                  Runs skip permission prompts.",
+                "  --tool-command <command>        Command each run starts instead of an agent, such as",
+                "                                  ./scripts/nightly-report.sh. Project loops only. On Windows it runs",
+                "                                  in Pane's terminal shell, Git Bash by default, so write bash or",
+                "                                  `cmd //c`: \"cmd //c echo hi > loop.txt\" works, \"cmd /c ...\" hangs.",
+                "  --prompt <text>                 Text typed into the agent or command after it starts; for a",
+                "                                  Session loop, the message sent to the Session's agent each run.",
+                "  --prompt-file <path|->          Read the prompt from a file or stdin.",
+                "  --worktree-name <template>      Worktree and branch name; defaults to loop-<name>. Project loops only.",
+                "  --dry-run                       Check the schedule and print what would be saved.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops run": [
+                "Usage:",
+                "python -m runpane loops run --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Start a run of a loop now. The schedule stays the same.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops pause": [
+                "Usage:",
+                "python -m runpane loops pause --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Pause a loop: it starts no scheduled runs until resumed.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops resume": [
+                "Usage:",
+                "python -m runpane loops resume --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Resume a paused loop from its next scheduled time.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
+            "loops delete": [
+                "Usage:",
+                "python -m runpane loops delete --loop <id> --yes [--json] [--pane-dir <path>]",
+                "",
+                "Delete a loop. It starts no more runs.",
+                "",
+                "Options:",
+                "  --loop <id>                     Loop id, from runpane loops list.",
+                "  --yes                           Confirm the change.",
+                "  --json                          Print JSON output.",
+                "  --pane-dir <path>               Connect to a specific Pane data directory."
+            ],
             "workspace list": [
                 "Usage:",
                 "  runpane workspace list [--json] [--pane-dir <path>]",
@@ -4787,6 +5203,9 @@ exports.RUNPANE_CONTRACT = {
             "runpane lock acquire --name testing-account --ttl 30m --wait 1800000 --note \"call QA\" --json",
             "runpane lock release --name testing-account --json",
             "runpane lock list --json",
+            "runpane loops create --repo active --name nightly-bug-sweep --cron \"0 3 * * *\" --agent claude --prompt \"Fix one bug from yesterday's issues\" --yes --json",
+            "runpane loops list --json",
+            "runpane loops run --loop <loop-id> --yes --json",
             "runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json",
             "runpane agents start --pane <pane-id> --agent codex --prompt \"Review the PR from this branch and report findings\" --yes --json",
             "runpane agents status --pane <pane-id> --json",
@@ -4852,6 +5271,7 @@ exports.RUNPANE_CONTRACT = {
             "`sessions detach` detach a Pane from a named Session.",
             "`sessions overview` read a live status, activity, git, and pull request overview for a named Session. Each panel in `panes[].panels[]` carries its own latest `runpane report` as `report`, so one call shows what every worker last reported and when (`reportedAt`, next to the panel's `state` and `lastActivityAt`). When a report's summary is a complete JSON object, such as a status file sent with `--summary-file`, `report.data` holds it exactly as the worker gave it; Pane never reads, renames or validates its fields. A summary that is not a JSON object (plain text, an array, a scalar or invalid JSON), is nested more than 64 levels deep, or was truncated (`summaryTruncated`), has no `data`. A panel that never reported has no `report`. `panes[].report` is still the newest report among the Pane's panels.",
             "`runpane lock acquire|release|list` coordinate a resource shared between agents, such as one test account. The caller's Pane and panel own the lock; it is scoped to the owner's Session (or global outside one), renews for the same owner, and is released on TTL expiry, owner panel exit, or owner Pane archive. `--wait` blocks in the daemon until the lock comes free.",
+            "`runpane loops list|create|update|run|pause|resume|delete` manage loops (scheduled tasks): a cron schedule that starts a new Pane in a fresh worktree for each run, or sends a prompt to a Session's agent. Loops are for large recurring jobs and run at most once an hour; for short waits, agents use their harness's own sleep and wake. See [LOOPS.md](LOOPS.md).",
             "`runpane agents start|status|send` finish the three common agent jobs in one call each: start an agent on a task (a new tab in the work's Pane with `--pane <id>`, or a new Pane for new work), check on it, and send it a follow-up.",
             "`runpane report --state ready|blocked|failed|done` is how a worker hands back its result. It stores the latest report on the worker's panel (state, `--pr`, `--head`, up to 16,000 characters of `--summary` or `--summary-file`, and the `--question` a blocked worker needs answered), journals an opt-in `agent.report` watch event (`REPORT <pane-name> pane <pane-id> panel <panel-id> ready pr#747 fc5dce9`; it skips the `--min-interval` batch), records it as Session activity, and shows it in `agents status`, `panels list`, and `sessions overview` (each panel's own report as `panes[].panels[].report`, with a JSON object summary as `data`, and the Pane's newest as `panes[].report`). Inside a Pane terminal the panel comes from `PANE_SESSION_ID` and `PANE_PANEL_ID`; elsewhere pass `--pane` and `--panel`. It prints how many watches were waiting for the report and received it (`Delivered to 1 waiting watcher.`, `liveWatchers` in JSON). Zero means nobody was waiting right now, not that the report is lost: it stays on the panel, and a named-cursor watch receives it when it next waits.",
             "Work sent to an agent through `runpane panels create`, `panes create` (with a prompt), or `panels submit` records that the sender waits for a `runpane report`, unless the request says `--source user` (Pane's own UI does) or `--no-expect-report`; `--expect-report` asks for one anyway. Typing into a tab never does. If the agent then goes ready or its panel exits without a report, Pane journals one opt-in `agent.report.missing` entry (`MISSING REPORT <pane-name> pane <pane-id> panel <panel-id> ready|exited`) whose `lastOutput` is the agent's last transcript reply or last screen lines; it skips the `--min-interval` batch and reaches only watchers that list it in `--kinds`. While the agent's screen shows background work (Claude's `· 1 shell` footer or a running background subagent row, Codex's `background terminal running` line), Pane waits and looks again every 10 seconds instead. `agent.blocked` entries carry `screenLines`, the prompt the agent waits on, and are journalled once a panel has stayed blocked for 2 seconds.",
@@ -5937,6 +6357,94 @@ exports.RUNPANE_CONTRACT = {
                 "deploy",
                 "--wait",
                 "5000"
+            ],
+            [
+                "loops",
+                "create",
+                "--repo",
+                "active",
+                "--name",
+                "nightly",
+                "--cron",
+                "0 3 * * *",
+                "--agent",
+                "claude",
+                "--prompt",
+                "Sweep bugs",
+                "--worktree-name",
+                "nightly-sweep",
+                "--paused",
+                "--dry-run",
+                "--yes",
+                "--json"
+            ],
+            [
+                "loops",
+                "create",
+                "--repo=2",
+                "--name=deps",
+                "--cron=0 9 * * 1",
+                "--tool-command",
+                "./scripts/nightly-report.sh",
+                "--prompt-file",
+                "-"
+            ],
+            [
+                "loops",
+                "create",
+                "--session",
+                "new",
+                "--name",
+                "triage",
+                "--cron",
+                "0 9 * * 1-5",
+                "--agent",
+                "claude",
+                "--prompt",
+                "Triage",
+                "--yes"
+            ],
+            [
+                "loops",
+                "update",
+                "--loop",
+                "loop-1",
+                "--cron",
+                "0 4 * * *",
+                "--yes"
+            ],
+            [
+                "loops",
+                "update",
+                "--loop",
+                "loop-1",
+                "--session",
+                "Nightly",
+                "--yes"
+            ],
+            [
+                "loops",
+                "run",
+                "--loop=loop-1",
+                "--yes",
+                "--json"
+            ],
+            [
+                "loops",
+                "pause",
+                "--loop",
+                "loop-1",
+                "--pane-dir",
+                "/tmp/pane"
+            ],
+            [
+                "loops",
+                "list",
+                "--json"
+            ],
+            [
+                "loops",
+                "--help"
             ]
         ],
         "topLevelHelpIncludes": [
@@ -5967,11 +6475,13 @@ exports.RUNPANE_CONTRACT = {
         ],
         "npmHelpIncludes": [
             "pnpm dlx runpane@latest",
-            "npx --yes runpane@latest"
+            "npx --yes runpane@latest",
+            "runpane loops list"
         ],
         "pipHelpIncludes": [
             "pipx run runpane",
-            "python -m pip install runpane && python -m runpane setup"
+            "python -m pip install runpane && python -m runpane setup",
+            "python -m runpane loops list"
         ],
         "installHelpIncludes": [
             "--version <latest|vX.Y.Z>",
@@ -11648,34 +12158,275 @@ exports.RUNPANE_CONTRACT = {
                 }
             },
             "additionalProperties": false
-        }
-    },
-    "agentContext": {
-        "brief": {
-            "title": "Pane agent context",
-            "summary": "Pane lets a developer manage saved base repositories, user-visible Panes (Pane sessions) for feature/PR work, and terminal-backed panel tabs. A Pane is a visible workspace that normally maps to one Pane-managed git worktree and branch; a panel is a terminal tab inside one Pane and shares that Pane's worktree; an agent is a CLI process running inside a panel.",
-            "rules": [
-                "Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.",
-                "In a Pane repository checkout, if `runpane` is not on PATH, build the local wrapper with `pnpm --filter runpane build` and run it with patched Node 22.23.4+ (22.x), 24.22.1+ (24.x), or 26.12.1+ (26.x), for example `node packages/runpane/dist/cli.js doctor --json`.",
-                "Happy path for any user request to use Pane/RunPane: run `runpane doctor --json`, read `runpane agent-context --json`, resolve or add the saved base repo, then route by the rule 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane: if the work's branch already has a Pane (find it with `runpane panes list --repo <repo> --json` by matching the PR's head branch against `git -C <worktreePath> branch --show-current`), open a new agent tab in it with `runpane panels create --pane <id> --agent <agent> --initial-input \"<task>\" --source agent --no-focus --wait-ready --yes --json`; only when the branch has no Pane yet, create one with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json` (the new Pane is pinned by default; add `--no-pinned` for a throwaway Pane, add `--base-branch <ref>` to branch from something other than the repository default, or use `--tool-command <command>` instead of `--agent <agent>`), then validate with `panels wait` or `panels screen`. For long-lived supervision, use `runpane watch --follow` instead of polling wait or screen.",
-                "Treat Pane as the user's visible cockpit for watching/co-driving work. Do not create Panes or panels for private delegation unless the user asked for visible Pane orchestration or the result should appear in the Pane app.",
-                "Register the saved base repository once with `repos add`; do not register a pre-created worktree as a separate repo unless the user explicitly asks.",
-                "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Use `panes create` only when the work's branch has no Pane yet (new work, or an existing PR with no Pane), since each new Pane creates a worktree. Every later agent for that branch opens as a new tab in its Pane with `panels create --pane <id>`, never a new Pane. Tabs share one checkout: only the implementer changes the branch or HEAD, one writer at a time; review, audit and QA tabs never run `git checkout`, `reset` or `stash`.",
-                "For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.",
-                "Skill routing: Pane's skills live in `<PANE_DIR>/skills/pane-chat/skills/`, and the Pane Chat entry point is `<PANE_DIR>/skills/pane-chat/pane-orchestrator/SKILL.md`; read the skill that matches the request, such as `discussion`, `create-ticket`, `tdd`, `prepare-pr`, or `review`.",
-                "When an agent creates Panes or panels, pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved; `panes create` pins the new Pane into the UI's favorite/pin set by default, so no follow-up `panes pin` call is needed and `--no-pinned` is the opt-out for throwaway Panes.",
-                "Use `runpane agent-context --json` for the full agent-facing CLI context, or `runpane agent-context --command <command> --json` for one detailed command definition.",
-                "For `agent-context --command`, use canonical spaced names like `panes create`; copied forms like `panes.create` or `runpane panes create` are accepted too.",
-                "Use `runpane repos list --json` to find the saved repository when unsure after doctor shows the daemon is reachable.",
-                "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`.",
-                "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.",
-                "Use `runpane agents doctor --agent <codex|claude|cursor> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.",
-                "Use `runpane panes create --wait-ready` to create Panes, wait for each agent's input box, and verify its starting message in one call.",
-                "Use `runpane panels screen` for compact current state, including Claude and Codex composer state. Use `panels wait` for create-time readiness or text checks. Use `runpane watch --follow` to block on workspace transitions (READY, BLOCKED, IDLE, STUCK, EXIT) without polling, or `runpane watch --until-event` to exit on the first one. Use `panels submit` to send and submit a new turn. Use `panels submit-composer --strategy auto` only for a composer that was filled separately.",
+        },
+        "loopInput": {
+            "type": "object",
+            "required": [
+                "name",
+                "cron",
+                "enabled"
+            ],
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "name": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "projectId": {
+                    "type": "number"
+                },
+                "orchestrationSessionId": {
+                    "type": "string"
+                },
+                "cron": {
+                    "type": "string"
+                },
+                "agent": {
+                    "enum": [
+                        "claude",
+                        "codex",
+                        "cursor"
+                    ]
+                },
+                "toolCommand": {
+                    "type": "string"
+                },
+                "initialInput": {
+                    "type": "string"
+                },
+                "worktreeTemplate": {
+                    "type": "string"
+                },
+                "enabled": {
+                    "type": "boolean"
+                }
+            },
+            "additionalProperties": false
+        },
+        "loop": {
+            "type": "object",
+            "required": [
+                "id",
+                "name",
+                "cron",
+                "enabled",
+                "createdAtMs",
+                "nextRunAtMs",
+                "scheduleText",
+                "runs"
+            ],
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "name": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "projectId": {
+                    "type": "number"
+                },
+                "orchestrationSessionId": {
+                    "type": "string"
+                },
+                "cron": {
+                    "type": "string"
+                },
+                "agent": {
+                    "enum": [
+                        "claude",
+                        "codex",
+                        "cursor"
+                    ]
+                },
+                "toolCommand": {
+                    "type": "string"
+                },
+                "initialInput": {
+                    "type": "string"
+                },
+                "worktreeTemplate": {
+                    "type": "string"
+                },
+                "enabled": {
+                    "type": "boolean"
+                },
+                "createdAtMs": {
+                    "type": "number"
+                },
+                "nextRunAtMs": {
+                    "type": [
+                        "number",
+                        "null"
+                    ]
+                },
+                "scheduleText": {
+                    "type": "string"
+                },
+                "runs": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "id",
+                            "loopId",
+                            "slotAtMs",
+                            "trigger",
+                            "status",
+                            "error",
+                            "sessionId"
+                        ],
+                        "properties": {
+                            "id": {
+                                "type": "string"
+                            },
+                            "loopId": {
+                                "type": "string"
+                            },
+                            "slotAtMs": {
+                                "type": "number"
+                            },
+                            "trigger": {
+                                "enum": [
+                                    "schedule",
+                                    "manual"
+                                ]
+                            },
+                            "status": {
+                                "enum": [
+                                    "started",
+                                    "failed",
+                                    "skipped"
+                                ]
+                            },
+                            "error": {
+                                "type": [
+                                    "string",
+                                    "null"
+                                ]
+                            },
+                            "sessionId": {
+                                "type": [
+                                    "string",
+                                    "null"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "loopListResult": {
+            "type": "object",
+            "required": [
+                "ok",
+                "loops"
+            ],
+            "properties": {
+                "ok": {
+                    "const": true
+                },
+                "loops": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/jsonSchemas/loop"
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "loopResult": {
+            "type": "object",
+            "required": [
+                "ok",
+                "loop"
+            ],
+            "properties": {
+                "ok": {
+                    "const": true
+                },
+                "loop": {
+                    "$ref": "#/jsonSchemas/loop"
+                }
+            },
+            "additionalProperties": false
+        },
+        "loopDryRunResult": {
+            "type": "object",
+            "required": [
+                "ok",
+                "dryRun",
+                "input",
+                "scheduleText",
+                "nextRunAtMs"
+            ],
+            "properties": {
+                "ok": {
+                    "const": true
+                },
+                "dryRun": {
+                    "const": true
+                },
+                "input": {
+                    "$ref": "#/jsonSchemas/loopInput"
+                },
+                "scheduleText": {
+                    "type": "string"
+                },
+                "nextRunAtMs": {
+                    "type": "number"
+                }
+            },
+            "additionalProperties": false
+        },
+        "loopDeleteResult": {
+            "type": "object",
+            "required": [
+                "ok",
+                "deleted"
+            ],
+            "properties": {
+                "ok": {
+                    "const": true
+                },
+                "deleted": {
+                    "type": "string"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "agentContext": {
+        "brief": {
+            "title": "Pane agent context",
+            "summary": "Pane lets a developer manage saved base repositories, user-visible Panes (Pane sessions) for feature/PR work, and terminal-backed panel tabs. A Pane is a visible workspace that normally maps to one Pane-managed git worktree and branch; a panel is a terminal tab inside one Pane and shares that Pane's worktree; an agent is a CLI process running inside a panel.",
+            "rules": [
+                "Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.",
+                "In a Pane repository checkout, if `runpane` is not on PATH, build the local wrapper with `pnpm --filter runpane build` and run it with patched Node 22.23.4+ (22.x), 24.22.1+ (24.x), or 26.12.1+ (26.x), for example `node packages/runpane/dist/cli.js doctor --json`.",
+                "Happy path for any user request to use Pane/RunPane: run `runpane doctor --json`, read `runpane agent-context --json`, resolve or add the saved base repo, then route by the rule 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane: if the work's branch already has a Pane (find it with `runpane panes list --repo <repo> --json` by matching the PR's head branch against `git -C <worktreePath> branch --show-current`), open a new agent tab in it with `runpane panels create --pane <id> --agent <agent> --initial-input \"<task>\" --source agent --no-focus --wait-ready --yes --json`; only when the branch has no Pane yet, create one with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json` (the new Pane is pinned by default; add `--no-pinned` for a throwaway Pane, add `--base-branch <ref>` to branch from something other than the repository default, or use `--tool-command <command>` instead of `--agent <agent>`), then validate with `panels wait` or `panels screen`. For long-lived supervision, use `runpane watch --follow` instead of polling wait or screen.",
+                "Treat Pane as the user's visible cockpit for watching/co-driving work. Do not create Panes or panels for private delegation unless the user asked for visible Pane orchestration or the result should appear in the Pane app.",
+                "Register the saved base repository once with `repos add`; do not register a pre-created worktree as a separate repo unless the user explicitly asks.",
+                "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Use `panes create` only when the work's branch has no Pane yet (new work, or an existing PR with no Pane), since each new Pane creates a worktree. Every later agent for that branch opens as a new tab in its Pane with `panels create --pane <id>`, never a new Pane. Tabs share one checkout: only the implementer changes the branch or HEAD, one writer at a time; review, audit and QA tabs never run `git checkout`, `reset` or `stash`.",
+                "For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.",
+                "Skill routing: Pane's skills live in `<PANE_DIR>/skills/pane-chat/skills/`, and the Pane Chat entry point is `<PANE_DIR>/skills/pane-chat/pane-orchestrator/SKILL.md`; read the skill that matches the request, such as `discussion`, `create-ticket`, `tdd`, `prepare-pr`, or `review`.",
+                "When an agent creates Panes or panels, pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved; `panes create` pins the new Pane into the UI's favorite/pin set by default, so no follow-up `panes pin` call is needed and `--no-pinned` is the opt-out for throwaway Panes.",
+                "Use `runpane agent-context --json` for the full agent-facing CLI context, or `runpane agent-context --command <command> --json` for one detailed command definition.",
+                "For `agent-context --command`, use canonical spaced names like `panes create`; copied forms like `panes.create` or `runpane panes create` are accepted too.",
+                "Use `runpane repos list --json` to find the saved repository when unsure after doctor shows the daemon is reachable.",
+                "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`.",
+                "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.",
+                "Use `runpane agents doctor --agent <codex|claude|cursor> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.",
+                "Use `runpane panes create --wait-ready` to create Panes, wait for each agent's input box, and verify its starting message in one call.",
+                "Use `runpane panels screen` for compact current state, including Claude and Codex composer state. Use `panels wait` for create-time readiness or text checks. Use `runpane watch --follow` to block on workspace transitions (READY, BLOCKED, IDLE, STUCK, EXIT) without polling, or `runpane watch --until-event` to exit on the first one. Use `panels submit` to send and submit a new turn. Use `panels submit-composer --strategy auto` only for a composer that was filled separately.",
                 "Use `runpane panels input` only when exact bytes are required, such as Ctrl-C or handcrafted terminal input.",
                 "Pane terminals draw inline images: sixel, iTerm2 inline images, and the kitty graphics protocol. Tools that need kitty graphics, such as terminal-browser and terminal-doom, run inside a Pane panel; `runpane doctor --json` reports the exact list under `terminal.graphicsProtocols`.",
                 "After creating Panes or sending terminal input, validate with `panels wait` or bounded `panels screen`. For a harness that consumes streaming output, use `runpane watch --follow` (with `--session <id>` for a Session); its named consumer applies settling and batching. Adding numeric --since leaves it unnamed and bypasses cadence; --as cannot be combined with --since. A harness that wakes only when a process exits uses `runpane watch --as <name> --until-event --json` and runs it again after each event. Single-event waits deliver immediately without follow cadence. Never pipe `--follow` into `grep -m1` or `head`.",
-                "When several agents share one resource, such as a test account, name a lock in their prompts: each worker runs `runpane lock acquire --name <name> --ttl 30m --wait 1800000 --json` before using it and `runpane lock release --name <name>` after."
+                "When several agents share one resource, such as a test account, name a lock in their prompts: each worker runs `runpane lock acquire --name <name> --ttl 30m --wait 1800000 --json` before using it and `runpane lock release --name <name>` after.",
+                "Loops (`runpane loops create`) run a task on a cron schedule, each run in a new Pane or, with `--session`, as a message to a Session's agent. They are for large recurring jobs, such as a nightly bug sweep, and run at most once an hour. For a short wait, use your agent harness's own sleep and wake instead."
             ],
             "detailCommand": "runpane agent-context --command <command> [--json]",
             "tools": [
@@ -12271,7 +13022,7 @@ exports.RUNPANE_CONTRACT = {
                         "name": "--toolsets",
                         "value": "<name,...>",
                         "required": false,
-                        "description": "Comma-separated toolsets to serve: core (default), all, read, repos, panes, panels, agents, sessions, git, docs, links, admin."
+                        "description": "Comma-separated toolsets to serve: core (default), all, read, repos, panes, panels, agents, sessions, loops, git, docs, links, admin."
                     },
                     {
                         "name": "--read-only",
@@ -16100,6 +16851,391 @@ exports.RUNPANE_CONTRACT = {
                 "notes": [
                     "Unknown ids are reported under `unknown`; acknowledging twice is harmless."
                 ]
+            },
+            "loops list": {
+                "name": "loops list",
+                "summary": "List loops (scheduled tasks) with their schedule, next run, and recent runs.",
+                "details": "Lists every loop: its id, target (projectId for a repo, or orchestrationSessionId for a Session), cron and scheduleText, enabled, nextRunAtMs (null while paused), and its newest runs. A run's sessionId is its Pane (null for a Session loop's runs); read its progress with `runpane agents status --pane <id>`.",
+                "requiresPaneDaemon": true,
+                "mutates": false,
+                "arguments": [
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops list --json"
+                ],
+                "jsonSchemas": [
+                    "loopListResult"
+                ],
+                "notes": [
+                    "Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake."
+                ]
+            },
+            "loops create": {
+                "name": "loops create",
+                "summary": "Create a loop: a cron schedule that starts a new Pane in a fresh worktree for each run, or sends a prompt to a Session's agent. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "details": "With --repo, each run is a new Pane in a fresh worktree branched from the repo's default base branch, started like `runpane panes create` with the agent or command and prompt given here. With --session, each run sends the prompt to that Session's agent instead of creating a Pane; a Session loop needs --agent and --prompt and takes no --tool-command. `new` creates a Session named after the loop. The Session's agent then skips permission prompts for every message it gets, not only loop runs. Runs start only while Pane is running, in the host's local time zone. A run up to 15 minutes late still starts; a later one is recorded as skipped and never caught up. Runs may overlap. Unattended agent runs skip permission prompts. Pane keeps each loop's last 10 run Panes and archives older ones.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--repo",
+                        "value": "<selector>",
+                        "required": false,
+                        "description": "Repository: active, id, exact path, or saved repository name. Each run is a new Pane in it. Pass this or --session."
+                    },
+                    {
+                        "name": "--session",
+                        "value": "<id|name|new>",
+                        "required": false,
+                        "description": "Session whose agent gets the prompt each run, by id or name, instead of a new Pane. `new` creates a Session named after the loop. The Session's agent then skips permission prompts for every message it gets, not only loop runs. Pass this or --repo."
+                    },
+                    {
+                        "name": "--name",
+                        "value": "<name>",
+                        "required": true,
+                        "description": "Loop name."
+                    },
+                    {
+                        "name": "--cron",
+                        "value": "<expr>",
+                        "required": true,
+                        "description": "Five-field cron in the host's local time zone, such as \"0 3 * * *\" (every day at 03:00). Runs must be at least 60 minutes apart."
+                    },
+                    {
+                        "name": "--agent",
+                        "value": "<claude|codex|cursor>",
+                        "required": false,
+                        "description": "Agent each run starts; for a Session loop, the Session's agent. Pass this or --tool-command."
+                    },
+                    {
+                        "name": "--tool-command",
+                        "value": "<command>",
+                        "required": false,
+                        "description": "Command each run starts instead of a built-in agent, such as `./scripts/nightly-report.sh` or `pnpm test`. Project loops only. On Windows it runs in Pane's terminal shell, Git Bash by default: write bash, or `cmd //c echo hi > loop.txt` rather than `cmd /c`."
+                    },
+                    {
+                        "name": "--prompt",
+                        "value": "<text>",
+                        "required": false,
+                        "description": "Text typed into the agent or command after it starts; for a Session loop, the message sent to the Session's agent each run."
+                    },
+                    {
+                        "name": "--prompt-file",
+                        "value": "<path|->",
+                        "required": false,
+                        "description": "Read the prompt from a file or stdin."
+                    },
+                    {
+                        "name": "--worktree-name",
+                        "value": "<template>",
+                        "required": false,
+                        "description": "Worktree and branch name template; defaults to loop-<name>. Project loops only."
+                    },
+                    {
+                        "name": "--paused",
+                        "required": false,
+                        "description": "Create the loop paused."
+                    },
+                    {
+                        "name": "--dry-run",
+                        "required": false,
+                        "description": "Check the cron and print the loop that would be saved, with its schedule and next run, without saving."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops create --repo active --name nightly-bug-sweep --cron \"0 3 * * *\" --agent claude --prompt \"Fix one bug from yesterday's issues\" --yes --json",
+                    "runpane loops create --repo <repo> --name dependency-check --cron \"0 9 * * 1\" --tool-command \"pnpm test\" --yes --json",
+                    "runpane loops create --session new --name morning-triage --cron \"0 9 * * 1-5\" --agent claude --prompt \"Triage the new issues\" --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopInput",
+                    "loopResult",
+                    "loopDryRunResult"
+                ],
+                "notes": [
+                    "Saving rejects a cron whose runs fall less than 60 minutes apart. Check one first with --dry-run."
+                ]
+            },
+            "loops update": {
+                "name": "loops update",
+                "summary": "Change a loop's repo or Session, name, schedule, agent or command, prompt, or worktree template. Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake.",
+                "details": "Reads the loop, replaces the values you pass, and saves it. Passing --agent clears --tool-command and the other way round; --repo and --session replace each other the same way. Pause and resume with `loops pause` and `loops resume`. Runs start only while Pane is running, in the host's local time zone. A run up to 15 minutes late still starts; a later one is recorded as skipped and never caught up. Runs may overlap. Unattended agent runs skip permission prompts. Pane keeps each loop's last 10 run Panes and archives older ones.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--loop",
+                        "value": "<id>",
+                        "required": true,
+                        "description": "Loop id, from `runpane loops list`."
+                    },
+                    {
+                        "name": "--repo",
+                        "value": "<selector>",
+                        "required": false,
+                        "description": "Repository: active, id, exact path, or saved repository name. Each run is a new Pane in it. Pass this or --session."
+                    },
+                    {
+                        "name": "--session",
+                        "value": "<id|name|new>",
+                        "required": false,
+                        "description": "Session whose agent gets the prompt each run, by id or name, instead of a new Pane. `new` creates a Session named after the loop. The Session's agent then skips permission prompts for every message it gets, not only loop runs. Pass this or --repo."
+                    },
+                    {
+                        "name": "--name",
+                        "value": "<name>",
+                        "required": false,
+                        "description": "Loop name."
+                    },
+                    {
+                        "name": "--cron",
+                        "value": "<expr>",
+                        "required": false,
+                        "description": "Five-field cron in the host's local time zone, such as \"0 3 * * *\" (every day at 03:00). Runs must be at least 60 minutes apart."
+                    },
+                    {
+                        "name": "--agent",
+                        "value": "<claude|codex|cursor>",
+                        "required": false,
+                        "description": "Agent each run starts; for a Session loop, the Session's agent. Pass this or --tool-command."
+                    },
+                    {
+                        "name": "--tool-command",
+                        "value": "<command>",
+                        "required": false,
+                        "description": "Command each run starts instead of a built-in agent, such as `./scripts/nightly-report.sh` or `pnpm test`. Project loops only. On Windows it runs in Pane's terminal shell, Git Bash by default: write bash, or `cmd //c echo hi > loop.txt` rather than `cmd /c`."
+                    },
+                    {
+                        "name": "--prompt",
+                        "value": "<text>",
+                        "required": false,
+                        "description": "Text typed into the agent or command after it starts; for a Session loop, the message sent to the Session's agent each run."
+                    },
+                    {
+                        "name": "--prompt-file",
+                        "value": "<path|->",
+                        "required": false,
+                        "description": "Read the prompt from a file or stdin."
+                    },
+                    {
+                        "name": "--worktree-name",
+                        "value": "<template>",
+                        "required": false,
+                        "description": "Worktree and branch name template; defaults to loop-<name>. Project loops only."
+                    },
+                    {
+                        "name": "--dry-run",
+                        "required": false,
+                        "description": "Check the cron and print the loop that would be saved, with its schedule and next run, without saving."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops update --loop <loop-id> --cron \"0 4 * * *\" --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopInput",
+                    "loopResult",
+                    "loopDryRunResult"
+                ],
+                "notes": []
+            },
+            "loops run": {
+                "name": "loops run",
+                "summary": "Start a run of a loop now. The schedule stays the same.",
+                "details": "Starts a run now, as a new Pane or a message to the loop's Session, even while the loop is paused or another run is still going. The schedule stays the same, and the run counts toward the 10 kept runs.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--loop",
+                        "value": "<id>",
+                        "required": true,
+                        "description": "Loop id, from `runpane loops list`."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops run --loop <loop-id> --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopResult"
+                ],
+                "notes": [
+                    "The result is the loop; `runs[0]` is the new run, with `status` started or failed and `sessionId` its Pane (null for a Session loop).",
+                    "Loops are for large recurring jobs and run at most once an hour; for short waits, use your agent harness's own sleep and wake."
+                ]
+            },
+            "loops pause": {
+                "name": "loops pause",
+                "summary": "Pause a loop: it starts no scheduled runs until resumed.",
+                "details": "A paused loop starts no scheduled runs. `loops run` still starts one by hand.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--loop",
+                        "value": "<id>",
+                        "required": true,
+                        "description": "Loop id, from `runpane loops list`."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops pause --loop <loop-id> --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopResult"
+                ],
+                "notes": []
+            },
+            "loops resume": {
+                "name": "loops resume",
+                "summary": "Resume a paused loop from its next scheduled time.",
+                "details": "Runs resume at the next scheduled time. Runs missed while paused are not caught up.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--loop",
+                        "value": "<id>",
+                        "required": true,
+                        "description": "Loop id, from `runpane loops list`."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops resume --loop <loop-id> --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopResult"
+                ],
+                "notes": []
+            },
+            "loops delete": {
+                "name": "loops delete",
+                "summary": "Delete a loop. It starts no more runs.",
+                "details": "Deletes the loop and its schedule.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--loop",
+                        "value": "<id>",
+                        "required": true,
+                        "description": "Loop id, from `runpane loops list`."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": true,
+                        "description": "Confirm the change."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    },
+                    {
+                        "name": "--pane-dir",
+                        "value": "<path>",
+                        "required": false,
+                        "description": "Connect to a specific Pane data directory."
+                    }
+                ],
+                "examples": [
+                    "runpane loops delete --loop <loop-id> --yes --json"
+                ],
+                "jsonSchemas": [
+                    "loopDeleteResult"
+                ],
+                "notes": []
             }
         },
         "managedBlock": [