@jbkjr/relay 0.0.0-stage → 1.2.1

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.
Files changed (296) hide show
  1. package/LICENSE +21 -0
  2. package/LICENSES/Apache-2.0.txt +201 -0
  3. package/LICENSES/README.md +19 -0
  4. package/LICENSES/codex-NOTICE.txt +6 -0
  5. package/README.md +386 -2
  6. package/SECURITY.md +145 -0
  7. package/adapters/briefs/claude.md +43 -0
  8. package/adapters/briefs/codex.md +56 -0
  9. package/adapters/briefs/models.json +33 -0
  10. package/adapters/build.mjs +8 -0
  11. package/adapters/claude/.claude-plugin/marketplace.json +13 -0
  12. package/adapters/claude/relay/.claude-plugin/plugin.json +5 -0
  13. package/adapters/claude/relay/agents/codex.md +21 -0
  14. package/adapters/claude/relay/agents/operator.md +21 -0
  15. package/adapters/claude/relay/skills/ask/SKILL.md +20 -0
  16. package/adapters/claude/relay/skills/chat/SKILL.md +13 -0
  17. package/adapters/claude/relay/skills/delegate/SKILL.md +21 -0
  18. package/adapters/claude/relay/skills/discuss/SKILL.md +19 -0
  19. package/adapters/claude/relay/skills/review/SKILL.md +21 -0
  20. package/adapters/claude/relay/skills/tree/SKILL.md +10 -0
  21. package/adapters/claude/relay/skills/write-for-codex/SKILL.md +78 -0
  22. package/adapters/codex/.agents/plugins/marketplace.json +20 -0
  23. package/adapters/codex/AGENTS.snippet.md +5 -0
  24. package/adapters/codex/relay/.codex-plugin/plugin.json +6 -0
  25. package/adapters/codex/relay/skills/relay-ask/SKILL.md +20 -0
  26. package/adapters/codex/relay/skills/relay-chat/SKILL.md +13 -0
  27. package/adapters/codex/relay/skills/relay-delegate/SKILL.md +21 -0
  28. package/adapters/codex/relay/skills/relay-discuss/SKILL.md +19 -0
  29. package/adapters/codex/relay/skills/relay-review/SKILL.md +21 -0
  30. package/adapters/codex/relay/skills/relay-tree/SKILL.md +10 -0
  31. package/adapters/codex/relay/skills/relay-write-for-claude/SKILL.md +66 -0
  32. package/adapters/generate.mjs +124 -0
  33. package/bin/relay +59 -0
  34. package/codex-pin.json +12 -0
  35. package/dist/backends/acp.js +1424 -0
  36. package/dist/backends/claude.js +890 -0
  37. package/dist/backends/cli-version.js +112 -0
  38. package/dist/backends/codex-app.js +1525 -0
  39. package/dist/backends/codex-daybreak.js +75 -0
  40. package/dist/backends/codex-env.js +656 -0
  41. package/dist/backends/codex-network.js +304 -0
  42. package/dist/backends/codex-pin.js +320 -0
  43. package/dist/backends/codex-shell-policy.js +182 -0
  44. package/dist/backends/codex-stage2.js +998 -0
  45. package/dist/backends/codex-subagents.js +47 -0
  46. package/dist/backends/codex.js +637 -0
  47. package/dist/backends/copilot.js +246 -0
  48. package/dist/backends/env.js +147 -0
  49. package/dist/backends/gemini.js +607 -0
  50. package/dist/backends/grok.js +337 -0
  51. package/dist/backends/index.js +8 -0
  52. package/dist/backends/native-temp.js +187 -0
  53. package/dist/backends/never-admission.js +90 -0
  54. package/dist/backends/run.js +67 -0
  55. package/dist/backends/stream.js +230 -0
  56. package/dist/backends/tool-discovery.js +15 -0
  57. package/dist/backends/types.js +264 -0
  58. package/dist/build-info.json +5 -0
  59. package/dist/cli.js +344 -0
  60. package/dist/confine/bridge.js +113 -0
  61. package/dist/confine/broker-core.js +76 -0
  62. package/dist/confine/broker-http.js +650 -0
  63. package/dist/confine/broker-names.js +9 -0
  64. package/dist/confine/broker.js +258 -0
  65. package/dist/confine/canary.js +380 -0
  66. package/dist/confine/diagnostics.js +122 -0
  67. package/dist/confine/gemini-tools-main.js +8 -0
  68. package/dist/confine/gemini-tools.js +181 -0
  69. package/dist/confine/hardlinks.js +58 -0
  70. package/dist/confine/harness-config.js +16 -0
  71. package/dist/confine/index.js +117 -0
  72. package/dist/confine/leases.js +217 -0
  73. package/dist/confine/paths.js +6 -0
  74. package/dist/confine/peer.js +115 -0
  75. package/dist/confine/port-policy.js +8 -0
  76. package/dist/confine/ports.js +365 -0
  77. package/dist/confine/private-root.js +208 -0
  78. package/dist/confine/probe-stage2.js +501 -0
  79. package/dist/confine/probe.js +1109 -0
  80. package/dist/confine/proxy.js +783 -0
  81. package/dist/confine/sbcheck.js +208 -0
  82. package/dist/confine/seatbelt-never.js +41 -0
  83. package/dist/confine/seatbelt-stage2.js +139 -0
  84. package/dist/confine/seatbelt.js +1129 -0
  85. package/dist/confine/sockets.js +36 -0
  86. package/dist/confine/turn-probe.js +19 -0
  87. package/dist/confine/turn.js +86 -0
  88. package/dist/core/adoption.js +124 -0
  89. package/dist/core/api-keys.js +423 -0
  90. package/dist/core/approvals.js +740 -0
  91. package/dist/core/build-identity.js +248 -0
  92. package/dist/core/caller.js +749 -0
  93. package/dist/core/calls.js +102 -0
  94. package/dist/core/claude-settings.js +1045 -0
  95. package/dist/core/config.js +453 -0
  96. package/dist/core/context.js +186 -0
  97. package/dist/core/db.js +753 -0
  98. package/dist/core/dispatch.js +110 -0
  99. package/dist/core/env-broker.js +505 -0
  100. package/dist/core/env-policy.js +182 -0
  101. package/dist/core/escalation-authority.js +76 -0
  102. package/dist/core/escalation-contract.js +13 -0
  103. package/dist/core/escalation-person-path.js +131 -0
  104. package/dist/core/escalation-policy.js +79 -0
  105. package/dist/core/escalation-runtime.js +135 -0
  106. package/dist/core/escalation-state.js +42 -0
  107. package/dist/core/escalations.js +191 -0
  108. package/dist/core/events.js +235 -0
  109. package/dist/core/executables.js +147 -0
  110. package/dist/core/extensions.js +645 -0
  111. package/dist/core/families.js +204 -0
  112. package/dist/core/git.js +657 -0
  113. package/dist/core/identity.js +113 -0
  114. package/dist/core/liveness.js +68 -0
  115. package/dist/core/mediated-network-provider.js +81 -0
  116. package/dist/core/never-checkpoint.js +76 -0
  117. package/dist/core/never-coverage.js +97 -0
  118. package/dist/core/never-network.js +49 -0
  119. package/dist/core/never-policy.js +302 -0
  120. package/dist/core/never-proxy-policy.js +109 -0
  121. package/dist/core/never-schema.js +61 -0
  122. package/dist/core/never-tools.js +56 -0
  123. package/dist/core/notices.js +48 -0
  124. package/dist/core/ops.js +959 -0
  125. package/dist/core/outcome.js +224 -0
  126. package/dist/core/params.js +32 -0
  127. package/dist/core/presence.js +174 -0
  128. package/dist/core/procs.js +546 -0
  129. package/dist/core/prompts.js +363 -0
  130. package/dist/core/protected-config.js +238 -0
  131. package/dist/core/raw-network.js +192 -0
  132. package/dist/core/redact.js +152 -0
  133. package/dist/core/refusal.js +33 -0
  134. package/dist/core/relay-command.js +310 -0
  135. package/dist/core/reported.js +3 -0
  136. package/dist/core/restart-overlay.js +651 -0
  137. package/dist/core/retention.js +1135 -0
  138. package/dist/core/secrets.js +329 -0
  139. package/dist/core/session-token.js +175 -0
  140. package/dist/core/session.js +744 -0
  141. package/dist/core/shell.js +2 -0
  142. package/dist/core/shipped-pin.js +47 -0
  143. package/dist/core/shown.js +42 -0
  144. package/dist/core/slots.js +67 -0
  145. package/dist/core/stage2-executors.js +453 -0
  146. package/dist/core/stage2-switch.js +5 -0
  147. package/dist/core/steering.js +149 -0
  148. package/dist/core/storage.js +358 -0
  149. package/dist/core/toml.js +175 -0
  150. package/dist/core/views.js +324 -0
  151. package/dist/core/wait.js +114 -0
  152. package/dist/core/wake.js +207 -0
  153. package/dist/core/watch.js +247 -0
  154. package/dist/core/worktree.js +213 -0
  155. package/dist/hosts/claude-desktop.js +274 -0
  156. package/dist/hosts/claude.js +249 -0
  157. package/dist/hosts/codex.js +329 -0
  158. package/dist/hosts/desktop-shared.js +20 -0
  159. package/dist/hosts/index.js +11 -0
  160. package/dist/hosts/types.js +4 -0
  161. package/dist/install/basics.js +18 -0
  162. package/dist/install/claude-init.js +133 -0
  163. package/dist/install/common.js +655 -0
  164. package/dist/install/doctor.js +629 -0
  165. package/dist/install/qualify-codex.js +205 -0
  166. package/dist/install.js +524 -0
  167. package/dist/mcp/elicit.js +209 -0
  168. package/dist/mcp/gateway.js +218 -0
  169. package/dist/mcp/host.js +253 -0
  170. package/dist/mcp/server.js +1124 -0
  171. package/dist/mcp/stdio.js +37 -0
  172. package/dist/modes/discussion.js +393 -0
  173. package/dist/modes/review.js +722 -0
  174. package/dist/native/relay-sbcheck +0 -0
  175. package/dist/targets/briefs.js +86 -0
  176. package/dist/targets/claude.js +94 -0
  177. package/dist/targets/codex.js +66 -0
  178. package/dist/targets/copilot.js +93 -0
  179. package/dist/targets/gemini.js +119 -0
  180. package/dist/targets/grok.js +126 -0
  181. package/dist/targets/index.js +192 -0
  182. package/dist/targets/types.js +18 -0
  183. package/dist/targets/verified.js +35 -0
  184. package/dist/worker.js +113 -0
  185. package/docs/UPGRADING.md +1502 -0
  186. package/docs/pinned-codex.md +321 -0
  187. package/experiments/stage2-redteam/lib/oracles.mjs +214 -0
  188. package/experiments/stage2-redteam/lib/report.mjs +35 -0
  189. package/npm-shrinkwrap.json +1632 -0
  190. package/package.json +82 -4
  191. package/scripts/codex-qualify/codex-pin-store.mjs +353 -0
  192. package/scripts/codex-qualify/codex-qualifier-process.mjs +265 -0
  193. package/scripts/codex-qualify/codex-qualifier.example.json +5 -0
  194. package/scripts/codex-qualify/codex-qualifier.mjs +281 -0
  195. package/scripts/codex-qualify/codex-shipped-pin.mjs +158 -0
  196. package/scripts/codex-qualify/codex-stage2-pin.mjs +48 -0
  197. package/scripts/codex-qualify/codex-stage2.mjs +2381 -0
  198. package/scripts/codex-qualify/install-codex-qualifier.mjs +98 -0
  199. package/scripts/codex-qualify/main-module.mjs +14 -0
  200. package/scripts/codex-qualify/relay-codex-qualifier.plist +37 -0
  201. package/scripts/codex-qualify/scratch-env.mjs +31 -0
  202. package/scripts/codex-qualify/session.mjs +96 -0
  203. package/scripts/codex-qualify/stage2-escalation-cases.mjs +125 -0
  204. package/test/codex-permissions.test.ts +875 -0
  205. package/test/fixtures/boundary-probes.mjs +17 -0
  206. package/test/fixtures/denial-stream-host.mjs +7 -0
  207. package/test/fixtures/families.json +246 -0
  208. package/test/fixtures/install-snapshots/claude-desktop-foreign.txt +158 -0
  209. package/test/fixtures/install-snapshots/claude-desktop-fresh.txt +101 -0
  210. package/test/fixtures/install-snapshots/claude-desktop-installed.txt +161 -0
  211. package/test/fixtures/install-snapshots/claude-foreign.txt +133 -0
  212. package/test/fixtures/install-snapshots/claude-fresh.txt +77 -0
  213. package/test/fixtures/install-snapshots/claude-installed.txt +133 -0
  214. package/test/fixtures/install-snapshots/codex-foreign.txt +159 -0
  215. package/test/fixtures/install-snapshots/codex-fresh.txt +107 -0
  216. package/test/fixtures/install-snapshots/codex-installed.txt +161 -0
  217. package/test/fixtures/link-parent.mjs +6 -0
  218. package/test/fixtures/mediated-command.cjs +72 -0
  219. package/test/fixtures/native-skill-isolation.json +280 -0
  220. package/test/fixtures/pinned-codex-app-server.mjs +25 -0
  221. package/test/fixtures/qualified-ext-adapters.mjs +36 -0
  222. package/test/fixtures/refusals/README.md +52 -0
  223. package/test/fixtures/refusals/claude-source-result.json +7 -0
  224. package/test/fixtures/refusals/openai-app-capacity.json +24 -0
  225. package/test/fixtures/refusals/openai-app-cyberPolicy.json +24 -0
  226. package/test/fixtures/refusals/openai-gpt-6-astra-max.json +12 -0
  227. package/test/fixtures/refusals/openai-gpt-6.1-sol-xhigh.json +12 -0
  228. package/test/fixtures/refusals/openai-review-capacity.json +24 -0
  229. package/test/fixtures/relay-0.2.0.sql +57 -0
  230. package/test/fixtures/relay-0.9.1.gen.mjs +212 -0
  231. package/test/fixtures/relay-0.9.1.sql +340 -0
  232. package/test/fixtures/slow-boundary-probes.mjs +37 -0
  233. package/test/fixtures/stable-surfaces/config.json +1122 -0
  234. package/test/fixtures/stable-surfaces/escalation.json +128 -0
  235. package/test/fixtures/stable-surfaces/events.json +37 -0
  236. package/test/fixtures/stable-surfaces/gemini-native-resume.json +4 -0
  237. package/test/fixtures/stable-surfaces/inbox.jsonl +2 -0
  238. package/test/fixtures/stable-surfaces/notice.txt +1 -0
  239. package/test/fixtures/stable-surfaces/refusal-item.json +28 -0
  240. package/test/fixtures/stable-surfaces/refusal-review.json +23 -0
  241. package/test/fixtures/stable-surfaces/registry.json +49 -0
  242. package/test/fixtures/stable-surfaces/tools-desktop.json +575 -0
  243. package/test/fixtures/stable-surfaces/tools.json +716 -0
  244. package/test/fixtures/stable-surfaces/usage.txt +46 -0
  245. package/test/fixtures/stage2-acp-native.mjs +138 -0
  246. package/test/fixtures/stage2-app-server.mjs +23 -0
  247. package/test/fixtures/stage2-catalog.json +91 -0
  248. package/test/fixtures/stage2-hostile-web.mjs +35 -0
  249. package/test/fixtures/stage2-native-network.mjs +62 -0
  250. package/test/fixtures/stage2-worker.ts +87 -0
  251. package/test/fixtures/status-views/expected.json +7825 -0
  252. package/test/fixtures/status-views/registries.json +1 -0
  253. package/test/fixtures/steering.json +209 -0
  254. package/test/helpers.ts +740 -0
  255. package/test/host-env.ts +7 -0
  256. package/test/keychain-decoy.ts +197 -0
  257. package/test/live-scope.ts +44 -0
  258. package/test/mediated-network.test.ts +192 -0
  259. package/test/mediated-proxy.test.ts +264 -0
  260. package/test/native-temp-alias.ts +10 -0
  261. package/test/never-policy.test.ts +629 -0
  262. package/test/never-tools.test.ts +136 -0
  263. package/test/process-home.ts +18 -0
  264. package/test/proxy.test.ts +531 -0
  265. package/test/restart-overlay-live.test.ts +85 -0
  266. package/test/restart-overlay-profile.test.ts +66 -0
  267. package/test/restart-overlay.test.ts +416 -0
  268. package/test/stable-surfaces.test.ts +249 -0
  269. package/test/stage2-escalation-live.test.ts +544 -0
  270. package/test/stage2-escalation-qualification.test.ts +170 -0
  271. package/test/stage2-escalation.test.ts +747 -0
  272. package/test/stage2-executor.test.ts +849 -0
  273. package/test/stage2-grant.test.ts +603 -0
  274. package/test/stage2-native-live.test.ts +647 -0
  275. package/test/stage2-network-decisions.test.ts +70 -0
  276. package/test/stage2-probe.test.ts +845 -0
  277. package/test/stage2-standing-live.test.ts +203 -0
  278. package/test/stubs/broker-host.mjs +59 -0
  279. package/test/stubs/broker-peer.mjs +20 -0
  280. package/test/stubs/confined-harness.mjs +91 -0
  281. package/test/stubs/ext-broken-server.mjs +2 -0
  282. package/test/stubs/ext-odd-server.mjs +21 -0
  283. package/test/stubs/ext-server.mjs +31 -0
  284. package/test/stubs/fake-host-cli.mjs +218 -0
  285. package/test/stubs/procargs.mjs +30 -0
  286. package/test/stubs/stub-acp +4 -0
  287. package/test/stubs/stub-agent.mjs +322 -0
  288. package/test/stubs/stub-claude +4 -0
  289. package/test/stubs/stub-codex +4 -0
  290. package/test/stubs/targets/acp.mjs +307 -0
  291. package/test/stubs/targets/claude.mjs +149 -0
  292. package/test/stubs/targets/codex.mjs +479 -0
  293. package/test/stubs/targets/gemini.mjs +604 -0
  294. package/test/temp-root.ts +11 -0
  295. package/test/wp4-adapters.test.ts +353 -0
  296. package/test/wp4-interlock.test.ts +136 -0
@@ -0,0 +1,17 @@
1
+ // Test-only preload (node --import, through NODE_OPTIONS in a test harness's environment): stands
2
+ // in relay's real per-turn boundary probes (prepareLaunch). Production relay never loads this file.
3
+ import fs from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+ import { prepareLaunch } from "../../dist/confine/index.js";
7
+ import { setBoundaryProbeForTests } from "../../dist/confine/turn-probe.js";
8
+
9
+ // Relay's trusted servers use their own stable TMPDIR; the fixture binaries still live
10
+ // under the test runner's scratch temp root, including when a grandchild is resumed.
11
+ const TMP = fs.realpathSync(process.env.STUB_TEMP_ROOT ?? os.tmpdir()) + path.sep;
12
+
13
+ setBoundaryProbeForTests(async (mechanism, policy, command, args, signal, environment) => {
14
+ // A probe that escapes writes beside the harness binary: tests launch only scratch copies of their stubs.
15
+ if (!fs.realpathSync(command).startsWith(TMP)) throw new Error(`test guard: the harness ${command} is not a scratch file, and the boundary probes would aim beside it`);
16
+ return prepareLaunch(mechanism, policy, command, args, signal, environment);
17
+ });
@@ -0,0 +1,7 @@
1
+ // Test-only: starts a denial stream with the tag given, prints "ready" once it has attached, and then
2
+ // waits forever, so a test can SIGKILL this process and check the stream does not outlive it.
3
+ import { streamSandboxDenials } from "../../dist/confine/diagnostics.js";
4
+ const s = streamSandboxDenials(process.argv[2], () => {});
5
+ await s.ready;
6
+ process.stdout.write("ready\n");
7
+ setInterval(() => {}, 1 << 30);
@@ -0,0 +1,246 @@
1
+ {
2
+ "job-anthropic-anthropic": {
3
+ "caller": "anthropic",
4
+ "launched": "anthropic",
5
+ "relation": "same-family",
6
+ "summary": "Same-family: Claude (Anthropic) working with Claude (Anthropic). Both run Anthropic's models; this is not a cross-family job.",
7
+ "note": "Relay started Claude (Anthropic) because the call named it. Its tool descriptions give your own subagents first place for Claude work, unless the user asked for relay or this session has none."
8
+ },
9
+ "job-anthropic-openai": {
10
+ "caller": "anthropic",
11
+ "launched": "openai",
12
+ "relation": "cross-family",
13
+ "summary": "Cross-family: Claude (Anthropic) working with Codex (OpenAI)."
14
+ },
15
+ "job-anthropic-unknown": {
16
+ "caller": "anthropic",
17
+ "launched": "unknown",
18
+ "relation": "unknown",
19
+ "summary": "Family unknown: relay cannot show that Claude (Anthropic) and Codex (family unknown) are of different families, so this job is not known to be cross-family.",
20
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
21
+ },
22
+ "job-openai-anthropic": {
23
+ "caller": "openai",
24
+ "launched": "anthropic",
25
+ "relation": "cross-family",
26
+ "summary": "Cross-family: Codex (OpenAI) working with Claude (Anthropic)."
27
+ },
28
+ "job-openai-openai": {
29
+ "caller": "openai",
30
+ "launched": "openai",
31
+ "relation": "same-family",
32
+ "summary": "Same-family: Codex (OpenAI) working with Codex (OpenAI). Both run OpenAI's models; this is not a cross-family job.",
33
+ "note": "Relay started Codex (OpenAI) because the call named it. Its tool descriptions give your own subagents first place for Codex work, unless the user asked for relay or this session has none."
34
+ },
35
+ "job-openai-unknown": {
36
+ "caller": "openai",
37
+ "launched": "unknown",
38
+ "relation": "unknown",
39
+ "summary": "Family unknown: relay cannot show that Codex (OpenAI) and Codex (family unknown) are of different families, so this job is not known to be cross-family.",
40
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
41
+ },
42
+ "job-unknown-anthropic": {
43
+ "caller": "unknown",
44
+ "launched": "anthropic",
45
+ "relation": "unknown",
46
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Claude (Anthropic) are of different families, so this job is not known to be cross-family.",
47
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
48
+ },
49
+ "job-unknown-openai": {
50
+ "caller": "unknown",
51
+ "launched": "openai",
52
+ "relation": "unknown",
53
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (OpenAI) are of different families, so this job is not known to be cross-family.",
54
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
55
+ },
56
+ "job-unknown-unknown": {
57
+ "caller": "unknown",
58
+ "launched": "unknown",
59
+ "relation": "unknown",
60
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (family unknown) are of different families, so this job is not known to be cross-family.",
61
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\"). Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
62
+ },
63
+ "thread-anthropic-anthropic": {
64
+ "caller": "anthropic",
65
+ "launched": "anthropic",
66
+ "relation": "same-family",
67
+ "summary": "Same-family: Claude (Anthropic) working with Claude (Anthropic). Both run Anthropic's models; this is not a cross-family consult.",
68
+ "note": "Relay started Claude (Anthropic) because the call named it. Its tool descriptions give your own subagents first place for Claude work, unless the user asked for relay or this session has none."
69
+ },
70
+ "thread-anthropic-openai": {
71
+ "caller": "anthropic",
72
+ "launched": "openai",
73
+ "relation": "cross-family",
74
+ "summary": "Cross-family: Claude (Anthropic) working with Codex (OpenAI)."
75
+ },
76
+ "thread-anthropic-unknown": {
77
+ "caller": "anthropic",
78
+ "launched": "unknown",
79
+ "relation": "unknown",
80
+ "summary": "Family unknown: relay cannot show that Claude (Anthropic) and Codex (family unknown) are of different families, so this consult is not known to be cross-family.",
81
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
82
+ },
83
+ "thread-openai-anthropic": {
84
+ "caller": "openai",
85
+ "launched": "anthropic",
86
+ "relation": "cross-family",
87
+ "summary": "Cross-family: Codex (OpenAI) working with Claude (Anthropic)."
88
+ },
89
+ "thread-openai-openai": {
90
+ "caller": "openai",
91
+ "launched": "openai",
92
+ "relation": "same-family",
93
+ "summary": "Same-family: Codex (OpenAI) working with Codex (OpenAI). Both run OpenAI's models; this is not a cross-family consult.",
94
+ "note": "Relay started Codex (OpenAI) because the call named it. Its tool descriptions give your own subagents first place for Codex work, unless the user asked for relay or this session has none."
95
+ },
96
+ "thread-openai-unknown": {
97
+ "caller": "openai",
98
+ "launched": "unknown",
99
+ "relation": "unknown",
100
+ "summary": "Family unknown: relay cannot show that Codex (OpenAI) and Codex (family unknown) are of different families, so this consult is not known to be cross-family.",
101
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
102
+ },
103
+ "thread-unknown-anthropic": {
104
+ "caller": "unknown",
105
+ "launched": "anthropic",
106
+ "relation": "unknown",
107
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Claude (Anthropic) are of different families, so this consult is not known to be cross-family.",
108
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
109
+ },
110
+ "thread-unknown-openai": {
111
+ "caller": "unknown",
112
+ "launched": "openai",
113
+ "relation": "unknown",
114
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (OpenAI) are of different families, so this consult is not known to be cross-family.",
115
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
116
+ },
117
+ "thread-unknown-unknown": {
118
+ "caller": "unknown",
119
+ "launched": "unknown",
120
+ "relation": "unknown",
121
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (family unknown) are of different families, so this consult is not known to be cross-family.",
122
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\"). Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
123
+ },
124
+ "discussion-anthropic-anthropic": {
125
+ "caller": "anthropic",
126
+ "launched": "anthropic",
127
+ "relation": "same-family",
128
+ "summary": "Same-family: Claude (Anthropic) working with Claude (Anthropic). Both run Anthropic's models; this is not a cross-family discussion.",
129
+ "note": "Relay started Claude (Anthropic) because the call named it. Its tool descriptions give your own subagents first place for Claude work, unless the user asked for relay or this session has none."
130
+ },
131
+ "discussion-anthropic-openai": {
132
+ "caller": "anthropic",
133
+ "launched": "openai",
134
+ "relation": "cross-family",
135
+ "summary": "Cross-family: Claude (Anthropic) working with Codex (OpenAI)."
136
+ },
137
+ "discussion-anthropic-unknown": {
138
+ "caller": "anthropic",
139
+ "launched": "unknown",
140
+ "relation": "unknown",
141
+ "summary": "Family unknown: relay cannot show that Claude (Anthropic) and Codex (family unknown) are of different families, so this discussion is not known to be cross-family.",
142
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
143
+ },
144
+ "discussion-openai-anthropic": {
145
+ "caller": "openai",
146
+ "launched": "anthropic",
147
+ "relation": "cross-family",
148
+ "summary": "Cross-family: Codex (OpenAI) working with Claude (Anthropic)."
149
+ },
150
+ "discussion-openai-openai": {
151
+ "caller": "openai",
152
+ "launched": "openai",
153
+ "relation": "same-family",
154
+ "summary": "Same-family: Codex (OpenAI) working with Codex (OpenAI). Both run OpenAI's models; this is not a cross-family discussion.",
155
+ "note": "Relay started Codex (OpenAI) because the call named it. Its tool descriptions give your own subagents first place for Codex work, unless the user asked for relay or this session has none."
156
+ },
157
+ "discussion-openai-unknown": {
158
+ "caller": "openai",
159
+ "launched": "unknown",
160
+ "relation": "unknown",
161
+ "summary": "Family unknown: relay cannot show that Codex (OpenAI) and Codex (family unknown) are of different families, so this discussion is not known to be cross-family.",
162
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
163
+ },
164
+ "discussion-unknown-anthropic": {
165
+ "caller": "unknown",
166
+ "launched": "anthropic",
167
+ "relation": "unknown",
168
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Claude (Anthropic) are of different families, so this discussion is not known to be cross-family.",
169
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
170
+ },
171
+ "discussion-unknown-openai": {
172
+ "caller": "unknown",
173
+ "launched": "openai",
174
+ "relation": "unknown",
175
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (OpenAI) are of different families, so this discussion is not known to be cross-family.",
176
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
177
+ },
178
+ "discussion-unknown-unknown": {
179
+ "caller": "unknown",
180
+ "launched": "unknown",
181
+ "relation": "unknown",
182
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (family unknown) are of different families, so this discussion is not known to be cross-family.",
183
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\"). Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
184
+ },
185
+ "review-anthropic-anthropic": {
186
+ "caller": "anthropic",
187
+ "launched": "anthropic",
188
+ "relation": "same-family",
189
+ "summary": "Same-family: Claude (Anthropic) working with Claude (Anthropic). Both run Anthropic's models; this is not a cross-family review.",
190
+ "note": "Relay started Claude (Anthropic) because the call named it. Its tool descriptions give your own subagents first place for Claude work, unless the user asked for relay or this session has none."
191
+ },
192
+ "review-anthropic-openai": {
193
+ "caller": "anthropic",
194
+ "launched": "openai",
195
+ "relation": "cross-family",
196
+ "summary": "Cross-family: Claude (Anthropic) working with Codex (OpenAI)."
197
+ },
198
+ "review-anthropic-unknown": {
199
+ "caller": "anthropic",
200
+ "launched": "unknown",
201
+ "relation": "unknown",
202
+ "summary": "Family unknown: relay cannot show that Claude (Anthropic) and Codex (family unknown) are of different families, so this review is not known to be cross-family.",
203
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
204
+ },
205
+ "review-openai-anthropic": {
206
+ "caller": "openai",
207
+ "launched": "anthropic",
208
+ "relation": "cross-family",
209
+ "summary": "Cross-family: Codex (OpenAI) working with Claude (Anthropic)."
210
+ },
211
+ "review-openai-openai": {
212
+ "caller": "openai",
213
+ "launched": "openai",
214
+ "relation": "same-family",
215
+ "summary": "Same-family: Codex (OpenAI) working with Codex (OpenAI). Both run OpenAI's models; this is not a cross-family review.",
216
+ "note": "Relay started Codex (OpenAI) because the call named it. Its tool descriptions give your own subagents first place for Codex work, unless the user asked for relay or this session has none."
217
+ },
218
+ "review-openai-unknown": {
219
+ "caller": "openai",
220
+ "launched": "unknown",
221
+ "relation": "unknown",
222
+ "summary": "Family unknown: relay cannot show that Codex (OpenAI) and Codex (family unknown) are of different families, so this review is not known to be cross-family.",
223
+ "note": "Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
224
+ },
225
+ "review-unknown-anthropic": {
226
+ "caller": "unknown",
227
+ "launched": "anthropic",
228
+ "relation": "unknown",
229
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Claude (Anthropic) are of different families, so this review is not known to be cross-family.",
230
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
231
+ },
232
+ "review-unknown-openai": {
233
+ "caller": "unknown",
234
+ "launched": "openai",
235
+ "relation": "unknown",
236
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (OpenAI) are of different families, so this review is not known to be cross-family.",
237
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\")."
238
+ },
239
+ "review-unknown-unknown": {
240
+ "caller": "unknown",
241
+ "launched": "unknown",
242
+ "relation": "unknown",
243
+ "summary": "Family unknown: relay cannot show that a session of unknown family and Codex (family unknown) are of different families, so this review is not known to be cross-family.",
244
+ "note": "Relay cannot tell this session's family: its host is not one relay knows (client name \"opencode\"). Relay launched Codex with an endpoint its config does not judge (codex_endpoint_override \"accept\")."
245
+ }
246
+ }
@@ -0,0 +1,158 @@
1
+ $ relay install claude-desktop
2
+ exit status 1
3
+ --- stdout
4
+ # mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json:
5
+ {
6
+ "command": "<ROOT>/bin/relay",
7
+ "args": [
8
+ "mcp",
9
+ "--host",
10
+ "claude",
11
+ "--desktop"
12
+ ],
13
+ "env": {
14
+ "PATH": "<NODE_DIR>:<TMP>/bin:/usr/bin:/usr/local/bin:/bin:/usr/sbin:/sbin"
15
+ }
16
+ }
17
+ # relay-desktop is the desktop app's own relay, and is shared. Desktop chats in the main window share one relay process. Cowork, the Code tab's in-app bridge, remote Cowork and widgets share a second. Within each process every conversation carries its own session token, which keeps its jobs, approval requests and events apart from the others'. Code-tab sessions also have their own dedicated relay registration. The token is a bearer key its model holds: it separates conversations that use relay honestly. Configuration describes the topology; doctor does not observe calls or verify which conversation used it. Claude.app 2.42304.0's code was checked on <DATE>: neither process forwards per-conversation metadata. Pass cwd on merge and on starts (a new ask without it consults in a new, empty directory of its own); no session on this shared entry gets an approval dialog, confirm or notices, and its waits end after 50 s, under the app's 60 s tool timeout (README, "Claude desktop app and Cowork").
18
+ --- stderr
19
+
20
+ relay install claude-desktop: mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json is not relay's (its command is npx), so relay will not replace it. If it should go, run this again with --force: what is there now is saved first.
21
+
22
+ Nothing was changed (this was a dry run, and with --write it would have stopped here too).
23
+
24
+ $ relay install claude-desktop --force
25
+ exit status 0
26
+ --- stdout
27
+ # mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json:
28
+ {
29
+ "command": "<ROOT>/bin/relay",
30
+ "args": [
31
+ "mcp",
32
+ "--host",
33
+ "claude",
34
+ "--desktop"
35
+ ],
36
+ "env": {
37
+ "PATH": "<NODE_DIR>:<TMP>/bin:/usr/bin:/usr/local/bin:/bin:/usr/sbin:/sbin"
38
+ }
39
+ }
40
+ # relay-desktop is the desktop app's own relay, and is shared. Desktop chats in the main window share one relay process. Cowork, the Code tab's in-app bridge, remote Cowork and widgets share a second. Within each process every conversation carries its own session token, which keeps its jobs, approval requests and events apart from the others'. Code-tab sessions also have their own dedicated relay registration. The token is a bearer key its model holds: it separates conversations that use relay honestly. Configuration describes the topology; doctor does not observe calls or verify which conversation used it. Claude.app 2.42304.0's code was checked on <DATE>: neither process forwards per-conversation metadata. Pass cwd on merge and on starts (a new ask without it consults in a new, empty directory of its own); no session on this shared entry gets an approval dialog, confirm or notices, and its waits end after 50 s, under the app's 60 s tool timeout (README, "Claude desktop app and Cowork").
41
+ # replace relay's entry in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json
42
+ $ ln -s <ROOT>/bin/relay <TMP>/home/.local/bin/relay
43
+
44
+ Nothing was changed. Re-run with --write to apply.
45
+ --- stderr
46
+
47
+ $ relay uninstall claude-desktop
48
+ exit status 0
49
+ --- stdout
50
+ # no installation record for the Claude desktop app; going by what is installed
51
+ # left alone: mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json is not relay's (its command is npx). --force removes it.
52
+
53
+ Nothing to do: nothing of relay's was found in the Claude desktop app.
54
+
55
+ Not removed, because it can hold your work or your logins:
56
+ <TMP>/home/.local/state/relay (not present)
57
+ relay's state: the registry of runs, logs, the prompts sent and the transcripts
58
+ <TMP>/home/.local/share/relay/worktrees (not present)
59
+ the worktrees of write jobs
60
+ <TMP>/home/.local/share/relay/consult (not present)
61
+ the directories questions without a project were asked in
62
+ <TMP>/home/.local/share/relay/harness (not present)
63
+ the state of the harnesses relay confines itself (each item's Copilot, Grok or Gemini home)
64
+ <TMP>/home/.config/relay (not present)
65
+ your relay configuration, its local settings (local.json), the installation record and what install saved
66
+ <TMP>/home/.local/share/relay-codex-home (not present) [holds a login (auth.json)]
67
+ relay's Codex home: the Codex login relay's jobs run on, and their Codex sessions
68
+ <TMP>/home/.local/share/relay-codex-pins (not present)
69
+ relay's pinned Codex releases (sealed read-only, so they are made writable first) and the qualifier's results
70
+ <TMP>/home/.config/relay-keys (not present) [holds API keys]
71
+ the API key files relay hands a key-only target (Gemini); local.json can name a key file elsewhere, which is yours to delete
72
+ <TMP>/home/.relay-t (not present)
73
+ relay's private sockets and per-turn state
74
+ <TMP>/home/.rn (not present)
75
+ the short temp directories relay gives Claude's turns
76
+ <TMP>/home/.rsm/q (not present)
77
+ the Codex qualifier's scratch runs
78
+ in each repository relay ran a write job in: the line `.relay/` in .git/info/exclude, and any relay/* branches
79
+
80
+ To remove them by hand, in this order:
81
+ 1. <ROOT>/bin/relay clean
82
+ First, while the state directory is still there. It commits work left in finished jobs' worktrees to
83
+ their branches, removes those worktrees, and deletes relay/* branches that are already merged. It lists
84
+ the unmerged branches it kept, so no work is lost.
85
+ 2. In each of those repositories: `git branch --list 'relay/*'` shows what is left. Merge what you want,
86
+ delete the rest with `git branch -D <branch>`, and delete the line `.relay/` from .git/info/exclude.
87
+ 3. Stop the Codex qualifier's LaunchAgent, if you installed it:
88
+ # none found in ~/Library/LaunchAgents; if you installed one under another name: launchctl bootout gui/$(id -u)/<label>, then delete its plist and <TMP>/home/Library/Logs/relay-codex-qualifier
89
+ 4. Then the rest, after checking each: the ones marked above hold credentials.
90
+ rm -rf <TMP>/home/.local/state/relay
91
+ rm -rf <TMP>/home/.local/share/relay/worktrees
92
+ rm -rf <TMP>/home/.local/share/relay/consult
93
+ rm -rf <TMP>/home/.local/share/relay/harness
94
+ rm -rf <TMP>/home/.config/relay
95
+ rm -rf <TMP>/home/.local/share/relay-codex-home
96
+ chmod -R u+w <TMP>/home/.local/share/relay-codex-pins && rm -rf <TMP>/home/.local/share/relay-codex-pins
97
+ rm -rf <TMP>/home/.config/relay-keys
98
+ rm -rf <TMP>/home/.relay-t
99
+ rm -rf <TMP>/home/.rn
100
+ chmod -R u+w <TMP>/home/.rsm/q && rm -rf <TMP>/home/.rsm/q
101
+ --- stderr
102
+
103
+ $ relay uninstall claude-desktop --force
104
+ exit status 0
105
+ --- stdout
106
+ # no installation record for the Claude desktop app; going by what is installed
107
+ # remove mcpServers.relay-desktop from <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json
108
+
109
+ Nothing was changed. Re-run with --write to apply.
110
+ Start the app again: open -a Claude
111
+
112
+ Not removed, because it can hold your work or your logins:
113
+ <TMP>/home/.local/state/relay (not present)
114
+ relay's state: the registry of runs, logs, the prompts sent and the transcripts
115
+ <TMP>/home/.local/share/relay/worktrees (not present)
116
+ the worktrees of write jobs
117
+ <TMP>/home/.local/share/relay/consult (not present)
118
+ the directories questions without a project were asked in
119
+ <TMP>/home/.local/share/relay/harness (not present)
120
+ the state of the harnesses relay confines itself (each item's Copilot, Grok or Gemini home)
121
+ <TMP>/home/.config/relay (not present)
122
+ your relay configuration, its local settings (local.json), the installation record and what install saved
123
+ <TMP>/home/.local/share/relay-codex-home (not present) [holds a login (auth.json)]
124
+ relay's Codex home: the Codex login relay's jobs run on, and their Codex sessions
125
+ <TMP>/home/.local/share/relay-codex-pins (not present)
126
+ relay's pinned Codex releases (sealed read-only, so they are made writable first) and the qualifier's results
127
+ <TMP>/home/.config/relay-keys (not present) [holds API keys]
128
+ the API key files relay hands a key-only target (Gemini); local.json can name a key file elsewhere, which is yours to delete
129
+ <TMP>/home/.relay-t (not present)
130
+ relay's private sockets and per-turn state
131
+ <TMP>/home/.rn (not present)
132
+ the short temp directories relay gives Claude's turns
133
+ <TMP>/home/.rsm/q (not present)
134
+ the Codex qualifier's scratch runs
135
+ in each repository relay ran a write job in: the line `.relay/` in .git/info/exclude, and any relay/* branches
136
+
137
+ To remove them by hand, in this order:
138
+ 1. <ROOT>/bin/relay clean
139
+ First, while the state directory is still there. It commits work left in finished jobs' worktrees to
140
+ their branches, removes those worktrees, and deletes relay/* branches that are already merged. It lists
141
+ the unmerged branches it kept, so no work is lost.
142
+ 2. In each of those repositories: `git branch --list 'relay/*'` shows what is left. Merge what you want,
143
+ delete the rest with `git branch -D <branch>`, and delete the line `.relay/` from .git/info/exclude.
144
+ 3. Stop the Codex qualifier's LaunchAgent, if you installed it:
145
+ # none found in ~/Library/LaunchAgents; if you installed one under another name: launchctl bootout gui/$(id -u)/<label>, then delete its plist and <TMP>/home/Library/Logs/relay-codex-qualifier
146
+ 4. Then the rest, after checking each: the ones marked above hold credentials.
147
+ rm -rf <TMP>/home/.local/state/relay
148
+ rm -rf <TMP>/home/.local/share/relay/worktrees
149
+ rm -rf <TMP>/home/.local/share/relay/consult
150
+ rm -rf <TMP>/home/.local/share/relay/harness
151
+ rm -rf <TMP>/home/.config/relay
152
+ rm -rf <TMP>/home/.local/share/relay-codex-home
153
+ chmod -R u+w <TMP>/home/.local/share/relay-codex-pins && rm -rf <TMP>/home/.local/share/relay-codex-pins
154
+ rm -rf <TMP>/home/.config/relay-keys
155
+ rm -rf <TMP>/home/.relay-t
156
+ rm -rf <TMP>/home/.rn
157
+ chmod -R u+w <TMP>/home/.rsm/q && rm -rf <TMP>/home/.rsm/q
158
+ --- stderr
@@ -0,0 +1,101 @@
1
+ $ relay install claude-desktop
2
+ exit status 1
3
+ --- stdout
4
+ # mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json:
5
+ {
6
+ "command": "<ROOT>/bin/relay",
7
+ "args": [
8
+ "mcp",
9
+ "--host",
10
+ "claude",
11
+ "--desktop"
12
+ ],
13
+ "env": {
14
+ "PATH": "<NODE_DIR>:<TMP>/bin:/usr/bin:/usr/local/bin:/bin:/usr/sbin:/sbin"
15
+ }
16
+ }
17
+ # relay-desktop is the desktop app's own relay, and is shared. Desktop chats in the main window share one relay process. Cowork, the Code tab's in-app bridge, remote Cowork and widgets share a second. Within each process every conversation carries its own session token, which keeps its jobs, approval requests and events apart from the others'. Code-tab sessions also have their own dedicated relay registration. The token is a bearer key its model holds: it separates conversations that use relay honestly. Configuration describes the topology; doctor does not observe calls or verify which conversation used it. Claude.app 2.42304.0's code was checked on <DATE>: neither process forwards per-conversation metadata. Pass cwd on merge and on starts (a new ask without it consults in a new, empty directory of its own); no session on this shared entry gets an approval dialog, confirm or notices, and its waits end after 50 s, under the app's 60 s tool timeout (README, "Claude desktop app and Cowork").
18
+ --- stderr
19
+
20
+ relay install claude-desktop: <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json does not exist; open the Claude desktop app once first.
21
+
22
+ Nothing was changed (this was a dry run, and with --write it would have stopped here too).
23
+
24
+ $ relay install claude-desktop --force
25
+ exit status 1
26
+ --- stdout
27
+ # mcpServers.relay-desktop in <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json:
28
+ {
29
+ "command": "<ROOT>/bin/relay",
30
+ "args": [
31
+ "mcp",
32
+ "--host",
33
+ "claude",
34
+ "--desktop"
35
+ ],
36
+ "env": {
37
+ "PATH": "<NODE_DIR>:<TMP>/bin:/usr/bin:/usr/local/bin:/bin:/usr/sbin:/sbin"
38
+ }
39
+ }
40
+ # relay-desktop is the desktop app's own relay, and is shared. Desktop chats in the main window share one relay process. Cowork, the Code tab's in-app bridge, remote Cowork and widgets share a second. Within each process every conversation carries its own session token, which keeps its jobs, approval requests and events apart from the others'. Code-tab sessions also have their own dedicated relay registration. The token is a bearer key its model holds: it separates conversations that use relay honestly. Configuration describes the topology; doctor does not observe calls or verify which conversation used it. Claude.app 2.42304.0's code was checked on <DATE>: neither process forwards per-conversation metadata. Pass cwd on merge and on starts (a new ask without it consults in a new, empty directory of its own); no session on this shared entry gets an approval dialog, confirm or notices, and its waits end after 50 s, under the app's 60 s tool timeout (README, "Claude desktop app and Cowork").
41
+ --- stderr
42
+
43
+ relay install claude-desktop: <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json does not exist; open the Claude desktop app once first.
44
+
45
+ Nothing was changed (this was a dry run, and with --write it would have stopped here too).
46
+
47
+ $ relay uninstall claude-desktop
48
+ exit status 0
49
+ --- stdout
50
+ # no installation record for the Claude desktop app; going by what is installed
51
+ # <TMP>/home/Library/Application Support/Claude/claude_desktop_config.json does not exist
52
+
53
+ Nothing to do: nothing of relay's was found in the Claude desktop app.
54
+
55
+ Not removed, because it can hold your work or your logins:
56
+ <TMP>/home/.local/state/relay (not present)
57
+ relay's state: the registry of runs, logs, the prompts sent and the transcripts
58
+ <TMP>/home/.local/share/relay/worktrees (not present)
59
+ the worktrees of write jobs
60
+ <TMP>/home/.local/share/relay/consult (not present)
61
+ the directories questions without a project were asked in
62
+ <TMP>/home/.local/share/relay/harness (not present)
63
+ the state of the harnesses relay confines itself (each item's Copilot, Grok or Gemini home)
64
+ <TMP>/home/.config/relay (not present)
65
+ your relay configuration, its local settings (local.json), the installation record and what install saved
66
+ <TMP>/home/.local/share/relay-codex-home (not present) [holds a login (auth.json)]
67
+ relay's Codex home: the Codex login relay's jobs run on, and their Codex sessions
68
+ <TMP>/home/.local/share/relay-codex-pins (not present)
69
+ relay's pinned Codex releases (sealed read-only, so they are made writable first) and the qualifier's results
70
+ <TMP>/home/.config/relay-keys (not present) [holds API keys]
71
+ the API key files relay hands a key-only target (Gemini); local.json can name a key file elsewhere, which is yours to delete
72
+ <TMP>/home/.relay-t (not present)
73
+ relay's private sockets and per-turn state
74
+ <TMP>/home/.rn (not present)
75
+ the short temp directories relay gives Claude's turns
76
+ <TMP>/home/.rsm/q (not present)
77
+ the Codex qualifier's scratch runs
78
+ in each repository relay ran a write job in: the line `.relay/` in .git/info/exclude, and any relay/* branches
79
+
80
+ To remove them by hand, in this order:
81
+ 1. <ROOT>/bin/relay clean
82
+ First, while the state directory is still there. It commits work left in finished jobs' worktrees to
83
+ their branches, removes those worktrees, and deletes relay/* branches that are already merged. It lists
84
+ the unmerged branches it kept, so no work is lost.
85
+ 2. In each of those repositories: `git branch --list 'relay/*'` shows what is left. Merge what you want,
86
+ delete the rest with `git branch -D <branch>`, and delete the line `.relay/` from .git/info/exclude.
87
+ 3. Stop the Codex qualifier's LaunchAgent, if you installed it:
88
+ # none found in ~/Library/LaunchAgents; if you installed one under another name: launchctl bootout gui/$(id -u)/<label>, then delete its plist and <TMP>/home/Library/Logs/relay-codex-qualifier
89
+ 4. Then the rest, after checking each: the ones marked above hold credentials.
90
+ rm -rf <TMP>/home/.local/state/relay
91
+ rm -rf <TMP>/home/.local/share/relay/worktrees
92
+ rm -rf <TMP>/home/.local/share/relay/consult
93
+ rm -rf <TMP>/home/.local/share/relay/harness
94
+ rm -rf <TMP>/home/.config/relay
95
+ rm -rf <TMP>/home/.local/share/relay-codex-home
96
+ chmod -R u+w <TMP>/home/.local/share/relay-codex-pins && rm -rf <TMP>/home/.local/share/relay-codex-pins
97
+ rm -rf <TMP>/home/.config/relay-keys
98
+ rm -rf <TMP>/home/.relay-t
99
+ rm -rf <TMP>/home/.rn
100
+ chmod -R u+w <TMP>/home/.rsm/q && rm -rf <TMP>/home/.rsm/q
101
+ --- stderr