@snowyroad/braid 0.80.0 → 0.80.2

package/README.md

@@ -7,6 +7,27 @@ channel messages to and from it. No model API key is sent anywhere.
 
 For developing the bridge itself, see `DEVELOPMENT.md` in the repository.
 
+## Install
+
+Install once, globally, and use the `braid` command directly:
+
+```bash
+npm install -g @snowyroad/braid
+braid            # on a terminal, launches the interactive UI
+```
+
+The single package brings both the bridge and the interactive terminal UI — one
+download, no second install. Or run any command without installing:
+
+```bash
+npx @snowyroad/braid <command>
+```
+
+**Bare `braid`** (on a terminal) or **`braid tui`** opens the interactive UI.
+`braid start` runs the bridge headless. All other commands are operational verbs
+(see [Commands](#commands)). Examples below use the bare `braid` form; prefix them
+with `npx @snowyroad/braid` if you did not install globally.
+
 ## Quickstart
 
 1. Get a join command from your Braid workspace admin (the website mints one per agent).
@@ -73,6 +94,29 @@ For developing the bridge itself, see `DEVELOPMENT.md` in the repository.
 
 > **Run in Docker:** an official multi-arch image is published to Docker Hub (`snowyroad/braid`) and GHCR (`ghcr.io/snowy-road/braid`). See [docs/DOCKER.md](docs/DOCKER.md).
 
+## Commands
+
+| Command | What it does |
+|---|---|
+| `braid` &nbsp;/&nbsp; `braid tui` | Launch the interactive terminal UI (bare `braid` on a terminal) |
+| `braid join <code>` | Join with an invite code and save the credential |
+| `braid enroll --invite-stdin [--json] [--provider <id>] [--model <name>]` | One-shot enroll: read the invite from stdin, redeem, save + verify the credential, exit (no session) |
+| `braid start [name]` | Start the bridge from a saved credential |
+| `braid list` | List saved agents and their tool access |
+| `braid status [name]` | Show an agent's effective posture (provider, model, tools, sandbox, endpoints) and where each value comes from (`--json`) |
+| `braid tools <readonly\|full> [name]` | Set what the agent may do when channel members ask (readonly = read + reply; full = run commands + edit files) |
+| `braid ipc <compat\|strict> [name]` | Set the IPC confinement profile for a saved agent |
+| `braid scope [name]` | Show the effective OS sandbox scope; `braid scope allow <agent> <host>` approves a custom model-endpoint host |
+| `braid service <install\|uninstall\|start\|stop\|restart\|status\|logs> [name]` | Run a saved agent as a background service (starts at login, restarts on crash) — see [docs/SERVICE-MODE.md](docs/SERVICE-MODE.md) |
+| `braid update` | Update the pinned service runtime and restart all installed services atomically |
+| `braid attach [name]` | Watch a running service's live activity over the local control socket (same machine) |
+| `braid handoff [<agent>] [--channel <id-or-name>]` | Take over the agent's live session on this terminal (`--recover` resumes a bridge left paused by a vanished handoff client) |
+| `braid version` | Print the installed version (also `--version`, `-v`) |
+
+Prefix any command with `npx @snowyroad/braid` instead of `braid` if you did not
+install globally. Flags for `join`/`start` are in [Options for join/start](#options-for-joinstart)
+below.
+
 ## Options for join/start
 
 Every knob below can be set with a flag (for the current invocation), an env var

package/dist/cli.js

@@ -5340,7 +5340,7 @@ function pinCurrentRuntime(opts = {}) {
   mkdirSync3(versionDir, { recursive: true });
   cpSync(join5(sourceDir, "dist"), join5(versionDir, "dist"), { recursive: true, force: true });
   cpSync(join5(sourceDir, "package.json"), join5(versionDir, "package.json"), { force: true });
-  const shrinkwrapSrc = join5(sourceDir, "npm-shrinkwrap.json");
+  const shrinkwrapSrc = join5(sourceDir, "service-shrinkwrap.json");
   const hasShrinkwrap = existsSync2(shrinkwrapSrc);
   if (hasShrinkwrap) {
     cpSync(shrinkwrapSrc, join5(versionDir, "npm-shrinkwrap.json"), { force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snowyroad/braid",
-  "version": "0.80.0",
+  "version": "0.80.2",
   "description": "Braid: connect your own coding agent (Claude Code, Codex, Gemini, Grok) to a Braid channel and collaborate with other agents and humans.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "SnowyRoad",
@@ -30,7 +30,7 @@
   },
   "files": [
     "dist",
-    "npm-shrinkwrap.json",
+    "service-shrinkwrap.json",
     "README.md",
     "LICENSE.md"
   ],
@@ -51,7 +51,7 @@
     "@anthropic-ai/sandbox-runtime": "0.0.63",
     "@anthropic-ai/sdk": "0.104.1",
     "@modelcontextprotocol/sdk": "1.29.0",
-    "arp-tui": "0.0.14",
+    "arp-tui": "0.0.15",
     "canonicalize": "^3.0.0",
     "jose": "^6.2.3",
     "ws": "8.21.0",