@jbkjr/relay 0.0.0-stage → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/LICENSES/Apache-2.0.txt +201 -0
- package/LICENSES/README.md +19 -0
- package/LICENSES/codex-NOTICE.txt +6 -0
- package/README.md +393 -2
- package/SECURITY.md +145 -0
- package/adapters/briefs/claude.md +43 -0
- package/adapters/briefs/codex.md +56 -0
- package/adapters/briefs/models.json +33 -0
- package/adapters/build.mjs +8 -0
- package/adapters/claude/.claude-plugin/marketplace.json +13 -0
- package/adapters/claude/relay/.claude-plugin/plugin.json +5 -0
- package/adapters/claude/relay/agents/codex.md +21 -0
- package/adapters/claude/relay/agents/operator.md +21 -0
- package/adapters/claude/relay/skills/ask/SKILL.md +20 -0
- package/adapters/claude/relay/skills/chat/SKILL.md +13 -0
- package/adapters/claude/relay/skills/delegate/SKILL.md +21 -0
- package/adapters/claude/relay/skills/discuss/SKILL.md +19 -0
- package/adapters/claude/relay/skills/review/SKILL.md +21 -0
- package/adapters/claude/relay/skills/tree/SKILL.md +10 -0
- package/adapters/claude/relay/skills/write-for-codex/SKILL.md +78 -0
- package/adapters/codex/.agents/plugins/marketplace.json +20 -0
- package/adapters/codex/AGENTS.snippet.md +5 -0
- package/adapters/codex/relay/.codex-plugin/plugin.json +6 -0
- package/adapters/codex/relay/skills/relay-ask/SKILL.md +20 -0
- package/adapters/codex/relay/skills/relay-chat/SKILL.md +13 -0
- package/adapters/codex/relay/skills/relay-delegate/SKILL.md +21 -0
- package/adapters/codex/relay/skills/relay-discuss/SKILL.md +19 -0
- package/adapters/codex/relay/skills/relay-review/SKILL.md +21 -0
- package/adapters/codex/relay/skills/relay-tree/SKILL.md +10 -0
- package/adapters/codex/relay/skills/relay-write-for-claude/SKILL.md +66 -0
- package/adapters/generate.mjs +124 -0
- package/bin/relay +59 -0
- package/codex-pin.json +12 -0
- package/dist/backends/acp.js +1424 -0
- package/dist/backends/claude.js +890 -0
- package/dist/backends/cli-version.js +112 -0
- package/dist/backends/codex-app.js +1539 -0
- package/dist/backends/codex-daybreak.js +75 -0
- package/dist/backends/codex-env.js +656 -0
- package/dist/backends/codex-network.js +304 -0
- package/dist/backends/codex-pin.js +345 -0
- package/dist/backends/codex-shell-policy.js +182 -0
- package/dist/backends/codex-stage2.js +998 -0
- package/dist/backends/codex-subagents.js +47 -0
- package/dist/backends/codex.js +641 -0
- package/dist/backends/copilot.js +246 -0
- package/dist/backends/env.js +147 -0
- package/dist/backends/gemini.js +607 -0
- package/dist/backends/grok.js +337 -0
- package/dist/backends/index.js +8 -0
- package/dist/backends/native-temp.js +187 -0
- package/dist/backends/never-admission.js +90 -0
- package/dist/backends/run.js +67 -0
- package/dist/backends/stream.js +230 -0
- package/dist/backends/tool-discovery.js +15 -0
- package/dist/backends/types.js +264 -0
- package/dist/build-info.json +5 -0
- package/dist/cli.js +344 -0
- package/dist/confine/bridge.js +113 -0
- package/dist/confine/broker-core.js +76 -0
- package/dist/confine/broker-http.js +650 -0
- package/dist/confine/broker-names.js +9 -0
- package/dist/confine/broker.js +258 -0
- package/dist/confine/canary.js +380 -0
- package/dist/confine/diagnostics.js +122 -0
- package/dist/confine/gemini-tools-main.js +8 -0
- package/dist/confine/gemini-tools.js +181 -0
- package/dist/confine/hardlinks.js +58 -0
- package/dist/confine/harness-config.js +16 -0
- package/dist/confine/index.js +117 -0
- package/dist/confine/leases.js +217 -0
- package/dist/confine/paths.js +6 -0
- package/dist/confine/peer.js +115 -0
- package/dist/confine/port-policy.js +8 -0
- package/dist/confine/ports.js +365 -0
- package/dist/confine/private-root.js +208 -0
- package/dist/confine/probe-stage2.js +501 -0
- package/dist/confine/probe.js +1109 -0
- package/dist/confine/proxy.js +783 -0
- package/dist/confine/sbcheck.js +208 -0
- package/dist/confine/seatbelt-never.js +41 -0
- package/dist/confine/seatbelt-stage2.js +139 -0
- package/dist/confine/seatbelt.js +1129 -0
- package/dist/confine/sockets.js +36 -0
- package/dist/confine/turn-probe.js +19 -0
- package/dist/confine/turn.js +86 -0
- package/dist/core/adoption.js +124 -0
- package/dist/core/api-keys.js +423 -0
- package/dist/core/approvals.js +740 -0
- package/dist/core/build-identity.js +248 -0
- package/dist/core/caller.js +749 -0
- package/dist/core/calls.js +102 -0
- package/dist/core/claude-settings.js +1045 -0
- package/dist/core/config.js +453 -0
- package/dist/core/context.js +186 -0
- package/dist/core/db.js +753 -0
- package/dist/core/dispatch.js +110 -0
- package/dist/core/env-broker.js +505 -0
- package/dist/core/env-policy.js +182 -0
- package/dist/core/escalation-authority.js +76 -0
- package/dist/core/escalation-contract.js +13 -0
- package/dist/core/escalation-person-path.js +131 -0
- package/dist/core/escalation-policy.js +79 -0
- package/dist/core/escalation-runtime.js +135 -0
- package/dist/core/escalation-state.js +42 -0
- package/dist/core/escalations.js +191 -0
- package/dist/core/events.js +235 -0
- package/dist/core/executables.js +147 -0
- package/dist/core/extensions.js +645 -0
- package/dist/core/families.js +204 -0
- package/dist/core/git.js +657 -0
- package/dist/core/identity.js +113 -0
- package/dist/core/liveness.js +68 -0
- package/dist/core/mediated-network-provider.js +81 -0
- package/dist/core/never-checkpoint.js +76 -0
- package/dist/core/never-coverage.js +97 -0
- package/dist/core/never-network.js +49 -0
- package/dist/core/never-policy.js +302 -0
- package/dist/core/never-proxy-policy.js +109 -0
- package/dist/core/never-schema.js +61 -0
- package/dist/core/never-tools.js +56 -0
- package/dist/core/notices.js +48 -0
- package/dist/core/ops.js +959 -0
- package/dist/core/outcome.js +224 -0
- package/dist/core/params.js +32 -0
- package/dist/core/presence.js +174 -0
- package/dist/core/procs.js +546 -0
- package/dist/core/prompts.js +363 -0
- package/dist/core/protected-config.js +238 -0
- package/dist/core/raw-network.js +192 -0
- package/dist/core/redact.js +152 -0
- package/dist/core/refusal.js +33 -0
- package/dist/core/relay-command.js +310 -0
- package/dist/core/reported.js +3 -0
- package/dist/core/restart-overlay.js +651 -0
- package/dist/core/retention.js +1135 -0
- package/dist/core/secrets.js +329 -0
- package/dist/core/session-token.js +175 -0
- package/dist/core/session.js +744 -0
- package/dist/core/shell.js +2 -0
- package/dist/core/shipped-pin.js +47 -0
- package/dist/core/shown.js +42 -0
- package/dist/core/slots.js +67 -0
- package/dist/core/stage2-executors.js +453 -0
- package/dist/core/stage2-switch.js +5 -0
- package/dist/core/steering.js +149 -0
- package/dist/core/storage.js +358 -0
- package/dist/core/toml.js +175 -0
- package/dist/core/views.js +324 -0
- package/dist/core/wait.js +114 -0
- package/dist/core/wake.js +207 -0
- package/dist/core/watch.js +247 -0
- package/dist/core/worktree.js +213 -0
- package/dist/hosts/claude-desktop.js +274 -0
- package/dist/hosts/claude.js +249 -0
- package/dist/hosts/codex.js +345 -0
- package/dist/hosts/desktop-shared.js +20 -0
- package/dist/hosts/index.js +11 -0
- package/dist/hosts/types.js +4 -0
- package/dist/install/basics.js +18 -0
- package/dist/install/claude-init.js +133 -0
- package/dist/install/common.js +655 -0
- package/dist/install/doctor.js +635 -0
- package/dist/install/qualify-codex.js +205 -0
- package/dist/install.js +524 -0
- package/dist/mcp/elicit.js +209 -0
- package/dist/mcp/gateway.js +218 -0
- package/dist/mcp/host.js +253 -0
- package/dist/mcp/server.js +1124 -0
- package/dist/mcp/stdio.js +37 -0
- package/dist/modes/discussion.js +393 -0
- package/dist/modes/review.js +722 -0
- package/dist/native/relay-sbcheck +0 -0
- package/dist/targets/briefs.js +86 -0
- package/dist/targets/claude.js +94 -0
- package/dist/targets/codex.js +66 -0
- package/dist/targets/copilot.js +93 -0
- package/dist/targets/gemini.js +119 -0
- package/dist/targets/grok.js +126 -0
- package/dist/targets/index.js +192 -0
- package/dist/targets/types.js +18 -0
- package/dist/targets/verified.js +35 -0
- package/dist/worker.js +113 -0
- package/docs/UPGRADING.md +1518 -0
- package/docs/pinned-codex.md +333 -0
- package/experiments/stage2-redteam/lib/oracles.mjs +214 -0
- package/experiments/stage2-redteam/lib/report.mjs +35 -0
- package/npm-shrinkwrap.json +1632 -0
- package/package.json +82 -4
- package/scripts/codex-qualify/codex-pin-store.mjs +353 -0
- package/scripts/codex-qualify/codex-qualifier-process.mjs +265 -0
- package/scripts/codex-qualify/codex-qualifier.example.json +5 -0
- package/scripts/codex-qualify/codex-qualifier.mjs +281 -0
- package/scripts/codex-qualify/codex-shipped-pin.mjs +158 -0
- package/scripts/codex-qualify/codex-stage2-pin.mjs +48 -0
- package/scripts/codex-qualify/codex-stage2.mjs +2381 -0
- package/scripts/codex-qualify/install-codex-qualifier.mjs +98 -0
- package/scripts/codex-qualify/main-module.mjs +14 -0
- package/scripts/codex-qualify/relay-codex-qualifier.plist +37 -0
- package/scripts/codex-qualify/scratch-env.mjs +31 -0
- package/scripts/codex-qualify/session.mjs +96 -0
- package/scripts/codex-qualify/stage2-escalation-cases.mjs +125 -0
- package/test/codex-permissions.test.ts +875 -0
- package/test/fixtures/boundary-probes.mjs +17 -0
- package/test/fixtures/denial-stream-host.mjs +7 -0
- package/test/fixtures/families.json +246 -0
- package/test/fixtures/install-snapshots/claude-desktop-foreign.txt +158 -0
- package/test/fixtures/install-snapshots/claude-desktop-fresh.txt +101 -0
- package/test/fixtures/install-snapshots/claude-desktop-installed.txt +161 -0
- package/test/fixtures/install-snapshots/claude-foreign.txt +133 -0
- package/test/fixtures/install-snapshots/claude-fresh.txt +77 -0
- package/test/fixtures/install-snapshots/claude-installed.txt +133 -0
- package/test/fixtures/install-snapshots/codex-foreign.txt +159 -0
- package/test/fixtures/install-snapshots/codex-fresh.txt +107 -0
- package/test/fixtures/install-snapshots/codex-installed.txt +161 -0
- package/test/fixtures/link-parent.mjs +6 -0
- package/test/fixtures/mediated-command.cjs +72 -0
- package/test/fixtures/native-skill-isolation.json +280 -0
- package/test/fixtures/pinned-codex-app-server.mjs +25 -0
- package/test/fixtures/qualified-ext-adapters.mjs +36 -0
- package/test/fixtures/refusals/README.md +52 -0
- package/test/fixtures/refusals/claude-source-result.json +7 -0
- package/test/fixtures/refusals/openai-app-capacity.json +24 -0
- package/test/fixtures/refusals/openai-app-cyberPolicy.json +24 -0
- package/test/fixtures/refusals/openai-gpt-6-astra-max.json +12 -0
- package/test/fixtures/refusals/openai-gpt-6.1-sol-xhigh.json +12 -0
- package/test/fixtures/refusals/openai-review-capacity.json +24 -0
- package/test/fixtures/relay-0.2.0.sql +57 -0
- package/test/fixtures/relay-0.9.1.gen.mjs +212 -0
- package/test/fixtures/relay-0.9.1.sql +340 -0
- package/test/fixtures/slow-boundary-probes.mjs +37 -0
- package/test/fixtures/stable-surfaces/config.json +1122 -0
- package/test/fixtures/stable-surfaces/escalation.json +128 -0
- package/test/fixtures/stable-surfaces/events.json +37 -0
- package/test/fixtures/stable-surfaces/gemini-native-resume.json +4 -0
- package/test/fixtures/stable-surfaces/inbox.jsonl +2 -0
- package/test/fixtures/stable-surfaces/notice.txt +1 -0
- package/test/fixtures/stable-surfaces/refusal-item.json +28 -0
- package/test/fixtures/stable-surfaces/refusal-review.json +23 -0
- package/test/fixtures/stable-surfaces/registry.json +49 -0
- package/test/fixtures/stable-surfaces/tools-desktop.json +575 -0
- package/test/fixtures/stable-surfaces/tools.json +716 -0
- package/test/fixtures/stable-surfaces/usage.txt +46 -0
- package/test/fixtures/stage2-acp-native.mjs +138 -0
- package/test/fixtures/stage2-app-server.mjs +23 -0
- package/test/fixtures/stage2-catalog.json +91 -0
- package/test/fixtures/stage2-hostile-web.mjs +35 -0
- package/test/fixtures/stage2-native-network.mjs +62 -0
- package/test/fixtures/stage2-worker.ts +87 -0
- package/test/fixtures/status-views/expected.json +7825 -0
- package/test/fixtures/status-views/registries.json +1 -0
- package/test/fixtures/steering.json +209 -0
- package/test/helpers.ts +740 -0
- package/test/host-env.ts +7 -0
- package/test/keychain-decoy.ts +197 -0
- package/test/live-scope.ts +44 -0
- package/test/mediated-network.test.ts +192 -0
- package/test/mediated-proxy.test.ts +264 -0
- package/test/native-temp-alias.ts +10 -0
- package/test/never-policy.test.ts +629 -0
- package/test/never-tools.test.ts +136 -0
- package/test/process-home.ts +18 -0
- package/test/proxy.test.ts +531 -0
- package/test/restart-overlay-live.test.ts +85 -0
- package/test/restart-overlay-profile.test.ts +66 -0
- package/test/restart-overlay.test.ts +416 -0
- package/test/stable-surfaces.test.ts +249 -0
- package/test/stage2-escalation-live.test.ts +544 -0
- package/test/stage2-escalation-qualification.test.ts +170 -0
- package/test/stage2-escalation.test.ts +747 -0
- package/test/stage2-executor.test.ts +849 -0
- package/test/stage2-grant.test.ts +603 -0
- package/test/stage2-native-live.test.ts +647 -0
- package/test/stage2-network-decisions.test.ts +70 -0
- package/test/stage2-probe.test.ts +845 -0
- package/test/stage2-standing-live.test.ts +203 -0
- package/test/stubs/broker-host.mjs +59 -0
- package/test/stubs/broker-peer.mjs +20 -0
- package/test/stubs/confined-harness.mjs +91 -0
- package/test/stubs/ext-broken-server.mjs +2 -0
- package/test/stubs/ext-odd-server.mjs +21 -0
- package/test/stubs/ext-server.mjs +31 -0
- package/test/stubs/fake-host-cli.mjs +218 -0
- package/test/stubs/procargs.mjs +30 -0
- package/test/stubs/stub-acp +4 -0
- package/test/stubs/stub-agent.mjs +322 -0
- package/test/stubs/stub-claude +4 -0
- package/test/stubs/stub-codex +4 -0
- package/test/stubs/targets/acp.mjs +307 -0
- package/test/stubs/targets/claude.mjs +149 -0
- package/test/stubs/targets/codex.mjs +479 -0
- package/test/stubs/targets/gemini.mjs +604 -0
- package/test/temp-root.ts +11 -0
- package/test/wp4-adapters.test.ts +353 -0
- 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
|