From d3e6a4c8a655e50351eb046c9fea9806d89ead02 Mon Sep 17 00:00:00 2001 From: chaodu-agent <274062505+chaodu-agent@users.noreply.github.com> Date: Thu, 29 Oct 2026 16:40:38 +0000 Subject: [PATCH] docs: point reverse-attach links at openab-computer after rename The instance-mcp repository was renamed to openabdev/openab-computer. This commit retargets the reverse-attach ADR references to the new name and changes three prose comments to say "OpenAB Computer". Changes, 7 files, 1 insertion and 1 deletion each: - README.md:100: reverse-attach ADR link now points at openabdev/openab-computer. - docs/k8s-howto.md:152: same ADR link retargeted. - runtime/CLIENT-CONTRACT.md:286: same ADR link retargeted. Only the link changes in section 9; the surrounding prose is not modified. - runtime/src/tools.rs:5: module doc comment ADR reference now names openabdev/openab-computer. - Dockerfile:120: comment prose "instance-mcp tools" -> "OpenAB Computer tools". - deploy/ecs/entrypoint.sh:74: comment prose -> "OpenAB Computer tools". - deploy/k8s/pod-tailscale.yaml:110: comment prose -> "OpenAB Computer". Not changed: executable oab-instance-mcp, bundle id dev.openab.instance-mcp, config and log paths, LaunchAgent labels, release asset names, and docs/adr/ files. No build or test was run; the diff touches only comments, docs, and GitHub URLs. --- Dockerfile | 2 +- README.md | 2 +- deploy/ecs/entrypoint.sh | 2 +- deploy/k8s/pod-tailscale.yaml | 2 +- docs/k8s-howto.md | 2 +- runtime/CLIENT-CONTRACT.md | 2 +- runtime/src/tools.rs | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/Dockerfile b/Dockerfile index 12c1ac1..0f920e3 100644 --- a/Dockerfile +++ b/Dockerfile @@ -117,7 +117,7 @@ ENV HOME=/workspace \ # container has filled with *.tar.gz; this image fetches nothing itself. PTY_SEED_DIR="" \ # Reverse-attached tools plane, off by default. Set to a loopback address - # (e.g. 127.0.0.1:8091) to let a Mac lend its instance-mcp tools to a session + # (e.g. 127.0.0.1:8091) to let a Mac lend its OpenAB Computer tools to a session # through GET /tools/attach/{session}; the CLI then finds them at the URL in # OPENAB_TOOLS_MCP_URL. Off means: no listener, and /tools/attach refuses. PTY_TOOLS_LISTEN="" \ diff --git a/README.md b/README.md index c348433..c0f5962 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,7 @@ session** by dialling in (`WS /tools/attach/{session}`, per-session secret minte by the admin plane); the coding CLI inside the session reaches them through a loopback MCP URL in its environment. The pod initiates nothing and stores only a hash. §9 of the client contract has the wire shape; the design is -[reverse attach](https://github.com/openabdev/instance-mcp/blob/main/docs/adr/reverse-attach.md). +[reverse attach](https://github.com/openabdev/openab-computer/blob/main/docs/adr/reverse-attach.md). A session shell *can* reach the listener over loopback, so the split is what keeps a compromised shell from managing its siblings: the shell never holds the admin diff --git a/deploy/ecs/entrypoint.sh b/deploy/ecs/entrypoint.sh index 479da7d..0e1bf0c 100644 --- a/deploy/ecs/entrypoint.sh +++ b/deploy/ecs/entrypoint.sh @@ -71,7 +71,7 @@ scrollback_replay = false filter_terminal_responses = ${PTY_FILTER_TERMINAL_RESPONSES} admin_credential_hash = "${PTY_ADMIN_HASH}" seed_dir = "${PTY_SEED_DIR:-}" -# Reverse-attached tools (a Mac lends its instance-mcp tools to one session). +# Reverse-attached tools (a Mac lends its OpenAB Computer tools to one session). # Empty disables the plane; the runtime refuses anything but loopback here. tools_listen = "${PTY_TOOLS_LISTEN:-}" tools_attach_ttl = "${PTY_TOOLS_ATTACH_TTL:-24h}" diff --git a/deploy/k8s/pod-tailscale.yaml b/deploy/k8s/pod-tailscale.yaml index 4b398ef..7da3145 100644 --- a/deploy/k8s/pod-tailscale.yaml +++ b/deploy/k8s/pod-tailscale.yaml @@ -107,7 +107,7 @@ spec: value: 12h - name: PTY_IDLE_TTL value: 8h - # Reverse-attached tools (instance-mcp on a Mac dials in and lends its + # Reverse-attached tools (OpenAB Computer on a Mac dials in and lends its # tools to one session). Loopback only; the sidecar forwards inbound # tailnet TCP to any loopback port, so no `serve` config is needed for # GET /tools/attach/{session}. Leave unset to keep the plane off. diff --git a/docs/k8s-howto.md b/docs/k8s-howto.md index ae39265..be7aa88 100644 --- a/docs/k8s-howto.md +++ b/docs/k8s-howto.md @@ -149,7 +149,7 @@ into `~/.kiro/settings/mcp.json` (and `@computer/*` trust into existing agent files), so there is no `mcp add` step; the hook's log lines appear in the runtime's container log at startup. The pod initiates nothing and stores only a hash. Design: -[reverse attach](https://github.com/openabdev/instance-mcp/blob/main/docs/adr/reverse-attach.md); +[reverse attach](https://github.com/openabdev/openab-computer/blob/main/docs/adr/reverse-attach.md); wire contract: §9 of [`../runtime/CLIENT-CONTRACT.md`](../runtime/CLIENT-CONTRACT.md). ```bash diff --git a/runtime/CLIENT-CONTRACT.md b/runtime/CLIENT-CONTRACT.md index 5313ad1..5a64b5d 100644 --- a/runtime/CLIENT-CONTRACT.md +++ b/runtime/CLIENT-CONTRACT.md @@ -283,7 +283,7 @@ a takeover. This section is for a **different client**: not the terminal, but the machine whose tools a coding CLI inside a session should be able to call — in practice `oab-instance-mcp` on a Mac. Design of record: -[reverse attach](https://github.com/openabdev/instance-mcp/blob/main/docs/adr/reverse-attach.md). +[reverse attach](https://github.com/openabdev/openab-computer/blob/main/docs/adr/reverse-attach.md). The rule that shaped it: **the pod initiates nothing.** The Mac dials in, the pod stores only a hash, and the CLI talks to a loopback URL with no credential in it. diff --git a/runtime/src/tools.rs b/runtime/src/tools.rs index 8b1ffc6..e407aef 100644 --- a/runtime/src/tools.rs +++ b/runtime/src/tools.rs @@ -2,7 +2,7 @@ //! session by **dialling in**, and the coding CLI inside that session reaches //! them over a plain loopback MCP endpoint. //! -//! Design of record: `docs/adr/reverse-attach.md` in `openabdev/instance-mcp`; +//! Design of record: `docs/adr/reverse-attach.md` in `openabdev/openab-computer`; //! runtime issue openabdev/openab-pty#37. The shape, and why each half is where //! it is: //!