runpane 2.4.174 → 2.4.176
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agentTasks.d.ts +5 -1
- package/dist/agentTasks.d.ts.map +1 -1
- package/dist/agentTasks.js +51 -7
- package/dist/agentTasks.js.map +1 -1
- package/dist/daemonClient.d.ts.map +1 -1
- package/dist/daemonClient.js +7 -2
- package/dist/daemonClient.js.map +1 -1
- package/dist/docs-index.json +1 -1
- package/dist/generated/contract.d.ts +58 -45
- package/dist/generated/contract.d.ts.map +1 -1
- package/dist/generated/contract.js +67 -46
- package/dist/generated/contract.js.map +1 -1
- package/dist/handoff.d.ts.map +1 -1
- package/dist/handoff.js +81 -23
- package/dist/handoff.js.map +1 -1
- package/dist/localControl.d.ts +54 -0
- package/dist/localControl.d.ts.map +1 -1
- package/dist/localControl.js +8 -7
- package/dist/localControl.js.map +1 -1
- package/dist/mcp.d.ts.map +1 -1
- package/dist/mcp.js +2 -1
- package/dist/mcp.js.map +1 -1
- package/dist/workspace.d.ts +10 -1
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +54 -16
- package/dist/workspace.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB
|
|
1
|
+
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4lbnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC"}
|
|
@@ -305,7 +305,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
305
305
|
},
|
|
306
306
|
{
|
|
307
307
|
"name": "workspace list",
|
|
308
|
-
"summary": "List
|
|
308
|
+
"summary": "List the machines on your tailnet, each with its owner, and whether each answers workspaces.",
|
|
309
309
|
"usage": [
|
|
310
310
|
"runpane workspace list [--json] [--pane-dir <path>]"
|
|
311
311
|
],
|
|
@@ -340,7 +340,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
340
340
|
},
|
|
341
341
|
{
|
|
342
342
|
"name": "workspace read",
|
|
343
|
-
"summary": "Print a file from
|
|
343
|
+
"summary": "Print a file from a machine on your tailnet; any path form works (C:\\..., /mnt/c/..., /home/..., ~/...).",
|
|
344
344
|
"usage": [
|
|
345
345
|
"runpane workspace [<machine>] read <path> [--json]"
|
|
346
346
|
],
|
|
@@ -351,7 +351,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
351
351
|
},
|
|
352
352
|
{
|
|
353
353
|
"name": "workspace write",
|
|
354
|
-
"summary": "Write stdin to a file on
|
|
354
|
+
"summary": "Write stdin to a file on a machine on your tailnet, creating parent folders.",
|
|
355
355
|
"usage": [
|
|
356
356
|
"runpane workspace [<machine>] write <path> [--json]"
|
|
357
357
|
],
|
|
@@ -403,7 +403,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
403
403
|
},
|
|
404
404
|
{
|
|
405
405
|
"name": "panes create",
|
|
406
|
-
"summary": "Create
|
|
406
|
+
"summary": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Create a Pane (a new worktree) only when the work's branch has no Pane yet; for review, audit, fix or QA on existing work use `panels create --pane <id>`.",
|
|
407
407
|
"usage": [
|
|
408
408
|
"runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--base <ref>] [--branch <name>] [--prompt-file <path|->] [options] [--pane-dir <path>]",
|
|
409
409
|
"runpane panes create --repo <selector> --name <name> --tool-command <command> [--agent <codex|claude|cursor>] [--source user|agent] [--focus|--no-focus] [--base <ref>] [--branch <name>] [--prompt-file <path|->] [options] [--pane-dir <path>]",
|
|
@@ -528,7 +528,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
528
528
|
},
|
|
529
529
|
{
|
|
530
530
|
"name": "panels create",
|
|
531
|
-
"summary": "
|
|
531
|
+
"summary": "Open a new agent or terminal tab inside an existing Pane, sharing its worktree. The default for review, QA, fixes and any other agent on work that already has a Pane.",
|
|
532
532
|
"usage": [
|
|
533
533
|
"runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready] --yes [--json] [--pane-dir <path>]",
|
|
534
534
|
"runpane panels create --pane <pane-id> --tool-command <command> [--agent <codex|claude|cursor>] [--title <title>] [--focus|--no-focus] [--wait-ready] --yes [--json] [--pane-dir <path>]"
|
|
@@ -536,6 +536,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
536
536
|
"mutates": true,
|
|
537
537
|
"additive": true,
|
|
538
538
|
"toolsets": [
|
|
539
|
+
"core",
|
|
539
540
|
"panels"
|
|
540
541
|
],
|
|
541
542
|
"jsonSchemas": [
|
|
@@ -1109,9 +1110,9 @@ exports.RUNPANE_CONTRACT = {
|
|
|
1109
1110
|
},
|
|
1110
1111
|
{
|
|
1111
1112
|
"name": "agents start",
|
|
1112
|
-
"summary": "Start an agent on a task:
|
|
1113
|
+
"summary": "Start an agent on a task and wait until it is ready: as a new tab in an existing Pane with --pane <id> (review, audit, fix, QA), or in a new Pane with --repo and --name for new work.",
|
|
1113
1114
|
"usage": [
|
|
1114
|
-
"runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task>
|
|
1115
|
+
"runpane agents start (--pane <pane-id> | --repo <selector> --name <name> [--base-branch <branch>]) (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> --yes [--json] [--pane-dir <path>]"
|
|
1115
1116
|
],
|
|
1116
1117
|
"mutates": true,
|
|
1117
1118
|
"additive": true,
|
|
@@ -1847,7 +1848,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
1847
1848
|
},
|
|
1848
1849
|
{
|
|
1849
1850
|
"name": "--merged",
|
|
1850
|
-
"description": "With panes archive --session, archive only Panes that are clean and pushed, or merged via a pull request."
|
|
1851
|
+
"description": "With panes archive --session, archive only Panes that are clean and pushed, or merged via a pull request, and whose PR is not still open (skipped as pr-open)."
|
|
1851
1852
|
},
|
|
1852
1853
|
{
|
|
1853
1854
|
"name": "--launch",
|
|
@@ -1980,7 +1981,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
1980
1981
|
" runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]",
|
|
1981
1982
|
" runpane docs search --query <text> [--limit <count>] [--json]",
|
|
1982
1983
|
" runpane docs read --doc <path> [--json]",
|
|
1983
|
-
" runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task>
|
|
1984
|
+
" runpane agents start (--pane <pane-id> | --repo <selector> --name <name> [--base-branch <branch>]) (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> --yes [--json] [--pane-dir <path>]",
|
|
1984
1985
|
" runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]",
|
|
1985
1986
|
" runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]",
|
|
1986
1987
|
" runpane report --state <ready|blocked|failed|done> [--pr <number>] [--head <sha>] [--summary-file <path|->] [--question <text>] [--json]",
|
|
@@ -2194,7 +2195,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
2194
2195
|
" runpane workspace <machine> <runpane command> (any command that talks to Pane, e.g. sessions list --json)",
|
|
2195
2196
|
" runpane workspace enable|disable",
|
|
2196
2197
|
"",
|
|
2197
|
-
"<machine> is a Tailscale name, unique prefix, or IP.
|
|
2198
|
+
"<machine> is a Tailscale name, unique prefix, or IP. Your own machines are reachable, and a teammate's machine when its owner set Who can connect to Everyone on tailnet.",
|
|
2198
2199
|
"Without <machine>, read, write, and exec route a path that cannot exist here (C:\\... on a Mac) to the one joined machine it fits.",
|
|
2199
2200
|
"Commands that only run here (doctor, agent-context, mcp, docs) run there with: runpane workspace <machine> exec -- 'runpane doctor'"
|
|
2200
2201
|
],
|
|
@@ -2257,7 +2258,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
2257
2258
|
" runpane panes create --repo <selector> --name <name> --tool-command <command> [--agent <codex|claude|cursor>] [--base <ref>] [--branch <name>] [--prompt-file <path|->] [options]",
|
|
2258
2259
|
" runpane panes create --from-json <path|-> [--yes] [--json]",
|
|
2259
2260
|
"",
|
|
2260
|
-
"Creates
|
|
2261
|
+
"Creates a Pane in a saved repository and opens a terminal-backed tool tab. 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Create one only when the work's branch has no Pane yet; for existing work use `runpane panels create --pane <id>`.",
|
|
2261
2262
|
"",
|
|
2262
2263
|
"A long or multi-line prompt is never typed into the shell: on bash, zsh or sh the agent launches with `\"$(cat '<prompt file>')\"` reading a private copy under `<pane-dir>/prompts/<pane-id>/`; on PowerShell, cmd, fish or WSL the prompt is pasted into the agent's composer once it is ready.",
|
|
2263
2264
|
"",
|
|
@@ -2925,9 +2926,9 @@ exports.RUNPANE_CONTRACT = {
|
|
|
2925
2926
|
],
|
|
2926
2927
|
"agents start": [
|
|
2927
2928
|
"Usage:",
|
|
2928
|
-
" runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task>
|
|
2929
|
+
" runpane agents start (--pane <pane-id> | --repo <selector> --name <name> [--base-branch <branch>]) (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> --yes [--json] [--pane-dir <path>]",
|
|
2929
2930
|
"",
|
|
2930
|
-
"Start an agent on a task:
|
|
2931
|
+
"Start an agent on a task and wait until it is ready: as a new tab in an existing Pane with --pane <id> (review, audit, fix, QA), or in a new Pane with --repo and --name for new work.",
|
|
2931
2932
|
"",
|
|
2932
2933
|
"Options:",
|
|
2933
2934
|
" --repo <selector> Repository: active, id, exact path, or saved name.",
|
|
@@ -3068,7 +3069,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
3068
3069
|
"Usage:",
|
|
3069
3070
|
" runpane workspace list [--json] [--pane-dir <path>]",
|
|
3070
3071
|
"",
|
|
3071
|
-
"List
|
|
3072
|
+
"List the machines on your tailnet, each with its owner, and whether each answers workspaces.",
|
|
3072
3073
|
"",
|
|
3073
3074
|
"Options:",
|
|
3074
3075
|
" --json Print machine-readable output."
|
|
@@ -3095,7 +3096,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
3095
3096
|
"Usage:",
|
|
3096
3097
|
" runpane workspace [<machine>] read <path> [--json]",
|
|
3097
3098
|
"",
|
|
3098
|
-
"Print a file from
|
|
3099
|
+
"Print a file from a machine on your tailnet; any path form works (C:\\..., /mnt/c/..., /home/..., ~/...).",
|
|
3099
3100
|
"",
|
|
3100
3101
|
"Options:",
|
|
3101
3102
|
" <machine> Tailscale machine name, unique prefix, MagicDNS name, or Tailscale IP. Omit it to route a path that cannot exist here to the one joined machine it fits.",
|
|
@@ -3106,7 +3107,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
3106
3107
|
"Usage:",
|
|
3107
3108
|
" runpane workspace [<machine>] write <path> [--json]",
|
|
3108
3109
|
"",
|
|
3109
|
-
"Write stdin to a file on
|
|
3110
|
+
"Write stdin to a file on a machine on your tailnet, creating parent folders.",
|
|
3110
3111
|
"",
|
|
3111
3112
|
"Options:",
|
|
3112
3113
|
" <machine> Tailscale machine name, unique prefix, MagicDNS name, or Tailscale IP. Omit it to route a path that cannot exist here to the one joined machine it fits.",
|
|
@@ -3207,7 +3208,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
3207
3208
|
" runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]",
|
|
3208
3209
|
" runpane docs search --query <text> [--limit <count>] [--json]",
|
|
3209
3210
|
" runpane docs read --doc <path> [--json]",
|
|
3210
|
-
" runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task>
|
|
3211
|
+
" runpane agents start (--pane <pane-id> | --repo <selector> --name <name> [--base-branch <branch>]) (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> --yes [--json] [--pane-dir <path>]",
|
|
3211
3212
|
" runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]",
|
|
3212
3213
|
" runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]",
|
|
3213
3214
|
" runpane report --state <ready|blocked|failed|done> [--pr <number>] [--head <sha>] [--summary-file <path|->] [--question <text>] [--json]",
|
|
@@ -3468,7 +3469,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
3468
3469
|
" python -m runpane panes create --repo <selector> --name <name> --tool-command <command> [--agent <codex|claude|cursor>] [--base <ref>] [--branch <name>] [--prompt-file <path|->] [options]",
|
|
3469
3470
|
" runpane panes create --from-json <path|-> [--yes] [--json]",
|
|
3470
3471
|
"",
|
|
3471
|
-
"Creates
|
|
3472
|
+
"Creates a Pane in a saved repository and opens a terminal-backed tool tab. 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Create one only when the work's branch has no Pane yet; for existing work use `runpane panels create --pane <id>`.",
|
|
3472
3473
|
"",
|
|
3473
3474
|
"A long or multi-line prompt is never typed into the shell: on bash, zsh or sh the agent launches with `\"$(cat '<prompt file>')\"` reading a private copy under `<pane-dir>/prompts/<pane-id>/`; on PowerShell, cmd, fish or WSL the prompt is pasted into the agent's composer once it is ready.",
|
|
3474
3475
|
"",
|
|
@@ -4121,7 +4122,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
4121
4122
|
],
|
|
4122
4123
|
"agents start": [
|
|
4123
4124
|
"Usage:",
|
|
4124
|
-
" runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task>
|
|
4125
|
+
" runpane agents start (--pane <pane-id> | --repo <selector> --name <name> [--base-branch <branch>]) (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> --yes [--json] [--pane-dir <path>]",
|
|
4125
4126
|
"",
|
|
4126
4127
|
"`runpane agents start` ships in the npm package and the Pane app, not in the Python package.",
|
|
4127
4128
|
"Run it with Node instead: npx --yes runpane@latest agents start"
|
|
@@ -4396,6 +4397,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
4396
4397
|
"runpane lock release --name testing-account --json",
|
|
4397
4398
|
"runpane lock list --json",
|
|
4398
4399
|
"runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json",
|
|
4400
|
+
"runpane agents start --pane <pane-id> --agent codex --prompt \"Review the PR from this branch and report findings\" --yes --json",
|
|
4399
4401
|
"runpane agents status --pane <pane-id> --json",
|
|
4400
4402
|
"runpane agents send --pane <pane-id> --text \"Also add a test\" --yes --json",
|
|
4401
4403
|
"runpane report --state ready --pr 747 --head fc5dce9 --summary-file /tmp/report.md --json",
|
|
@@ -4449,7 +4451,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
4449
4451
|
"`sessions detach` detach a Pane from a named Session.",
|
|
4450
4452
|
"`sessions overview` read a live status, activity, git, and pull request overview for a named Session.",
|
|
4451
4453
|
"`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.",
|
|
4452
|
-
"`runpane agents start|status|send` finish the three common agent jobs in one call each: start an agent on a task in a
|
|
4454
|
+
"`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.",
|
|
4453
4455
|
"`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` (`panes[].report`). Inside a Pane terminal the panel comes from `PANE_SESSION_ID` and `PANE_PANEL_ID`; elsewhere pass `--pane` and `--panel`.",
|
|
4454
4456
|
"`runpane panels last-message --panel <panel-id>` reads a Claude or Codex agent's last reply from its transcript (up to `--limit` characters, default 20,000, keeping the end and reporting `truncated`). It never scrapes the screen: without a transcript it prints `{ ok: false, reason: \"transcript-unavailable\" }` and exits 1.",
|
|
4455
4457
|
"Commands with a contract `daemonAction` (the `panes` git, script, restore, and move commands, `folders list|create`, and `links open`) call the same Pane daemon channel as the matching button in the app and print `{ ok, data, error }`. Destructive ones add a pane:// `link` to review the Pane.",
|
|
@@ -5809,7 +5811,9 @@ exports.RUNPANE_CONTRACT = {
|
|
|
5809
5811
|
"required": [
|
|
5810
5812
|
"name",
|
|
5811
5813
|
"os",
|
|
5812
|
-
"online"
|
|
5814
|
+
"online",
|
|
5815
|
+
"owner",
|
|
5816
|
+
"mine"
|
|
5813
5817
|
],
|
|
5814
5818
|
"additionalProperties": false,
|
|
5815
5819
|
"properties": {
|
|
@@ -5825,6 +5829,14 @@ exports.RUNPANE_CONTRACT = {
|
|
|
5825
5829
|
},
|
|
5826
5830
|
"online": {
|
|
5827
5831
|
"type": "boolean"
|
|
5832
|
+
},
|
|
5833
|
+
"owner": {
|
|
5834
|
+
"type": "string",
|
|
5835
|
+
"description": "Tailscale login of the machine's owner."
|
|
5836
|
+
},
|
|
5837
|
+
"mine": {
|
|
5838
|
+
"type": "boolean",
|
|
5839
|
+
"description": "Signed in to this machine's own Tailscale login."
|
|
5828
5840
|
}
|
|
5829
5841
|
}
|
|
5830
5842
|
}
|
|
@@ -9823,7 +9835,9 @@ exports.RUNPANE_CONTRACT = {
|
|
|
9823
9835
|
"status-unknown",
|
|
9824
9836
|
"missing-pane",
|
|
9825
9837
|
"already-archived",
|
|
9826
|
-
"main-repo"
|
|
9838
|
+
"main-repo",
|
|
9839
|
+
"pr-open",
|
|
9840
|
+
"pr-status-unknown"
|
|
9827
9841
|
]
|
|
9828
9842
|
},
|
|
9829
9843
|
"message": {
|
|
@@ -9862,11 +9876,10 @@ exports.RUNPANE_CONTRACT = {
|
|
|
9862
9876
|
"rules": [
|
|
9863
9877
|
"Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.",
|
|
9864
9878
|
"In a Pane repository checkout, if `runpane` is not on PATH, build the local wrapper with `pnpm --filter runpane build` and run it with Node 22 or newer, for example `node packages/runpane/dist/cli.js doctor --json`.",
|
|
9865
|
-
"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, create the
|
|
9879
|
+
"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.",
|
|
9866
9880
|
"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.",
|
|
9867
9881
|
"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.",
|
|
9868
|
-
"Use `panes create`
|
|
9869
|
-
"Use `panels create` for reviewer/helper/clean-context tabs that should stay inside an existing Pane and share that Pane's worktree.",
|
|
9882
|
+
"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`.",
|
|
9870
9883
|
"For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.",
|
|
9871
9884
|
"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`.",
|
|
9872
9885
|
"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.",
|
|
@@ -9952,7 +9965,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
9952
9965
|
},
|
|
9953
9966
|
{
|
|
9954
9967
|
"name": "panes create",
|
|
9955
|
-
"summary": "Create
|
|
9968
|
+
"summary": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Create a Pane (a new worktree) only when the work's branch has no Pane yet; for review, audit, fix or QA on existing work use `panels create --pane <id>`.",
|
|
9956
9969
|
"arguments": [
|
|
9957
9970
|
"--repo <selector>",
|
|
9958
9971
|
"--name <name>",
|
|
@@ -10033,7 +10046,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
10033
10046
|
},
|
|
10034
10047
|
{
|
|
10035
10048
|
"name": "panels create",
|
|
10036
|
-
"summary": "
|
|
10049
|
+
"summary": "Open reviewer, QA, fix or helper agent tabs inside an existing Pane; they share that Pane's worktree. The default for any later agent on existing work.",
|
|
10037
10050
|
"arguments": [
|
|
10038
10051
|
"--pane <pane-id>",
|
|
10039
10052
|
"--agent <codex|claude|cursor>",
|
|
@@ -10631,8 +10644,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
10631
10644
|
},
|
|
10632
10645
|
"panes create": {
|
|
10633
10646
|
"name": "panes create",
|
|
10634
|
-
"summary": "Create
|
|
10635
|
-
"details": "Use this when the
|
|
10647
|
+
"summary": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Create a Pane (a new worktree) only when the work's branch has no Pane yet; for review, audit, fix or QA on existing work use `panels create --pane <id>`.",
|
|
10648
|
+
"details": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Use this only when the work's branch has no Pane yet: new work, or an existing PR with no Pane. Each new Pane creates a worktree that checks out, installs and often builds, so creating several at once can freeze the machine. First find the feature's Pane with `runpane panes list --repo <repo> --json` by matching the PR's head branch (`gh pr view <n> --json headRefName`) against `git -C <worktreePath> branch --show-current`. For review, follow-up review, fixes, QA or any other agent on work that already has a Pane, use `runpane panels create --pane <id>` to open a new agent tab in that Pane instead. Select the saved base repository, choose a built-in agent or custom terminal command, and optionally send initial input after the tool starts. Pane creates and owns a git worktree/branch for each new Pane; do not pre-create a git worktree and register it as a separate repo unless the user explicitly asks. For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.",
|
|
10636
10649
|
"requiresPaneDaemon": true,
|
|
10637
10650
|
"mutates": true,
|
|
10638
10651
|
"arguments": [
|
|
@@ -10796,10 +10809,9 @@ exports.RUNPANE_CONTRACT = {
|
|
|
10796
10809
|
],
|
|
10797
10810
|
"notes": [
|
|
10798
10811
|
"At least one of --agent or --tool-command is required unless --from-json is used.",
|
|
10799
|
-
"`panes create` is for user-visible Pane orchestration, not the agent's default private delegation mechanism.",
|
|
10812
|
+
"`panes create` is for user-visible Pane orchestration, not the agent's default private delegation mechanism. 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane: before creating one, find the feature's Pane with `runpane panes list --repo <repo> --json` by matching the PR's head branch (`gh pr view <n> --json headRefName`) against `git -C <worktreePath> branch --show-current`, and add a tab with `panels create --pane <id>` when it exists.",
|
|
10800
10813
|
"Register the saved base repository once. Pane creates and owns the worktree/branch for each new Pane.",
|
|
10801
10814
|
"`panes create --base <ref> --branch <name> --prompt-file <file>` replaces `git worktree add` plus `panes adopt`: Pane creates the worktree on exactly that branch name. `--branch` is checked with `git check-ref-format --branch` and fails if the branch already exists; `--worktree-name` still names the directory.",
|
|
10802
|
-
"Use `panels create` instead when a reviewer/helper should share an existing Pane's worktree.",
|
|
10803
10815
|
"Agent-created Panes should pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved. `panes create` pins the new Pane by default, so a follow-up `panes pin` call is unnecessary; pass `--no-pinned` for throwaway shells or bulk imports. `--pinned` is still accepted and is now a no-op. Inside a Session orchestrator (`PANE_ORCHESTRATION_SESSION_ID` set), new Panes are associated with that Session automatically; `--no-associate` opts out. A failed association is reported on the item and never undoes the Pane.",
|
|
10804
10816
|
"The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user.",
|
|
10805
10817
|
"Use --initial-input-file for multi-line prompts or shell-sensitive initial input. A long or multi-line prompt is never typed into the shell: on bash, zsh or sh the agent launches with `\"$(cat '<prompt file>')\"` reading a private copy under `<pane-dir>/prompts/<pane-id>/`; on PowerShell, cmd, fish or WSL the prompt is pasted into the agent's composer once it is ready.",
|
|
@@ -10984,7 +10996,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
10984
10996
|
{
|
|
10985
10997
|
"name": "--merged",
|
|
10986
10998
|
"required": false,
|
|
10987
|
-
"description": "With --session, archive only Panes that are clean and pushed, or merged via a pull request; skip the rest with a reason."
|
|
10999
|
+
"description": "With --session, archive only Panes that are clean and pushed, or merged via a pull request, and whose PR is not still open; skip the rest with a reason (pr-open keeps a Pane whose review, fix and QA tabs still need its worktree)."
|
|
10988
11000
|
},
|
|
10989
11001
|
{
|
|
10990
11002
|
"name": "--yes",
|
|
@@ -11651,8 +11663,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
11651
11663
|
},
|
|
11652
11664
|
"panels create": {
|
|
11653
11665
|
"name": "panels create",
|
|
11654
|
-
"summary": "
|
|
11655
|
-
"details": "
|
|
11666
|
+
"summary": "Open a new agent tab (reviewer, auditor, QA, fix or helper) inside an existing Pane, sharing its worktree. 1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane: use this, not panes create, for any later agent on existing work.",
|
|
11667
|
+
"details": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. This is the default way to start any later agent on work that already has a Pane, including reviewers, follow-up reviewers, auditors, fix implementers, QA and clean-context helpers. The new tab is a fresh agent that shares the Pane's worktree and branch; it does not create a new worktree. Review, audit and QA tabs never run `git checkout`, `reset` or `stash`, and a fix tab starts only after the previous writer has stopped. Use `panes create` only when the work's branch has no Pane yet. Agent/orchestrator-created panels should pass --source agent or --no-focus so the user stays in the implementation tab. The daemon initializes the terminal immediately and can wait for CLI readiness.",
|
|
11656
11668
|
"requiresPaneDaemon": true,
|
|
11657
11669
|
"mutates": true,
|
|
11658
11670
|
"arguments": [
|
|
@@ -12959,22 +12971,28 @@ exports.RUNPANE_CONTRACT = {
|
|
|
12959
12971
|
},
|
|
12960
12972
|
"agents start": {
|
|
12961
12973
|
"name": "agents start",
|
|
12962
|
-
"summary": "Start an agent on a task:
|
|
12963
|
-
"details": "
|
|
12974
|
+
"summary": "Start an agent on a task and wait until it is ready: as a new tab in an existing Pane with --pane <id> (review, audit, fix, QA), or in a new Pane with --repo and --name for new work.",
|
|
12975
|
+
"details": "1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. For work that already has a Pane, pass --pane <id>: the agent opens as a new tab sharing that Pane's worktree and branch. Only when the work's branch has no Pane yet, pass --repo and --name to create one. It returns the pane and panel ids and a pane:// link to hand the user.",
|
|
12964
12976
|
"requiresPaneDaemon": true,
|
|
12965
12977
|
"mutates": true,
|
|
12966
12978
|
"arguments": [
|
|
12979
|
+
{
|
|
12980
|
+
"name": "--pane",
|
|
12981
|
+
"value": "<pane-id>",
|
|
12982
|
+
"required": false,
|
|
12983
|
+
"description": "Existing Pane to add the agent to as a new tab. Use this for any work that already has a Pane."
|
|
12984
|
+
},
|
|
12967
12985
|
{
|
|
12968
12986
|
"name": "--repo",
|
|
12969
12987
|
"value": "<selector>",
|
|
12970
|
-
"required":
|
|
12988
|
+
"required": false,
|
|
12971
12989
|
"description": "Repository: active, id, exact path, or saved name."
|
|
12972
12990
|
},
|
|
12973
12991
|
{
|
|
12974
12992
|
"name": "--name",
|
|
12975
12993
|
"value": "<name>",
|
|
12976
|
-
"required":
|
|
12977
|
-
"description": "Name for the new Pane."
|
|
12994
|
+
"required": false,
|
|
12995
|
+
"description": "Name for the new Pane. With --repo, only for work whose branch has no Pane yet."
|
|
12978
12996
|
},
|
|
12979
12997
|
{
|
|
12980
12998
|
"name": "--agent",
|
|
@@ -13018,7 +13036,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13018
13036
|
}
|
|
13019
13037
|
],
|
|
13020
13038
|
"examples": [
|
|
13021
|
-
"runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json"
|
|
13039
|
+
"runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json",
|
|
13040
|
+
"runpane agents start --pane <pane-id> --agent codex --prompt \"Review the PR from this branch and report findings\" --yes --json"
|
|
13022
13041
|
],
|
|
13023
13042
|
"jsonSchemas": [
|
|
13024
13043
|
"agentTaskResult"
|
|
@@ -13570,8 +13589,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13570
13589
|
},
|
|
13571
13590
|
"workspace list": {
|
|
13572
13591
|
"name": "workspace list",
|
|
13573
|
-
"summary": "List
|
|
13574
|
-
"details": "Shows this machine's workspace state, then each
|
|
13592
|
+
"summary": "List the machines on your tailnet, each with its owner, and whether each answers workspaces.",
|
|
13593
|
+
"details": "Shows this machine's workspace state, then each other Mac, Windows, and Linux machine on your tailnet with its OS, online state, and shell. Your own machines come first; other people's machines carry their owner's login and answer only when their owner lets you in.",
|
|
13575
13594
|
"requiresPaneDaemon": false,
|
|
13576
13595
|
"mutates": false,
|
|
13577
13596
|
"arguments": [
|
|
@@ -13591,7 +13610,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13591
13610
|
"workspace enable": {
|
|
13592
13611
|
"name": "workspace enable",
|
|
13593
13612
|
"summary": "Put this machine's Pane on your tailnet for runpane workspace (the default when Tailscale is signed in).",
|
|
13594
|
-
"details": "Serves this Pane's daemon with tailscale serve on port 8443 in HTTP proxy mode. Only your own Tailscale login is accepted; nothing is opened to the internet.",
|
|
13613
|
+
"details": "Serves this Pane's daemon with tailscale serve on port 8443 in HTTP proxy mode. Only your own Tailscale login is accepted unless you set Who can connect to Everyone on tailnet; nothing is opened to the internet.",
|
|
13595
13614
|
"requiresPaneDaemon": true,
|
|
13596
13615
|
"mutates": true,
|
|
13597
13616
|
"arguments": [
|
|
@@ -13630,7 +13649,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13630
13649
|
},
|
|
13631
13650
|
"workspace read": {
|
|
13632
13651
|
"name": "workspace read",
|
|
13633
|
-
"summary": "Print a file from
|
|
13652
|
+
"summary": "Print a file from a machine on your tailnet; any path form works (C:\\..., /mnt/c/..., /home/..., ~/...).",
|
|
13634
13653
|
"details": "Reads the same way on every OS. On Windows, /mnt/c/... reaches C:\\... and WSL paths such as /home/<user>/... are read through \\\\wsl.localhost\\<distro>\\. Directories list their entries.",
|
|
13635
13654
|
"requiresPaneDaemon": false,
|
|
13636
13655
|
"mutates": false,
|
|
@@ -13661,7 +13680,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13661
13680
|
},
|
|
13662
13681
|
"workspace write": {
|
|
13663
13682
|
"name": "workspace write",
|
|
13664
|
-
"summary": "Write stdin to a file on
|
|
13683
|
+
"summary": "Write stdin to a file on a machine on your tailnet, creating parent folders.",
|
|
13665
13684
|
"details": "Takes the same path forms as workspace read. Content comes from stdin and replaces the file.",
|
|
13666
13685
|
"requiresPaneDaemon": false,
|
|
13667
13686
|
"mutates": true,
|
|
@@ -13813,7 +13832,7 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13813
13832
|
"A successful handoff requires initialInput.verifiedSubmitted and delivery taken or queued without blocked/error evidence. Unverified delivery exits nonzero with the created Pane, panel and a panels screen inspection command; inspect before retrying.",
|
|
13814
13833
|
"Write the note for a reader with no context: quote errors and commands exactly, and record approaches that failed so they are not retried. Leave the front matter to the CLI.",
|
|
13815
13834
|
"Model and effort become agent flags: claude --model/--effort, codex -m and -c model_reasoning_effort, cursor-agent --model. Cursor effort is not supported and is rejected before side effects.",
|
|
13816
|
-
"Run it from the checkout being handed off.
|
|
13835
|
+
"Run it from the checkout being handed off. On another machine the receiver works in a new Pane; on this machine, from the Pane that owns this checkout, it works in a new tab of that Pane (the result's receiver.route and receiver.reason say which). Either way it pushes back to your branch, so stop changing that branch yourself."
|
|
13817
13836
|
]
|
|
13818
13837
|
},
|
|
13819
13838
|
"sessions unpin": {
|
|
@@ -13892,6 +13911,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
13892
13911
|
"",
|
|
13893
13912
|
"This repository is used with [Pane](https://runpane.com). Drive it with the CLI or the `pane` MCP server.",
|
|
13894
13913
|
"",
|
|
13914
|
+
"1 feature = 1 worktree = 1 branch = 1 Pane; reviews, audits, fixes and QA for it are tabs in that Pane. Open later agents with `runpane panels create --pane <id>` (MCP: `panels_create` or `agents_start` with `pane`), not a new Pane.",
|
|
13915
|
+
"",
|
|
13895
13916
|
"CLI: `npm i -g runpane` (or `npx --yes runpane@latest`), then `runpane doctor --json`. Full command reference: `runpane agent-context --json`.",
|
|
13896
13917
|
"",
|
|
13897
13918
|
"MCP: packaged Pane registers a stdio server named `pane` with Claude Code, Codex, and Cursor. Check the connection with `claude mcp list`, `codex mcp list`, or `agent mcp list`. Cursor may ask you to enable `pane` with `agent mcp enable pane`. If tools are missing, add it in the agent's MCP settings: Claude Code `claude mcp add --scope user pane -- npx --yes runpane@latest mcp`; Codex (`~/.codex/config.toml`) table `[mcp_servers.pane]` with `command = \"npx\"` and `args = [\"--yes\", \"runpane@latest\", \"mcp\"]`; Cursor (`~/.cursor/mcp.json`) uses `mcpServers.pane` with the same `npx` command and args; any other stdio client uses them too."
|