@akshar5/cohall 0.5.6 → 0.6.1

package/docs/install.md

@@ -125,8 +125,8 @@ executable, so it refuses temporary package-runner and source-checkout paths.
 
 ## Providers
 
-Target devices advertise provider executables they can find. Authentication is
-checked when delegated work starts.
+Target devices advertise installed coding providers. Authentication is checked
+when delegated work starts.
 
 | Provider    | Required command | Session continuation     |
 | ----------- | ---------------- | ------------------------ |
@@ -134,6 +134,13 @@ checked when delegated work starts.
 | Claude Code | `claude`         | `claude --resume`        |
 | OpenCode    | `opencode`       | `opencode run --session` |
 
+The experimental `grok-bot` provider connects to named Bots through their
+computer's local gateway. Configure it with `cohall configure --grok-gateway
+<absolute-path> --providers codex,grok-bot` and restart the worker. See
+[Grok Bot setup and messaging](../README.md#talk-to-your-grok-bots) for discovery,
+callbacks, and upgrade order. Bot model selection and permissions remain with
+Grok Bot.
+
 Limit a device to providers configured for that user:
 
 ```bash
@@ -144,7 +151,7 @@ cohall configure --providers auto
 ## Configuration
 
 `cohall config` shows stored configuration without tokens. `cohall configure`
-changes the device name, workspace roots, providers, model, sandbox, or relay
+changes the device name, workspace roots, providers, Grok gateway path, model, sandbox, or relay
 for a fresh pairing. Use `cohall relay use <url>` when moving an existing relay;
 it preserves credentials only after verifying them at the restored address.
 Non-loopback HTTP is refused unless `--allow-http` explicitly confirms that an
@@ -178,6 +185,8 @@ Environment variables override stored values:
 | `COHALL_MODEL`                            | Target provider model override                 |
 | `COHALL_SANDBOX`                          | Codex sandbox override                         |
 | `COHALL_THREAD_ID`                        | Inherited thread for nested delegation         |
+| `COHALL_TASK_ID`                          | Inherited parent task for nested delegation    |
+| `COHALL_GROK_GATEWAY`                     | Local Grok Bot gateway discovery file          |
 | `COHALL_DATA_DIR`                         | Relay database and owner-token directory       |
 | `COHALL_RELAY_HOST` / `COHALL_RELAY_PORT` | Relay listener                                 |
 | `COHALL_RELAY_ALLOW_REMOTE`               | Explicit non-loopback binding opt-in           |
@@ -206,6 +215,17 @@ plan, or `--no-restart` to leave services pending a manual restart. Back up a
 production relay's data directory before an upgrade because SQLite migrations
 run in place.
 
+An exact version already installed on disk skips package installation and still
+restarts active services. Dry runs and failed installations preserve restart
+recovery state. A new explicit version takes precedence over an older recovery
+record.
+
+Upgrade tools use the first PATH candidate that passes ownership and permission
+checks. Unsafe candidates are skipped; an explicit executable path must pass
+those checks itself. Linux user namespaces may hide root ownership of fixed OS
+directories, but user-installed executables still require trusted ownership and
+permissions.
+
 The relay owner can queue the same built-in upgrade across every registered
 device:
 

package/docs/integrations.md

@@ -20,6 +20,11 @@ This installs the embedded skill into:
 Any other harness with shell access can invoke the CLI directly. No Cohall UI
 extension is required.
 
+Use `cohall bots` to discover named Grok Bots and `cohall send @BotName` to
+message one. MCP exposes the same discovery through `list_bots`; `delegate`
+infers `grok-bot` from a Bot target. See [Grok Bot setup](../README.md#talk-to-your-grok-bots)
+for the required host gateway and local reply callback.
+
 When delegating from a conversation, the sending agent must distill why the user
 is asking, relevant facts and prior findings, constraints, and the intended
 decision into Cohall's `context` field. Cohall cannot read the harness transcript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akshar5/cohall",
-  "version": "0.5.6",
+  "version": "0.6.1",
   "description": "Let coding agents delegate work across your own devices.",
   "keywords": [
     "agents",