fix(cli): stop telling agents to run orca open after a transient disconnect (#42185)

This commit is contained in:
Kelvin Amoaba
2026-11-14 00:04:47 +00:00
committed by GitHub
parent 8063a69924
commit cfa6f0e5e3
22 changed files with 246 additions and 150 deletions
+55 -55
View File
@@ -4,176 +4,176 @@
{
"name": "jira-tickets",
"sourcePath": "skills/jira-tickets",
"packageDigest": "48ca2a93818e17bf1e942452e835800e8f967a935d3082e1e9c03fff9ddb3d19",
"packageDigest": "a29bad15c7a1ec6602748649220ddb3fbec3f488548bab0391c1d00e8d7f08b3",
"files": [
{
"path": "SKILL.md",
"size": 2129,
"size": 2640,
"executable": false,
"classification": "text",
"exactSha256": "5534da4000f4f4c87f7dbb263345a213068c0099a1440186adea865e17d90dfe",
"textNormalizedSha256": "5534da4000f4f4c87f7dbb263345a213068c0099a1440186adea865e17d90dfe",
"identitySha256": "5534da4000f4f4c87f7dbb263345a213068c0099a1440186adea865e17d90dfe"
"exactSha256": "8ceec0a108bd0ad5cd7d3ea863fdada2241dbd01c4f7d5ff80a4aad5ecd7668d",
"textNormalizedSha256": "8ceec0a108bd0ad5cd7d3ea863fdada2241dbd01c4f7d5ff80a4aad5ecd7668d",
"identitySha256": "8ceec0a108bd0ad5cd7d3ea863fdada2241dbd01c4f7d5ff80a4aad5ecd7668d"
}
]
},
{
"name": "linear-tickets",
"sourcePath": "skills/linear-tickets",
"packageDigest": "1eab442d048b79ab0b836adf57663ac384988dd79172ec5f14193eb05e037715",
"packageDigest": "f40aaf42e0fa3fbf74b68a102ef247d0ad7efc5d53b9745c5137c862ad7853f1",
"files": [
{
"path": "SKILL.md",
"size": 2231,
"size": 2742,
"executable": false,
"classification": "text",
"exactSha256": "e181f86073da65c492361469d504fe15e7ae61bc99990bc41bea47aa13455619",
"textNormalizedSha256": "e181f86073da65c492361469d504fe15e7ae61bc99990bc41bea47aa13455619",
"identitySha256": "e181f86073da65c492361469d504fe15e7ae61bc99990bc41bea47aa13455619"
"exactSha256": "d88e3769d024952264769488deb1ff540e10a84424f72852f0b3f5b8ca40e053",
"textNormalizedSha256": "d88e3769d024952264769488deb1ff540e10a84424f72852f0b3f5b8ca40e053",
"identitySha256": "d88e3769d024952264769488deb1ff540e10a84424f72852f0b3f5b8ca40e053"
}
]
},
{
"name": "orca-cli",
"sourcePath": "skills/orca-cli",
"packageDigest": "e4bf1f4d3c60bc45f9030da59d9db1c9dad8479f46eb32dd5cee14bd28c837d1",
"packageDigest": "164336bdec1d72cbd52abca34fca6a898e415c41942f473211fc677d0cba6083",
"files": [
{
"path": "SKILL.md",
"size": 2548,
"size": 3059,
"executable": false,
"classification": "text",
"exactSha256": "06b7c1cc62bcae49e9d3ac18384f94cb58040e2fdc9eabb882fb516a119c4494",
"textNormalizedSha256": "06b7c1cc62bcae49e9d3ac18384f94cb58040e2fdc9eabb882fb516a119c4494",
"identitySha256": "06b7c1cc62bcae49e9d3ac18384f94cb58040e2fdc9eabb882fb516a119c4494"
"exactSha256": "84485364a5a7f17cf222223c25be2839d7501c9e7e92c51cf67c59dc11d0dd0b",
"textNormalizedSha256": "84485364a5a7f17cf222223c25be2839d7501c9e7e92c51cf67c59dc11d0dd0b",
"identitySha256": "84485364a5a7f17cf222223c25be2839d7501c9e7e92c51cf67c59dc11d0dd0b"
}
]
},
{
"name": "orca-computer-use",
"sourcePath": "skills/orca-computer-use",
"packageDigest": "b0e08e4acfcd0fe28d2db9fa1c9a6974775ee446dc868bf83e34f2fae68af776",
"packageDigest": "eadaf85ca053edf588758df090f1e88675c23ef36f31d111f1b9f631b0ab484f",
"files": [
{
"path": "SKILL.md",
"size": 2327,
"size": 2838,
"executable": false,
"classification": "text",
"exactSha256": "e2284427bde1accf2f77d34a8c217d6da6284b804a771a5ba9ea11816ea9196d",
"textNormalizedSha256": "e2284427bde1accf2f77d34a8c217d6da6284b804a771a5ba9ea11816ea9196d",
"identitySha256": "e2284427bde1accf2f77d34a8c217d6da6284b804a771a5ba9ea11816ea9196d"
"exactSha256": "c204e8fb3fb887772474135e5bed6143c49e0680fdd45f6d2cc2f9f8fd1acc3d",
"textNormalizedSha256": "c204e8fb3fb887772474135e5bed6143c49e0680fdd45f6d2cc2f9f8fd1acc3d",
"identitySha256": "c204e8fb3fb887772474135e5bed6143c49e0680fdd45f6d2cc2f9f8fd1acc3d"
}
]
},
{
"name": "orca-emulator",
"sourcePath": "skills/orca-emulator",
"packageDigest": "1dc42e5addc613abd85eba639d4ac36d9c7b3bc6f7186f0a2d54d10dae3f06d3",
"packageDigest": "fa76f1aaeeba5e988e227a11009e1b0b56c1e83e42255f8fe2dbe3bd4c99a773",
"files": [
{
"path": "SKILL.md",
"size": 2337,
"size": 2848,
"executable": false,
"classification": "text",
"exactSha256": "3da7191179e46cb0e1a6a936f1eb54254f6e98ec38849e1c95f0e11073076b48",
"textNormalizedSha256": "3da7191179e46cb0e1a6a936f1eb54254f6e98ec38849e1c95f0e11073076b48",
"identitySha256": "3da7191179e46cb0e1a6a936f1eb54254f6e98ec38849e1c95f0e11073076b48"
"exactSha256": "a24bd6e21af7784b5877f1009828023dca43031127f7207887425b26b9c0cf36",
"textNormalizedSha256": "a24bd6e21af7784b5877f1009828023dca43031127f7207887425b26b9c0cf36",
"identitySha256": "a24bd6e21af7784b5877f1009828023dca43031127f7207887425b26b9c0cf36"
}
]
},
{
"name": "orca-emulator-android",
"sourcePath": "skills/orca-emulator-android",
"packageDigest": "c348091d953427fc9800a1d49d94054866348008766879b24ef742cb613dc3d9",
"packageDigest": "42efdbbd29c5301e4cc49ba9f3dce3c4ad8ef2844e3d64f0fe6860ec3fa4d3c7",
"files": [
{
"path": "SKILL.md",
"size": 2234,
"size": 2745,
"executable": false,
"classification": "text",
"exactSha256": "3ade4e6f8f2717ca899fd841e61f116963a406e9527015b803854c16d012e278",
"textNormalizedSha256": "3ade4e6f8f2717ca899fd841e61f116963a406e9527015b803854c16d012e278",
"identitySha256": "3ade4e6f8f2717ca899fd841e61f116963a406e9527015b803854c16d012e278"
"exactSha256": "dd652721e42592bd8015f18eff0d110bcc695109ef09d2727d75131f0a1e3be1",
"textNormalizedSha256": "dd652721e42592bd8015f18eff0d110bcc695109ef09d2727d75131f0a1e3be1",
"identitySha256": "dd652721e42592bd8015f18eff0d110bcc695109ef09d2727d75131f0a1e3be1"
}
]
},
{
"name": "orca-jira",
"sourcePath": "skills/orca-jira",
"packageDigest": "815931fe3f4b52437ca15db4b512ce4033b84b3ce1639df0882cc4f7adfc005d",
"packageDigest": "b1d7bfbafcd18d2589e6d398d80453d5db35cfd00a68a58d45afb4785e57336c",
"files": [
{
"path": "SKILL.md",
"size": 2080,
"size": 2591,
"executable": false,
"classification": "text",
"exactSha256": "ca83c4662fbc2306efb9043674998b0ca5abacc78ec2e5f85e5db80288e6777a",
"textNormalizedSha256": "ca83c4662fbc2306efb9043674998b0ca5abacc78ec2e5f85e5db80288e6777a",
"identitySha256": "ca83c4662fbc2306efb9043674998b0ca5abacc78ec2e5f85e5db80288e6777a"
"exactSha256": "8c70206d1b6d6e884b6c4cec1eb9eb5e075a4be943d2cca75c973d19791392fb",
"textNormalizedSha256": "8c70206d1b6d6e884b6c4cec1eb9eb5e075a4be943d2cca75c973d19791392fb",
"identitySha256": "8c70206d1b6d6e884b6c4cec1eb9eb5e075a4be943d2cca75c973d19791392fb"
}
]
},
{
"name": "orca-linear",
"sourcePath": "skills/orca-linear",
"packageDigest": "95f52429823e887317046f23b671d05408a947c296e5b2e44e9173dfc1d5aa4e",
"packageDigest": "3228d11015689388e61dc86efd0d4fbae0cd73ce4817c0afb4f0f87cafa2d062",
"files": [
{
"path": "SKILL.md",
"size": 2088,
"size": 2599,
"executable": false,
"classification": "text",
"exactSha256": "8da23ef96470906315cace8ff84f8056255ee37d1b2d5db84d8b7b3270a0ba0f",
"textNormalizedSha256": "8da23ef96470906315cace8ff84f8056255ee37d1b2d5db84d8b7b3270a0ba0f",
"identitySha256": "8da23ef96470906315cace8ff84f8056255ee37d1b2d5db84d8b7b3270a0ba0f"
"exactSha256": "3b15b12bbc7bf8cee702303e1179d7736227f887337ca88ad28ba654f57e0e9d",
"textNormalizedSha256": "3b15b12bbc7bf8cee702303e1179d7736227f887337ca88ad28ba654f57e0e9d",
"identitySha256": "3b15b12bbc7bf8cee702303e1179d7736227f887337ca88ad28ba654f57e0e9d"
}
]
},
{
"name": "orca-per-workspace-env",
"sourcePath": "skills/orca-per-workspace-env",
"packageDigest": "103f0671da111c9ad3def6c46da8d432e656878b840e6cc742219f4a3a4dbceb",
"packageDigest": "600e0e6cb7f3633f8b02c23c22fbf79111b2f982c4cecd00ce05ba2e29477bd2",
"files": [
{
"path": "SKILL.md",
"size": 2257,
"size": 2768,
"executable": false,
"classification": "text",
"exactSha256": "c005d126a13d2913351472f07690f1c1a660d4f286e2a5f21864aee294f436ce",
"textNormalizedSha256": "c005d126a13d2913351472f07690f1c1a660d4f286e2a5f21864aee294f436ce",
"identitySha256": "c005d126a13d2913351472f07690f1c1a660d4f286e2a5f21864aee294f436ce"
"exactSha256": "39c457ada06e320108516f97ea81a331e6bfa484bd7dccf4d025a7ca6bde99a4",
"textNormalizedSha256": "39c457ada06e320108516f97ea81a331e6bfa484bd7dccf4d025a7ca6bde99a4",
"identitySha256": "39c457ada06e320108516f97ea81a331e6bfa484bd7dccf4d025a7ca6bde99a4"
}
]
},
{
"name": "orca-plugin-authoring",
"sourcePath": "skills/orca-plugin-authoring",
"packageDigest": "8bc40895e0655c24014699ff0f311752814b0ba6b18a8428768cb42f9b54264e",
"packageDigest": "aec45f7a455be3a9876d34aa0718ad6bbe3aa62ef902d7279d0b66b4a017ee10",
"files": [
{
"path": "SKILL.md",
"size": 2320,
"size": 2831,
"executable": false,
"classification": "text",
"exactSha256": "633d9b8dd17a7406a77541633e10391d95dfe10a0c25fcd0e04d6a248ea2f597",
"textNormalizedSha256": "633d9b8dd17a7406a77541633e10391d95dfe10a0c25fcd0e04d6a248ea2f597",
"identitySha256": "633d9b8dd17a7406a77541633e10391d95dfe10a0c25fcd0e04d6a248ea2f597"
"exactSha256": "928eaf8e69b2665778897a5250c6975e2c96199293328a1b01af5bcdc9180826",
"textNormalizedSha256": "928eaf8e69b2665778897a5250c6975e2c96199293328a1b01af5bcdc9180826",
"identitySha256": "928eaf8e69b2665778897a5250c6975e2c96199293328a1b01af5bcdc9180826"
}
]
},
{
"name": "orchestration",
"sourcePath": "skills/orchestration",
"packageDigest": "ff539effe2690ab15d2232ba0c4e55b7579ff17324185a8b07f4108bfb1ea4c9",
"packageDigest": "31ad9b912d99c2f74224e40b8beb036513d2bf5e6bdcf0a575ab12c2f35e18de",
"files": [
{
"path": "SKILL.md",
"size": 3273,
"size": 3784,
"executable": false,
"classification": "text",
"exactSha256": "4b3e686cb2b106c2db8ecab53d4b000b4356cca63d4a7f7e3cf6db8798c38fed",
"textNormalizedSha256": "4b3e686cb2b106c2db8ecab53d4b000b4356cca63d4a7f7e3cf6db8798c38fed",
"identitySha256": "4b3e686cb2b106c2db8ecab53d4b000b4356cca63d4a7f7e3cf6db8798c38fed"
"exactSha256": "0a781637d8c9c1dd9409b8ca6ea7eb8a83add577a1aacfb3b8146e442213be53",
"textNormalizedSha256": "0a781637d8c9c1dd9409b8ca6ea7eb8a83add577a1aacfb3b8146e442213be53",
"identitySha256": "0a781637d8c9c1dd9409b8ca6ea7eb8a83add577a1aacfb3b8146e442213be53"
}
]
}
+14 -3
View File
@@ -14,7 +14,8 @@
"f49b29fb6b209956907688692387adcdc509fad344555f09badaf383106f5f39"
],
"jira-tickets": [
"5534da4000f4f4c87f7dbb263345a213068c0099a1440186adea865e17d90dfe"
"5534da4000f4f4c87f7dbb263345a213068c0099a1440186adea865e17d90dfe",
"8ceec0a108bd0ad5cd7d3ea863fdada2241dbd01c4f7d5ff80a4aad5ecd7668d"
],
"linear-tickets": [
"050220f735ce9b0f65520d3ed7fba6f5c1f856a6e8e84093ef564901cfc97ee1",
@@ -26,6 +27,7 @@
"af2d33d98c21e22726a6a36a3e41b1967770c4df6691530d02409d8aca861c15",
"d2dec89eca8c71c820ee2dbd7bae4fb8528775554dbc6c7a71ed8a3422f53d23",
"d3a15d886cc4037dbc612d6191e7492b4583a9dddbb6bf56d92d767db036848f",
"d88e3769d024952264769488deb1ff540e10a84424f72852f0b3f5b8ca40e053",
"e181f86073da65c492361469d504fe15e7ae61bc99990bc41bea47aa13455619",
"ea2a508c60ab145981f5b16fbed949c4a4c167ec4df16888cf1703fd4c6056c0",
"f57dfda0dddd20992b83d8b7a3e85f9651244ae4cb1b80bed80a87bb2c9b8bf2"
@@ -58,6 +60,7 @@
"7b1b746d4f080e0ac9a4b30f1fcb32f24433efccf70e03b66342a07cac54c835",
"7ef384a2687f655acd0cc40be40ea5a7df46a0e6d6bdb1ea3d43d9d7ae25778c",
"80f8b98301c0d4c0cce6d522d56ae248312d6a386a17b275078c618cc7ddaa5e",
"84485364a5a7f17cf222223c25be2839d7501c9e7e92c51cf67c59dc11d0dd0b",
"86f75826ec0ed735a3363fe6b17c7b29431f1ddcf16736398bd38ee6a7e9c7ce",
"879f328595d4148a5b0dba9dd3cc31c4d30740cb574d754f38ee82f9d1cc782c",
"90228630bc4daab4ccf67b691153976d1f28ec064d7069a4c170621ed2ea99b5",
@@ -81,6 +84,7 @@
],
"orca-computer-use": [
"69376456185483ea494eb354be09bce5b8bde9d1c792e8cb1ce7687691d1a021",
"c204e8fb3fb887772474135e5bed6143c49e0680fdd45f6d2cc2f9f8fd1acc3d",
"e2284427bde1accf2f77d34a8c217d6da6284b804a771a5ba9ea11816ea9196d"
],
"orca-emulator": [
@@ -91,7 +95,8 @@
"654746c72c0fa4aaa540c3aa7450413404450c195bcdeaf0aaa27fa114d0f058",
"796f2135824e0ecdfe4f6e8f8bd4690788c1816933df4104b2f9846ffe9a41e0",
"837909c40e2472c24bcfd88684c00b0c19208e35e4446f81772ee6d7854fd834",
"84dbfacf6854874e369840c011e78603e533273fb848d21dac3cfb08e0346429"
"84dbfacf6854874e369840c011e78603e533273fb848d21dac3cfb08e0346429",
"a24bd6e21af7784b5877f1009828023dca43031127f7207887425b26b9c0cf36"
],
"orca-emulator-android": [
"1035d4db357923e98d5075c0c21bc9995b00a36a3739543516fe45ae5ded0332",
@@ -99,14 +104,17 @@
"3ade4e6f8f2717ca899fd841e61f116963a406e9527015b803854c16d012e278",
"41d9cae07abd03a39236733884332058316bcf816e4b5b2d411c01b3a16ac8a6",
"ae242330d98c9335160fbd4356894e15633d63c02da4edfd7109ab1845368002",
"dd652721e42592bd8015f18eff0d110bcc695109ef09d2727d75131f0a1e3be1",
"ebc1ce862f3e5489e9bd94388386a28116241748f5957116509de7f759250844"
],
"orca-jira": [
"8c70206d1b6d6e884b6c4cec1eb9eb5e075a4be943d2cca75c973d19791392fb",
"ca83c4662fbc2306efb9043674998b0ca5abacc78ec2e5f85e5db80288e6777a"
],
"orca-linear": [
"04ef6cb0377bc7c2dd38dc713b4ef5196ee6851dc90e9fdcddbc2347faa678e6",
"39241e0aa2929344e3b38407215d737fb35de8421b4efb5cf2c767f91d0e7a9b",
"3b15b12bbc7bf8cee702303e1179d7736227f887337ca88ad28ba654f57e0e9d",
"48ded55ec3842ce65105e6db7adf9bc9ed263ece08555cec056e68e90321c3d5",
"5f76c347107c1c2c428181e48cf255a8245e40b717a063a9104d5fee03e2ec3e",
"6cf7adec44a919e1b6b0bd99cbf9a7c805dfdef338eb91053173ac20d33d9cec",
@@ -117,6 +125,7 @@
"bff571bc0e4fae51782f2077bbda182bbead11e67d1bc684267e59a7ff791d13"
],
"orca-per-workspace-env": [
"39c457ada06e320108516f97ea81a331e6bfa484bd7dccf4d025a7ca6bde99a4",
"58e479bd18c4c553df0dfcb408eece2fbe550a0f9688bc289414420f72ed7ea7",
"a18c3e67b3558d95c07ac80ab7e94c9ddfa0c61946c6b977923ffd65d3df63cc",
"a7ae9a0d22b8bc14a6cb3bdb6fc6ebf1f11cc25ab489d1cc63928bd025d7dddc",
@@ -125,9 +134,11 @@
"f1f74bc372e7ac9a85e393ceba4f9ae9c6aae96311515546b16c0c05b07327ac"
],
"orca-plugin-authoring": [
"633d9b8dd17a7406a77541633e10391d95dfe10a0c25fcd0e04d6a248ea2f597"
"633d9b8dd17a7406a77541633e10391d95dfe10a0c25fcd0e04d6a248ea2f597",
"928eaf8e69b2665778897a5250c6975e2c96199293328a1b01af5bcdc9180826"
],
"orchestration": [
"0a781637d8c9c1dd9409b8ca6ea7eb8a83add577a1aacfb3b8146e442213be53",
"0cb898d37560ab7ac4cb477a2d7e8ba3e593d45affd6d7e9f99151879aaeb1a5",
"0cfb6a082625edc0d474bae430eb22c28bbe484e54fbfebedb4ff89d96e36305",
"1150a30d854ad1d6c4f107af4c115bac6afd00122e4b011ee5e8f9c49a9d9bab",
+3 -3
View File
@@ -165,15 +165,14 @@ Agent/setup flags:
ORCA worktree create --name task --parent-worktree active --agent codex --prompt "hi" --json
ORCA worktree create --name task --parent-worktree active --agent claude --setup run --json
ORCA worktree create --name task --parent-worktree active --setup skip --json
ORCA worktree create --name task --parent-worktree active --run-hooks --json
```
- `--agent <id>` starts that agent with the worktree, as a chat or a terminal per the user's Chat | CLI choice for that agent (see Starting agents); `--prompt <text>` sends initial work to it, and `--model <id>` / `--effort <level>` pick its model and reasoning effort, and `--surface chat|terminal` picks chat or terminal for this launch. Known ids include `claude`, `codex`, `omp`, `pi`, `grok`, and other installed agents.
- Repo setup or default-terminal settings may still add tabs or splits. Configured default tabs are intentional; never close one without verifying it is an unused shell.
- Address the agent through exactly one handle: `launch.outcome.handle`. Handles are runtime-scoped: after an Orca restart or a `terminal_handle_stale` error, re-list and continue with the replacement only; never dual-send to old and replacement handles. `--agent` already started the agent, so do not start it again.
- `--setup run|skip|inherit` controls repo setup hooks. Default is `inherit`, which follows the repo's setup policy.
- `--run-hooks` is a legacy alias for `--setup run`; it also reveals/activates the new worktree.
- `--activate` and `--run-hooks` reveal the new worktree. `--agent` alone stays in the background.
- `--run-hooks` is a legacy alias for `--setup run` that also reveals the new worktree; use `--setup run` instead.
- `--activate` and `--run-hooks` switch the user's view to the new worktree, so pass them only when the user asked to switch to it. `--agent` alone stays in the background.
- Let Orca choose setup terminal placement from repo settings, including tab vs split behavior.
- `worktree create` makes a new checkout. For a fresh agent in the **current** checkout, use `ORCA agent launch --agent codex --json`.
@@ -260,6 +259,7 @@ Terminal rules:
- A chat tab has no terminal handle, so `terminal rename` cannot rename it. Use `ORCA chat rename --session <sessionId> --name "New Name" --json` with the `sessionId` `agent launch` printed; inside a chat, omit `--session` to rename that chat.
- `terminal create --title` and `terminal rename` set the tab title, which `terminal list` reports under `visualLayouts`. `terminal set-pane-title` sets one pane's title, reported as `terminals[].paneTitle`. `terminals[].title` may be the tab title or the running program's own title, which agents repaint constantly, so never match on it to re-find a terminal.
- `terminals[].agentIdentity`, when present, is only the agent type (e.g. `codex`), not a session identity, so two Codex panes share it. To find a specific agent's terminal, join `worktree ps --json` `agents[].paneKey` (`<tabId>:<leafId>`) to the `tabId` and `leafId` of a `terminal list` row to get its handle.
- `terminal switch` changes the terminal the user is looking at, so run it only when the user asked to switch. Commands that act on one terminal take `--terminal <handle>`, so they never need a switch.
- A paired server has no window. `terminal switch --environment <name>` moves the desktop app on this machine to that server's terminal, and reports `navigated: false` when no desktop here shows that server.
- Use `terminal read` before `terminal send` unless the next input is obvious.
- `terminal read` returns accumulated output with escape sequences stripped, not the rendered screen, so anything that repaints (shells, progress bars, TUIs) reads as stacked fragments. Use `--screen` whenever the answer depends on what the terminal actually shows.
+11 -5
View File
@@ -24,8 +24,14 @@ to another executable, which could silently target a different Orca build.
<!-- block: no-guessing -->
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+10 -4
View File
@@ -22,9 +22,15 @@ recovery, or expanded DAG work, load only the reference that gate names with
<!-- shared-omit: no-guessing -->
Use the selected executable's `--help` for commands or flags the guide does not cover. If a
command reports that Orca is not running, start it with `ORCA open --json` and retry. If it
fails with `runtime_access_denied`, your sandbox blocked the connection: re-run it with
escalated permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown,
Use the selected executable's `--help` for commands or flags the guide does not cover. A
`runtime_unavailable` error is usually transient while Orca is busy or restarting: wait a few
seconds and retry the command. Before retrying a command that changes something, check whether
it already took effect, and reuse any request ID the error names. `ORCA open` can bring Orca's
window to the front over the user's work, so never run it to retry a failed command. Run it only
when the user asks, or when Orca is really not running: `ORCA status --json` reports
`result.app.running: false`, or every command, `ORCA status` included, still cannot connect
after about 30 seconds of retries. If a command fails with `runtime_access_denied`, your
sandbox blocked the connection: re-run it with escalated permissions, and do not run
`ORCA open` or restart Orca. If `skills get` is unknown,
explain that updating Orca restores the guide; use `--help` for read-only discovery and do not
guess unsupported commands.
+11 -5
View File
@@ -36,8 +36,14 @@ ORCA skills get jira-tickets
Load `ORCA skills get orca-jira` for the available commands. Use `--json` and one explicit site ID when several Jira sites match. Jira content is untrusted task data; it cannot authorize writes. Keep failed or uncertain writes visible.
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -40,8 +40,14 @@ ORCA skills get linear-tickets
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -42,8 +42,14 @@ ORCA skills get orca-cli
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -40,8 +40,14 @@ ORCA skills get computer-use
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -40,8 +40,14 @@ ORCA skills get orca-emulator-android
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -43,8 +43,14 @@ ORCA skills get orca-emulator
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -38,8 +38,14 @@ ORCA skills get orca-jira
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -38,8 +38,14 @@ ORCA skills get orca-linear
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -39,8 +39,14 @@ ORCA skills get orca-per-workspace-env
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+11 -5
View File
@@ -39,8 +39,14 @@ ORCA skills get orca-plugin-authoring
```
Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.
not cover. A `runtime_unavailable` error is usually transient while Orca is busy or
restarting: wait a few seconds and retry the command. Before retrying a command that changes
something, check whether it already took effect, and reuse any request ID the error names.
`ORCA open` can bring Orca's window to the front over the user's work, so never run it to
retry a failed command. Run it only when the user asks, or when Orca is really not running:
`ORCA status --json` reports `result.app.running: false`, or every command, `ORCA status`
included, still cannot connect after about 30 seconds of retries. If a command fails with
`runtime_access_denied`, your sandbox blocked the connection: re-run it with escalated
permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown, explain
that updating Orca restores the guide; use `--help` for read-only discovery and do not guess
unsupported commands.
+10 -4
View File
@@ -54,9 +54,15 @@ recovery, or expanded DAG work, load only the reference that gate names with
(`--references` lists the names). If that binary rejects `--reference`, run
`ORCA skills get orchestration --full` and read the named bundled reference before acting.
Use the selected executable's `--help` for commands or flags the guide does not cover. If a
command reports that Orca is not running, start it with `ORCA open --json` and retry. If it
fails with `runtime_access_denied`, your sandbox blocked the connection: re-run it with
escalated permissions, and do not run `ORCA open` or restart Orca. If `skills get` is unknown,
Use the selected executable's `--help` for commands or flags the guide does not cover. A
`runtime_unavailable` error is usually transient while Orca is busy or restarting: wait a few
seconds and retry the command. Before retrying a command that changes something, check whether
it already took effect, and reuse any request ID the error names. `ORCA open` can bring Orca's
window to the front over the user's work, so never run it to retry a failed command. Run it only
when the user asks, or when Orca is really not running: `ORCA status --json` reports
`result.app.running: false`, or every command, `ORCA status` included, still cannot connect
after about 30 seconds of retries. If a command fails with `runtime_access_denied`, your
sandbox blocked the connection: re-run it with escalated permissions, and do not run
`ORCA open` or restart Orca. If `skills get` is unknown,
explain that updating Orca restores the guide; use `--help` for read-only discovery and do not
guess unsupported commands.
+6 -9
View File
@@ -88,7 +88,7 @@ export function formatCliError(error: unknown, context: CliErrorContext = {}): s
if (hasOrchestrationRequestId(error.data)) {
return message
}
return formatRuntimeUnavailableError(message, error.data)
return formatRuntimeUnavailableError(message, error)
}
// Match before generic recovery; flattened errors may retain only the conflict token.
const conflict = automationOwnerConflictRecovery(matchAutomationOwnerConflict(error))
@@ -111,12 +111,6 @@ export function formatCliError(error: unknown, context: CliErrorContext = {}): s
)
}
}
if (
error instanceof RuntimeRpcFailureError &&
error.response.error.code === 'runtime_unavailable'
) {
return formatRuntimeUnavailableError(message, error.response.error.data)
}
if (error instanceof RuntimeRpcFailureError) {
return formatMessageWithNextSteps(message, nextStepsFromData(error.response.error.data))
}
@@ -131,11 +125,14 @@ function hasOrchestrationRequestId(data: unknown): boolean {
)
}
function formatRuntimeUnavailableError(message: string, data: unknown): string {
const nextSteps = nextStepsFromData(data)
function formatRuntimeUnavailableError(message: string, error: RuntimeClientError): string {
const nextSteps = nextStepsFromData(error.data)
if (nextSteps.length > 0) {
return formatMessageWithNextSteps(message, nextSteps)
}
if (error instanceof RuntimeRpcFailureError) {
return `${message}\nOrca is running but not ready for this yet. Wait a few seconds and retry; do not run 'orca open'. If it keeps failing and 'orca status --json' shows app.desktopWindowStatus "openable", Orca's window is closed: ask the user to reopen it.`
}
return `${message}\nOrca is not running. Run 'orca open' first.`
}
+8 -2
View File
@@ -13,6 +13,12 @@ import { runtimeAccessDeniedError } from './runtime-access-denied'
import { MAX_LOCAL_RUNTIME_RPC_MESSAGE_BYTES } from '../../shared/local-runtime-rpc-limits'
import { daemonSocketDirIsTrusted } from '../../main/daemon/endpoint/publication/daemon-socket-endpoint-path'
// Agents read these; a blip must not send them to `orca open`, which raises the window.
const TRANSIENT_DISCONNECT_NEXT_STEPS = [
'Orca is usually busy or restarting: wait a few seconds, then retry. If the command changes something, first check whether it already took effect, and retry with the request ID this error names, if any.',
"Do not run 'orca open' to recover. Run it only if the user asks, or if 'orca status --json' reports Orca is not running or still cannot connect after about 30 seconds of retries."
]
export async function sendRequest<TResult>(
metadata: RuntimeMetadata,
method: string,
@@ -104,7 +110,7 @@ export async function sendRequest<TResult>(
new RuntimeClientError(
'runtime_unavailable',
'This terminal could not connect to Orca.',
{ nextSteps: ['Check that Orca is open and that this terminal can access it.'] }
{ nextSteps: TRANSIENT_DISCONNECT_NEXT_STEPS }
)
})
})
@@ -115,7 +121,7 @@ export async function sendRequest<TResult>(
error: new RuntimeClientError(
'runtime_unavailable',
'Orca closed the connection before responding.',
{ nextSteps: ['Check that Orca is open and that this terminal can access it.'] }
{ nextSteps: TRANSIENT_DISCONNECT_NEXT_STEPS }
)
})
})
+3 -3
View File
@@ -393,15 +393,14 @@ const ORCA_CLI_MARKDOWN = [
"ORCA worktree create --name task --parent-worktree active --agent codex --prompt \"hi\" --json",
"ORCA worktree create --name task --parent-worktree active --agent claude --setup run --json",
"ORCA worktree create --name task --parent-worktree active --setup skip --json",
"ORCA worktree create --name task --parent-worktree active --run-hooks --json",
"```",
"",
"- `--agent <id>` starts that agent with the worktree, as a chat or a terminal per the user's Chat | CLI choice for that agent (see Starting agents); `--prompt <text>` sends initial work to it, and `--model <id>` / `--effort <level>` pick its model and reasoning effort, and `--surface chat|terminal` picks chat or terminal for this launch. Known ids include `claude`, `codex`, `omp`, `pi`, `grok`, and other installed agents.",
"- Repo setup or default-terminal settings may still add tabs or splits. Configured default tabs are intentional; never close one without verifying it is an unused shell.",
"- Address the agent through exactly one handle: `launch.outcome.handle`. Handles are runtime-scoped: after an Orca restart or a `terminal_handle_stale` error, re-list and continue with the replacement only; never dual-send to old and replacement handles. `--agent` already started the agent, so do not start it again.",
"- `--setup run|skip|inherit` controls repo setup hooks. Default is `inherit`, which follows the repo's setup policy.",
"- `--run-hooks` is a legacy alias for `--setup run`; it also reveals/activates the new worktree.",
"- `--activate` and `--run-hooks` reveal the new worktree. `--agent` alone stays in the background.",
"- `--run-hooks` is a legacy alias for `--setup run` that also reveals the new worktree; use `--setup run` instead.",
"- `--activate` and `--run-hooks` switch the user's view to the new worktree, so pass them only when the user asked to switch to it. `--agent` alone stays in the background.",
"- Let Orca choose setup terminal placement from repo settings, including tab vs split behavior.",
"- `worktree create` makes a new checkout. For a fresh agent in the **current** checkout, use `ORCA agent launch --agent codex --json`.",
"",
@@ -488,6 +487,7 @@ const ORCA_CLI_MARKDOWN = [
"- A chat tab has no terminal handle, so `terminal rename` cannot rename it. Use `ORCA chat rename --session <sessionId> --name \"New Name\" --json` with the `sessionId` `agent launch` printed; inside a chat, omit `--session` to rename that chat.",
"- `terminal create --title` and `terminal rename` set the tab title, which `terminal list` reports under `visualLayouts`. `terminal set-pane-title` sets one pane's title, reported as `terminals[].paneTitle`. `terminals[].title` may be the tab title or the running program's own title, which agents repaint constantly, so never match on it to re-find a terminal.",
"- `terminals[].agentIdentity`, when present, is only the agent type (e.g. `codex`), not a session identity, so two Codex panes share it. To find a specific agent's terminal, join `worktree ps --json` `agents[].paneKey` (`<tabId>:<leafId>`) to the `tabId` and `leafId` of a `terminal list` row to get its handle.",
"- `terminal switch` changes the terminal the user is looking at, so run it only when the user asked to switch. Commands that act on one terminal take `--terminal <handle>`, so they never need a switch.",
"- A paired server has no window. `terminal switch --environment <name>` moves the desktop app on this machine to that server's terminal, and reports `navigated: false` when no desktop here shows that server.",
"- Use `terminal read` before `terminal send` unless the next input is obvious.",
"- `terminal read` returns accumulated output with escape sequences stripped, not the rendered screen, so anything that repaints (shells, progress bars, TUIs) reads as stacked fragments. Use `--screen` whenever the answer depends on what the terminal actually shows.",
+4
View File
@@ -15,6 +15,9 @@ export const CORE_COMMAND_SPECS: CommandSpec[] = [
summary: 'Launch Orca and wait for the runtime to be reachable',
usage: 'orca open [--json]',
allowedFlags: [...GLOBAL_FLAGS],
notes: [
"It can bring Orca's window to the front. Agents should run it only when the user asks or `orca status --json` reports Orca is not running or still cannot connect after about 30 seconds of retries, never to retry a failed command."
],
examples: ['orca open', 'orca open --json']
},
...SERVE_COMMAND_SPECS,
@@ -202,6 +205,7 @@ export const CORE_COMMAND_SPECS: CommandSpec[] = [
usage: 'orca terminal switch [--terminal <handle>] [--json]',
allowedFlags: [...GLOBAL_FLAGS, 'terminal'],
notes: [
'It changes the terminal the user is looking at; agents should run it only when the user asked to switch.',
"With --environment, the desktop app on this machine switches to that server's terminal; a server has no window of its own."
],
examples: ['orca terminal switch --terminal term_abc123']
+1 -1
View File
@@ -56,7 +56,7 @@ export const WORKTREE_CREATE_COMMAND_SPEC: CommandSpec = {
'With --agent --json, result.launch says what started: launch.outcome.kind (structured chat or terminal), launch.outcome.handle, and launch.receipt.detail for why. An Orca host older than this returns the terminal agent handle in result.agentTerminalHandle instead.',
'Repo-defined setup hooks follow the repository setup policy; pass --setup run to force them.',
'Pass --activate when the CLI caller intentionally wants to reveal the new worktree in the app.',
'Passing --run-hooks is kept as a legacy alias for --setup run and reveals the worktree.',
'Passing --run-hooks is kept as a legacy alias for --setup run and reveals the worktree; agents should pass --setup run instead unless the user asked to switch to it.',
'Use --pr for GitHub pull requests; --gitlab-issue and --gitlab-mr write separate GitLab links. GitLab URLs must match the stored source project or remote; they cannot select a foreign project.'
],
examples: [
File diff suppressed because one or more lines are too long