@skrr-ai/cli 0.1.129 → 0.1.131

package/oclif.manifest.json

@@ -1175,7 +1175,7 @@
           "type": "option"
         },
         "delay-minutes": {
-          "description": "Minutes from now to fire — required when --kind=self_scheduled. Range: 5..43200 (5min..30d).",
+          "description": "Minutes from now to fire — required when --kind=self_scheduled. Range: 5..1440 (5 minutes..24 hours).",
           "name": "delay-minutes",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -15105,7 +15105,7 @@
           "type": "boolean"
         },
         "date": {
-          "description": "Plan date (YYYY-MM-DD). Defaults to today.",
+          "description": "Plan date (YYYY-MM-DD). Defaults to today in the plan timezone.",
           "name": "date",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -17833,7 +17833,7 @@
           "type": "option"
         },
         "max-fires-per-day": {
-          "description": "Agent initiative daily fire cap",
+          "description": "Daily cap on how often this agent can wake itself: its Task returns and self_scheduled triggers, whatever cap they carry",
           "name": "max-fires-per-day",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -41481,7 +41481,7 @@
         "daemons:byok"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd byok` unchanged, so they are not listed here — run `skrrd byok --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd byok` unchanged, so they are not listed here — run `skrrd byok --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon byok status",
         "<%= config.bin %> daemon byok status --json",
@@ -41511,7 +41511,7 @@
         "daemons:config"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd config` unchanged, so they are not listed here — run `skrrd config --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd config` unchanged, so they are not listed here — run `skrrd config --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon config --mode bash=manual",
         "<%= config.bin %> daemon config --mode bash=auto --mode browser=auto",
@@ -41540,7 +41540,7 @@
         "daemons:diagnostics"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd diagnostics` unchanged, so they are not listed here — run `skrrd diagnostics --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd diagnostics` unchanged, so they are not listed here — run `skrrd diagnostics --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon diagnostics",
         "<%= config.bin %> daemon diagnostics --lines 1000",
@@ -41570,7 +41570,7 @@
         "daemons:install"
       ],
       "args": {},
-      "description": "If the background service is not on this computer yet, this command first fetches the signed release. After it is installed, flags are forwarded to `skrrd install` unchanged; run `skrrd install --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. `--server` and `--profile` are filled in from your CLI session unless you pass them.",
+      "description": "If the background service is not on this computer yet, this command first fetches the signed release. After it is installed, flags are forwarded to `skrrd install` unchanged; run `skrrd install --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux). `--server` and `--profile` are filled in from your CLI session unless you pass them.",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -41594,7 +41594,7 @@
         "daemons:login"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd login` unchanged, so they are not listed here — run `skrrd login --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. `--server` and `--profile` are filled in from your CLI session unless you pass them.\nUse --computer-use to request explicit Computer Use permission in browser consent. This does not enable the runtime or grant machine access.",
+      "description": "Flags are forwarded to `skrrd login` unchanged, so they are not listed here — run `skrrd login --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux). `--server` and `--profile` are filled in from your CLI session unless you pass them.\nUse --computer-use to request explicit Computer Use permission in browser consent. This does not enable the runtime or grant machine access.",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42078,7 +42078,7 @@
         "daemons:recover-offline-queue"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd recover-offline-queue` unchanged, so they are not listed here — run `skrrd recover-offline-queue --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd recover-offline-queue` unchanged, so they are not listed here — run `skrrd recover-offline-queue --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42102,7 +42102,7 @@
         "daemons:restart"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd restart` unchanged, so they are not listed here — run `skrrd restart --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd restart` unchanged, so they are not listed here — run `skrrd restart --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon restart",
         "<%= config.bin %> daemon restart --profile work"
@@ -42130,7 +42130,7 @@
         "daemons:start"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd start` unchanged, so they are not listed here — run `skrrd start --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd start` unchanged, so they are not listed here — run `skrrd start --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42154,7 +42154,7 @@
         "daemons:status"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd status` unchanged, so they are not listed here — run `skrrd status --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd status` unchanged, so they are not listed here — run `skrrd status --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42178,7 +42178,7 @@
         "daemons:stop"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd stop` unchanged, so they are not listed here — run `skrrd stop --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd stop` unchanged, so they are not listed here — run `skrrd stop --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42202,7 +42202,7 @@
         "daemons:uninstall"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd uninstall` unchanged, so they are not listed here — run `skrrd uninstall --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd uninstall` unchanged, so they are not listed here — run `skrrd uninstall --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
@@ -42226,7 +42226,7 @@
         "daemons:unlock"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd unlock` unchanged, so they are not listed here — run `skrrd unlock --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd unlock` unchanged, so they are not listed here — run `skrrd unlock --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon unlock"
       ],
@@ -42253,7 +42253,7 @@
         "daemons:update"
       ],
       "args": {},
-      "description": "Flags are forwarded to `skrrd update` unchanged, so they are not listed here — run `skrrd update --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`.",
+      "description": "Flags are forwarded to `skrrd update` unchanged, so they are not listed here — run `skrrd update --help` for this verb's own flags, or `skrrd --help` for global ones such as `--profile`. If `skrrd` is not on your PATH, use its installed path instead (typically `~/.skrr/bin/skrrd` on macOS and Linux).",
       "examples": [
         "<%= config.bin %> daemon update",
         "<%= config.bin %> daemon update --check",
@@ -54487,12 +54487,14 @@
     "harnesses:prune": {
       "aliases": [],
       "args": {},
-      "description": "A machine registers a fresh row per provider each time its daemon identity changes (a profile, a working directory, a service versus a terminal), and the old rows stay. This removes the ones that are provably stale and shows every one it keeps, with the reason.\n\nIt is a DRY RUN until you pass --yes. A row is removed only if ALL of these hold: it is yours; it is a daemon you run yourself (never a hosted, dedicated or cloud machine); it is not online and has not been seen within --older-than; a later row of the same provider on the same machine replaced it AND that replacement is online now; and nothing depends on it - no agent (yours or anyone's) is pinned to it, no workspace has it lent, it is not your default, and you did not give it a name.\n\nAn agent pinned to a replaced row keeps running only because the platform adopts the live row beside it, and that adoption starts from the old row; remove the row and the pin is gone. So a pinned row is KEPT, with the agents named. Move the pin (`agents attach-harness`) and run this again.\n\nAt most --limit rows are removed per run, oldest first; the rest are counted and the next run takes them. Running it again when nothing qualifies removes nothing. A daemon that is still running re-registers on its next connection, so removing a row never stops a machine.",
+      "description": "A machine registers a fresh row per provider each time its daemon identity changes (a profile, a working directory, a service versus a terminal), and the old rows stay. This removes the ones that are provably stale and shows every one it keeps, with the reason.\n\nIt is a DRY RUN until you pass --yes. A row is removed only if ALL of these hold: it is yours; it is a daemon you run yourself (never a hosted, dedicated or cloud machine); it is not online and has not been seen within --older-than; a later row of the same provider on the same machine replaced it AND that replacement is online now; and nothing depends on it - no agent (yours or anyone's) is pinned to it, no workspace has it lent, it is not your default, and you did not give it a name.\n\nAn agent pinned to a replaced row keeps running only because the platform adopts the live row beside it, and that adoption starts from the old row; remove the row and the pin is gone. So a pinned row is KEPT, with the agents named. Move the pin (`agents attach-harness`) and run this again.\n\nAt most --limit rows are removed per run, oldest first; the rest are counted and the next run takes them. Running it again when nothing qualifies removes nothing. A daemon that is still running re-registers on its next connection, so removing a row never stops a machine.\n\nA hosted, dedicated or cloud machine belongs to its lease, so by default it is never touched. --include-gone-leases also considers the rows of such a machine whose lease is GONE (archived, terminating, terminated, failed or lost): no compute runs on it again, so the row can never come back online. A row with no lease, a lease that can come back (stopped, ready, active) and a row with usage recorded against it are kept, and so is everything the rules above keep. Use --older-than to leave recent ones, for example 30d.",
       "examples": [
         "<%= config.bin %> harnesses prune",
         "<%= config.bin %> harnesses prune --yes",
         "<%= config.bin %> harnesses prune --yes --limit 20",
-        "<%= config.bin %> harnesses prune --older-than 7d --json"
+        "<%= config.bin %> harnesses prune --older-than 7d --json",
+        "<%= config.bin %> harnesses prune --include-gone-leases --older-than 30d",
+        "<%= config.bin %> harnesses prune --include-gone-leases --older-than 30d --yes --limit 200"
       ],
       "flags": {
         "bare": {
@@ -54548,6 +54550,12 @@
           "multiple": false,
           "type": "option"
         },
+        "include-gone-leases": {
+          "description": "Also consider the rows of hosted, dedicated or cloud machines whose lease is gone. Off by default.",
+          "name": "include-gone-leases",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Output as JSON",
           "name": "json",
@@ -75978,10 +75986,11 @@
     "northstars:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a northstar (the portfolio layer above commitments)",
+      "description": "Create a northstar (the portfolio layer above commitments)\n\nThe northstar is created in the workspace the global --workspace <id> flag names, or the one chosen once with `workspaces use`. With neither, or for a workspace you are not a member of, it is personal (no workspace), and the output says so. The Skrr web Northstars list shows only the active workspace's Northstars, so a personal one is hidden there while a workspace is active. An Agent session always uses its own session workspace, and --workspace does not change it.",
       "examples": [
         "<%= config.bin %> northstars create --title \"Reach $10M ARR\"",
-        "<%= config.bin %> northstars create --title \"Reliability\" --tier critical --max-active 5 --review-interval-hours 24"
+        "<%= config.bin %> northstars create --title \"Reliability\" --tier critical --max-active 5 --review-interval-hours 24",
+        "<%= config.bin %> northstars create --title \"Reliability\" --workspace <workspace-id>"
       ],
       "flags": {
         "bare": {
@@ -76957,7 +76966,7 @@
     "northstars:list": {
       "aliases": [],
       "args": {},
-      "description": "List northstars (the portfolio layer above commitments)",
+      "description": "List northstars (the portfolio layer above commitments)\n\nThe WORKSPACE column is a shortened workspace id (--json has the full workspaceId) or \"personal\". A northstar belongs to the workspace it was created in, or is \"personal\" when it has none. The Skrr web Northstars list shows only the active workspace's Northstars, so a personal one is hidden there while a workspace is active.",
       "examples": [
         "<%= config.bin %> northstars list",
         "<%= config.bin %> northstars list --status active",
@@ -77573,7 +77582,7 @@
           "required": true
         }
       },
-      "description": "Show a northstar, its linked commitments, and open recommendations",
+      "description": "Show a northstar, its linked commitments, and open recommendations\n\nThe Workspace line is the full workspace id, or \"personal\". A northstar belongs to the workspace it was created in, or is \"personal\" when it has none. The Skrr web Northstars list shows only the active workspace's Northstars, so a personal one is hidden there while a workspace is active.",
       "examples": [
         "<%= config.bin %> northstars show nst_abc123",
         "<%= config.bin %> northstars show nst_abc123 --json"
@@ -124592,7 +124601,7 @@
           "required": true
         }
       },
-      "description": "Pause future recurring runs; current runs and already queued work are unchanged",
+      "description": "Pause future recurring runs; current runs and already queued work are unchanged. A run that comes due while paused is skipped, not replayed, when you resume",
       "examples": [
         "<%= config.bin %> tasks pause-schedule <task-id>",
         "<%= config.bin %> tasks pause-schedule <task-id> --json"
@@ -127145,7 +127154,7 @@
           "required": true
         }
       },
-      "description": "Resume a paused recurring task — server re-computes the next fire from the cron pattern",
+      "description": "Resume a paused recurring task. A run that came due while it was paused is skipped (not replayed); the next run comes from the cron pattern",
       "examples": [
         "<%= config.bin %> tasks resume-schedule <task-id>",
         "<%= config.bin %> tasks resume-schedule <task-id> --json"
@@ -128452,6 +128461,7 @@
       "examples": [
         "<%= config.bin %> tasks self-schedule <task-id> --in 2h --note \"check whether the deploy settled\"",
         "<%= config.bin %> tasks self-schedule <task-id> --at 2026-09-09T14:00:00Z",
+        "<%= config.bin %> tasks self-schedule <task-id> --in 90m --re-enable",
         "<%= config.bin %> tasks self-schedule <task-id> --show",
         "<%= config.bin %> tasks self-schedule <task-id> --clear"
       ],
@@ -128496,14 +128506,14 @@
           "type": "boolean"
         },
         "at": {
-          "description": "Absolute return time (ISO-8601 UTC)",
+          "description": "Absolute return time: ISO-8601 with a UTC offset, such as 2026-11-05T10:00:00Z or 2026-11-05T10:00:00-08:00",
           "name": "at",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "in": {
-          "description": "Relative return time such as 90m, 2h, 3d",
+          "description": "Relative return time: a number with a unit (s, m, h, d), such as 90m, 1.5h or 3d. A bare number means minutes. At least 60s, at most 14 days",
           "name": "in",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -128517,12 +128527,18 @@
           "type": "option"
         },
         "max-per-day": {
-          "description": "Cap on self-initiated returns per day (1-24, default 4)",
+          "description": "Cap on self-initiated returns per day (1-24). Omit to keep the cap this task already has (4 for a task that never had one)",
           "name": "max-per-day",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "re-enable": {
+          "description": "Switch the task's return back on if it was turned off, then park it. Without this a switched-off return is left off and the park is refused. A person may; an agent only where its initiative policy allows autonomous loops",
+          "name": "re-enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "show": {
           "description": "Print the pending return without changing it",
           "name": "show",
@@ -143154,5 +143170,5 @@
       ]
     }
   },
-  "version": "0.1.129"
+  "version": "0.1.131"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/cli",
-  "version": "0.1.129",
+  "version": "0.1.131",
   "description": "Command-line interface for skrr",
   "license": "ISC",
   "author": "skrr",