@hydra-acp/cli 0.1.188 → 0.1.189

package/README.md

@@ -220,6 +220,35 @@ and setting `daemon.publicHost` to the name the URL should carry. See
 [Security](#security). Without that, `share` still prints a URL and warns you
 that it's loopback-only.
 
+### Linking machines
+
+`session share` is a one-off: it hands out a URL for a single session.
+`hydra-acp remote add` is the persistent version, git-remote style — it
+federates your daemon with a peer's under a local name, so the peer's
+sessions show up in `session list --host=<name>` (or `--host=all`) and can be
+attached with `--session <name>:<localId>`, as well as showing up in hydra
+session lists in TUI:
+
+```sh
+hydra-acp remote add box peer.local
+hydra-acp session list --host=box
+hydra-acp --session box:hydra_session_abc123
+```
+
+The host arg is `host[:port]`; the port defaults to the daemon's usual
+`55514` when omitted. Two things have to be true on the peer (`peer.local`)
+before this works:
+
+- It has a master password set — `hydra-acp auth password` on that machine.
+  `remote add` prompts you for it once, exchanges it for a long-lived token,
+  and stores that token.
+- If it's not loopback, it needs TLS configured as in [Security](#security).
+  `remote add` does a TOFU handshake first.
+
+The exchanged token expires; `remote list` shows when. Re-run `remote add`
+with the same name before then to refresh it. `remote remove` un-federates
+and revokes the token on the peer.
+
 ## Compaction and recall
 
 Long sessions run into the model's context window. When a session's history
@@ -582,6 +611,8 @@ one is to sit on that row and walk through them. Eighteen ship built in, and
 
 `tui.defaultEnterAction` (default `"amend"`) controls what the unmodified Enter key does in the prompt composer. With `"amend"` (the default), Enter amends the in-flight turn and `Shift+Enter` enqueues a new prompt; with no turn in flight either key just enqueues, since there's nothing to amend. Set to `"enqueue"` to flip the two: Enter enqueues (sends immediately when idle, queues behind an in-flight turn) and `Shift+Enter` amends.
 
+`tui.defaultHost` (default `"local"`) sets which host bucket the session picker opens on, before `h` cycles it. `"local"` is sessions created or bound on this machine, `"all"` drops the host filter, and `"remote:all"` is local plus every `hydra remote`'s live sessions without imported-machine mirrors. `"remote:<name>"` and `"host:<name>"` pick one remote or one imported machine; a bare name is a remote of that name, else an imported machine. A value that nothing backs at picker-open time falls back to `"local"`. TUI-only: `hydra session list --host` keeps its own `"local"` default.
+
 `tui.skipPermissions` (default `false`) makes `--dangerously-skip-permissions` the standing default for the TUI: every tool permission request is auto-approved (with `allow_once`, so nothing is written to the agent's persisted permission rules) and the modal never appears. The startup banner names the config key so it isn't silent. TUI-only on purpose: `shim`, `launch`, and `cat` are spawned by editors and scripts with their own argv, and an ambient config key there would disarm paths you aren't watching. Pass `--no-dangerously-skip-permissions` to get the prompts back for a single run.
 
 ## Extensions
@@ -963,49 +994,14 @@ For remote access (binding to a non-loopback address), enable TLS via:
 }
 ```
 
-The daemon refuses to bind to non-loopback hosts without TLS configured.
+The daemon refuses to bind to non-loopback hosts without TLS configured. A
+self-signed cert is enough, since `remote add`'s TOFU handshake only needs a
+key pair to pin, not a CA-signed one:
 
-## Registry entry mockup
-
-If accepted, `hydra-acp` could land in the [ACP Registry](https://github.com/agentclientprotocol/registry):
-
-```json
-{
-  "id": "hydra-acp",
-  "name": "Hydra ACP",
-  "version": "0.1.0",
-  "description": "Multi-client session daemon. Spawn agents, attach over WSS, multiplex sessions across editors.",
-  "authors": ["Sam Magnuson"],
-  "license": "MIT",
-  "icon": "icon.svg",
-  "repository": "https://github.com/smagnuso/hydra-acp",
-  "website": "https://github.com/smagnuso/hydra-acp",
-  "distribution": {
-    "npx": {
-      "package": "@hydra-acp/cli",
-      "args": ["shim"]
-    }
-  },
-  "capabilities": {
-    "session": {
-      "attach": {},
-      "list": true,
-      "proxy": true
-    },
-    "transport": {
-      "stdio": true,
-      "websocket": true
-    }
-  }
-}
+```sh
+openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout key.pem -out cert.pem -subj "/CN=$(hostname)"
 ```
 
-The accompanying icon lives at [`assets/icon.svg`](assets/icon.svg) — a single `currentColor`-filled `<path>` rendering the three-headed hydra silhouette. The `viewBox` is 32×32 (so the path supersamples cleanly at the registry's 16×16 display size); the SVG declares `width="16" height="16"` per the [registry rules](https://github.com/agentclientprotocol/registry/blob/main/CONTRIBUTING.md). Source PNG at [`assets/hydra-source.png`](assets/hydra-source.png) is what the silhouette and the README's top-of-page Braille art are both derived from.
-
-## Status
-
-This is an early experiment.
-
 ## License
 
 MIT.