@poolzin/pool-bot 1.28.0 → 2026.1.26

package/docs/cli/devices.md

@@ -1,55 +1,55 @@
 ---
-summary: "CLI reference for `moltbot devices` (device pairing + token rotation/revocation)"
+summary: "CLI reference for `clawdbot devices` (device pairing + token rotation/revocation)"
 read_when:
   - You are approving device pairing requests
   - You need to rotate or revoke device tokens
 ---
 
-# `moltbot devices`
+# `clawdbot devices`
 
 Manage device pairing requests and device-scoped tokens.
 
 ## Commands
 
-### `moltbot devices list`
+### `clawdbot devices list`
 
 List pending pairing requests and paired devices.
 
 ```
-moltbot devices list
-moltbot devices list --json
+clawdbot devices list
+clawdbot devices list --json
 ```
 
-### `moltbot devices approve <requestId>`
+### `clawdbot devices approve <requestId>`
 
 Approve a pending device pairing request.
 
 ```
-moltbot devices approve <requestId>
+clawdbot devices approve <requestId>
 ```
 
-### `moltbot devices reject <requestId>`
+### `clawdbot devices reject <requestId>`
 
 Reject a pending device pairing request.
 
 ```
-moltbot devices reject <requestId>
+clawdbot devices reject <requestId>
 ```
 
-### `moltbot devices rotate --device <id> --role <role> [--scope <scope...>]`
+### `clawdbot devices rotate --device <id> --role <role> [--scope <scope...>]`
 
 Rotate a device token for a specific role (optionally updating scopes).
 
 ```
-moltbot devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write
+clawdbot devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write
 ```
 
-### `moltbot devices revoke --device <id> --role <role>`
+### `clawdbot devices revoke --device <id> --role <role>`
 
 Revoke a device token for a specific role.
 
 ```
-moltbot devices revoke --device <deviceId> --role node
+clawdbot devices revoke --device <deviceId> --role node
 ```
 
 ## Common options

package/docs/cli/directory.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot directory` (self, peers, groups)"
+summary: "CLI reference for `clawdbot directory` (self, peers, groups)"
 read_when:
   - You want to look up contacts/groups/self ids for a channel
   - You are developing a channel directory adapter
 ---
 
-# `moltbot directory`
+# `clawdbot directory`
 
 Directory lookups for channels that support it (contacts/peers, groups, and “me”).
 
@@ -15,15 +15,15 @@ Directory lookups for channels that support it (contacts/peers, groups, and “m
 - `--json`: output JSON
 
 ## Notes
-- `directory` is meant to help you find IDs you can paste into other commands (especially `moltbot message send --target ...`).
+- `directory` is meant to help you find IDs you can paste into other commands (especially `clawdbot message send --target ...`).
 - For many channels, results are config-backed (allowlists / configured groups) rather than a live provider directory.
 - Default output is `id` (and sometimes `name`) separated by a tab; use `--json` for scripting.
 
 ## Using results with `message send`
 
 ```bash
-moltbot directory peers list --channel slack --query "U0"
-moltbot message send --channel slack --target user:U012ABCDEF --message "hello"
+clawdbot directory peers list --channel slack --query "U0"
+clawdbot message send --channel slack --target user:U012ABCDEF --message "hello"
 ```
 
 ## ID formats (by channel)
@@ -40,21 +40,21 @@ moltbot message send --channel slack --target user:U012ABCDEF --message "hello"
 ## Self (“me”)
 
 ```bash
-moltbot directory self --channel zalouser
+clawdbot directory self --channel zalouser
 ```
 
 ## Peers (contacts/users)
 
 ```bash
-moltbot directory peers list --channel zalouser
-moltbot directory peers list --channel zalouser --query "name"
-moltbot directory peers list --channel zalouser --limit 50
+clawdbot directory peers list --channel zalouser
+clawdbot directory peers list --channel zalouser --query "name"
+clawdbot directory peers list --channel zalouser --limit 50
 ```
 
 ## Groups
 
 ```bash
-moltbot directory groups list --channel zalouser
-moltbot directory groups list --channel zalouser --query "work"
-moltbot directory groups members --channel zalouser --group-id <id>
+clawdbot directory groups list --channel zalouser
+clawdbot directory groups list --channel zalouser --query "work"
+clawdbot directory groups members --channel zalouser --group-id <id>
 ```

package/docs/cli/dns.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot dns` (wide-area discovery helpers)"
+summary: "CLI reference for `clawdbot dns` (wide-area discovery helpers)"
 read_when:
   - You want wide-area discovery (DNS-SD) via Tailscale + CoreDNS
-  - You’re setting up split DNS for moltbot.internal
+  - You’re setting up split DNS for clawdbot.internal
 ---
 
-# `moltbot dns`
+# `clawdbot dns`
 
 DNS helpers for wide-area discovery (Tailscale + CoreDNS). Currently focused on macOS + Homebrew CoreDNS.
 
@@ -16,7 +16,7 @@ Related:
 ## Setup
 
 ```bash
-moltbot dns setup
-moltbot dns setup --apply
+clawdbot dns setup
+clawdbot dns setup --apply
 ```
 

package/docs/cli/docs.md

@@ -1,15 +1,15 @@
 ---
-summary: "CLI reference for `moltbot docs` (search the live docs index)"
+summary: "CLI reference for `clawdbot docs` (search the live docs index)"
 read_when:
-  - You want to search the live Pool Bot docs from the terminal
+  - You want to search the live Clawdbot docs from the terminal
 ---
 
-# `moltbot docs`
+# `clawdbot docs`
 
 Search the live docs index.
 
 ```bash
-moltbot docs browser extension
-moltbot docs sandbox allowHostControl
+clawdbot docs browser extension
+clawdbot docs sandbox allowHostControl
 ```
 

package/docs/cli/doctor.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot doctor` (health checks + guided repairs)"
+summary: "CLI reference for `clawdbot doctor` (health checks + guided repairs)"
 read_when:
   - You have connectivity/auth issues and want guided fixes
   - You updated and want a sanity check
 ---
 
-# `moltbot doctor`
+# `clawdbot doctor`
 
 Health checks + quick fixes for the gateway and channels.
 
@@ -16,14 +16,14 @@ Related:
 ## Examples
 
 ```bash
-moltbot doctor
-moltbot doctor --repair
-moltbot doctor --deep
+clawdbot doctor
+clawdbot doctor --repair
+clawdbot doctor --deep
 ```
 
 Notes:
 - Interactive prompts (like keychain/OAuth fixes) only run when stdin is a TTY and `--non-interactive` is **not** set. Headless runs (cron, Telegram, no terminal) will skip prompts.
-- `--fix` (alias for `--repair`) writes a backup to `~/.clawdbot/moltbot.json.bak` and drops unknown config keys, listing each removal.
+- `--fix` (alias for `--repair`) writes a backup to `~/.clawdbot/clawdbot.json.bak` and drops unknown config keys, listing each removal.
 
 ## macOS: `launchctl` env overrides
 

package/docs/cli/gateway.md

@@ -1,5 +1,5 @@
 ---
-summary: "Pool Bot Gateway CLI (`moltbot gateway`) — run, query, and discover gateways"
+summary: "Clawdbot Gateway CLI (`clawdbot gateway`) — run, query, and discover gateways"
 read_when:
   - Running the Gateway from the CLI (dev or servers)
   - Debugging Gateway auth, bind modes, and connectivity
@@ -8,9 +8,9 @@ read_when:
 
 # Gateway CLI
 
-The Gateway is Pool Bot’s WebSocket server (channels, nodes, sessions, hooks).
+The Gateway is Clawdbot’s WebSocket server (channels, nodes, sessions, hooks).
 
-Subcommands in this page live under `moltbot gateway …`.
+Subcommands in this page live under `clawdbot gateway …`.
 
 Related docs:
 - [/gateway/bonjour](/gateway/bonjour)
@@ -22,17 +22,17 @@ Related docs:
 Run a local Gateway process:
 
 ```bash
-moltbot gateway
+clawdbot gateway
 ```
 
 Foreground alias:
 
 ```bash
-moltbot gateway run
+clawdbot gateway run
 ```
 
 Notes:
-- By default, the Gateway refuses to start unless `gateway.mode=local` is set in `~/.clawdbot/moltbot.json`. Use `--allow-unconfigured` for ad-hoc/dev runs.
+- By default, the Gateway refuses to start unless `gateway.mode=local` is set in `~/.clawdbot/clawdbot.json`. Use `--allow-unconfigured` for ad-hoc/dev runs.
 - Binding beyond loopback without auth is blocked (safety guardrail).
 - `SIGUSR1` triggers an in-process restart when authorized (enable `commands.restart` or use the gateway tool/config apply/update).
 - `SIGINT`/`SIGTERM` handlers stop the gateway process, but they don’t restore any custom terminal state. If you wrap the CLI with a TUI or raw-mode input, restore the terminal before exit.
@@ -76,7 +76,7 @@ Shared options (where supported):
 ### `gateway health`
 
 ```bash
-moltbot gateway health --url ws://127.0.0.1:18789
+clawdbot gateway health --url ws://127.0.0.1:18789
 ```
 
 ### `gateway status`
@@ -84,8 +84,8 @@ moltbot gateway health --url ws://127.0.0.1:18789
 `gateway status` shows the Gateway service (launchd/systemd/schtasks) plus an optional RPC probe.
 
 ```bash
-moltbot gateway status
-moltbot gateway status --json
+clawdbot gateway status
+clawdbot gateway status --json
 ```
 
 Options:
@@ -105,8 +105,8 @@ Options:
 If multiple gateways are reachable, it prints all of them. Multiple gateways are supported when you use isolated profiles/ports (e.g., a rescue bot), but most installs still run a single gateway.
 
 ```bash
-moltbot gateway probe
-moltbot gateway probe --json
+clawdbot gateway probe
+clawdbot gateway probe --json
 ```
 
 #### Remote over SSH (Mac app parity)
@@ -116,7 +116,7 @@ The macOS app “Remote over SSH” mode uses a local port-forward so the remote
 CLI equivalent:
 
 ```bash
-moltbot gateway probe --ssh user@gateway-host
+clawdbot gateway probe --ssh user@gateway-host
 ```
 
 Options:
@@ -133,18 +133,18 @@ Config (optional, used as defaults):
 Low-level RPC helper.
 
 ```bash
-moltbot gateway call status
-moltbot gateway call logs.tail --params '{"sinceMs": 60000}'
+clawdbot gateway call status
+clawdbot gateway call logs.tail --params '{"sinceMs": 60000}'
 ```
 
 ## Manage the Gateway service
 
 ```bash
-moltbot gateway install
-moltbot gateway start
-moltbot gateway stop
-moltbot gateway restart
-moltbot gateway uninstall
+clawdbot gateway install
+clawdbot gateway start
+clawdbot gateway stop
+clawdbot gateway restart
+clawdbot gateway uninstall
 ```
 
 Notes:
@@ -153,10 +153,10 @@ Notes:
 
 ## Discover gateways (Bonjour)
 
-`gateway discover` scans for Gateway beacons (`_moltbot-gw._tcp`).
+`gateway discover` scans for Gateway beacons (`_clawdbot-gw._tcp`).
 
 - Multicast DNS-SD: `local.`
-- Unicast DNS-SD (Wide-Area Bonjour): `moltbot.internal.` (requires split DNS + DNS server; see [/gateway/bonjour](/gateway/bonjour))
+- Unicast DNS-SD (Wide-Area Bonjour): `clawdbot.internal.` (requires split DNS + DNS server; see [/gateway/bonjour](/gateway/bonjour))
 
 Only gateways with Bonjour discovery enabled (default) advertise the beacon.
 
@@ -172,7 +172,7 @@ Wide-Area discovery records include (TXT):
 ### `gateway discover`
 
 ```bash
-moltbot gateway discover
+clawdbot gateway discover
 ```
 
 Options:
@@ -182,6 +182,6 @@ Options:
 Examples:
 
 ```bash
-moltbot gateway discover --timeout 4000
-moltbot gateway discover --json | jq '.beacons[].wsUrl'
+clawdbot gateway discover --timeout 4000
+clawdbot gateway discover --json | jq '.beacons[].wsUrl'
 ```

package/docs/cli/health.md

@@ -1,17 +1,17 @@
 ---
-summary: "CLI reference for `moltbot health` (gateway health endpoint via RPC)"
+summary: "CLI reference for `clawdbot health` (gateway health endpoint via RPC)"
 read_when:
   - You want to quickly check the running Gateway’s health
 ---
 
-# `moltbot health`
+# `clawdbot health`
 
 Fetch health from the running Gateway.
 
 ```bash
-moltbot health
-moltbot health --json
-moltbot health --verbose
+clawdbot health
+clawdbot health --json
+clawdbot health --verbose
 ```
 
 Notes:

package/docs/cli/hooks.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot hooks` (agent hooks)"
+summary: "CLI reference for `clawdbot hooks` (agent hooks)"
 read_when:
   - You want to manage agent hooks
   - You want to install or update hooks
 ---
 
-# `moltbot hooks`
+# `clawdbot hooks`
 
 Manage agent hooks (event-driven automations for commands like `/new`, `/reset`, and gateway startup).
 
@@ -16,7 +16,7 @@ Related:
 ## List All Hooks
 
 ```bash
-moltbot hooks list
+clawdbot hooks list
 ```
 
 List all discovered hooks from workspace, managed, and bundled directories.
@@ -41,7 +41,7 @@ Ready:
 **Example (verbose):**
 
 ```bash
-moltbot hooks list --verbose
+clawdbot hooks list --verbose
 ```
 
 Shows missing requirements for ineligible hooks.
@@ -49,7 +49,7 @@ Shows missing requirements for ineligible hooks.
 **Example (JSON):**
 
 ```bash
-moltbot hooks list --json
+clawdbot hooks list --json
 ```
 
 Returns structured JSON for programmatic use.
@@ -57,7 +57,7 @@ Returns structured JSON for programmatic use.
 ## Get Hook Information
 
 ```bash
-moltbot hooks info <name>
+clawdbot hooks info <name>
 ```
 
 Show detailed information about a specific hook.
@@ -71,7 +71,7 @@ Show detailed information about a specific hook.
 **Example:**
 
 ```bash
-moltbot hooks info session-memory
+clawdbot hooks info session-memory
 ```
 
 **Output:**
@@ -82,10 +82,10 @@ moltbot hooks info session-memory
 Save session context to memory when /new command is issued
 
 Details:
-  Source: moltbot-bundled
-  Path: /path/to/moltbot/hooks/bundled/session-memory/HOOK.md
-  Handler: /path/to/moltbot/hooks/bundled/session-memory/handler.ts
-  Homepage: https://docs.molt.bot/hooks#session-memory
+  Source: clawdbot-bundled
+  Path: /path/to/clawdbot/hooks/bundled/session-memory/HOOK.md
+  Handler: /path/to/clawdbot/hooks/bundled/session-memory/handler.ts
+  Homepage: https://docs.clawd.bot/hooks#session-memory
   Events: command:new
 
 Requirements:
@@ -95,7 +95,7 @@ Requirements:
 ## Check Hooks Eligibility
 
 ```bash
-moltbot hooks check
+clawdbot hooks check
 ```
 
 Show summary of hook eligibility status (how many are ready vs. not ready).
@@ -116,12 +116,12 @@ Not ready: 0
 ## Enable a Hook
 
 ```bash
-moltbot hooks enable <name>
+clawdbot hooks enable <name>
 ```
 
 Enable a specific hook by adding it to your config (`~/.clawdbot/config.json`).
 
-**Note:** Hooks managed by plugins show `plugin:<id>` in `moltbot hooks list` and
+**Note:** Hooks managed by plugins show `plugin:<id>` in `clawdbot hooks list` and
 can’t be enabled/disabled here. Enable/disable the plugin instead.
 
 **Arguments:**
@@ -130,7 +130,7 @@ can’t be enabled/disabled here. Enable/disable the plugin instead.
 **Example:**
 
 ```bash
-moltbot hooks enable session-memory
+clawdbot hooks enable session-memory
 ```
 
 **Output:**
@@ -150,7 +150,7 @@ moltbot hooks enable session-memory
 ## Disable a Hook
 
 ```bash
-moltbot hooks disable <name>
+clawdbot hooks disable <name>
 ```
 
 Disable a specific hook by updating your config.
@@ -161,7 +161,7 @@ Disable a specific hook by updating your config.
 **Example:**
 
 ```bash
-moltbot hooks disable command-logger
+clawdbot hooks disable command-logger
 ```
 
 **Output:**
@@ -176,7 +176,7 @@ moltbot hooks disable command-logger
 ## Install Hooks
 
 ```bash
-moltbot hooks install <path-or-spec>
+clawdbot hooks install <path-or-spec>
 ```
 
 Install a hook pack from a local folder/archive or npm.
@@ -195,23 +195,23 @@ Install a hook pack from a local folder/archive or npm.
 
 ```bash
 # Local directory
-moltbot hooks install ./my-hook-pack
+clawdbot hooks install ./my-hook-pack
 
 # Local archive
-moltbot hooks install ./my-hook-pack.zip
+clawdbot hooks install ./my-hook-pack.zip
 
 # NPM package
-moltbot hooks install @moltbot/my-hook-pack
+clawdbot hooks install @clawdbot/my-hook-pack
 
 # Link a local directory without copying
-moltbot hooks install -l ./my-hook-pack
+clawdbot hooks install -l ./my-hook-pack
 ```
 
 ## Update Hooks
 
 ```bash
-moltbot hooks update <id>
-moltbot hooks update --all
+clawdbot hooks update <id>
+clawdbot hooks update --all
 ```
 
 Update installed hook packs (npm installs only).
@@ -229,7 +229,7 @@ Saves session context to memory when you issue `/new`.
 **Enable:**
 
 ```bash
-moltbot hooks enable session-memory
+clawdbot hooks enable session-memory
 ```
 
 **Output:** `~/clawd/memory/YYYY-MM-DD-slug.md`
@@ -243,7 +243,7 @@ Logs all command events to a centralized audit file.
 **Enable:**
 
 ```bash
-moltbot hooks enable command-logger
+clawdbot hooks enable command-logger
 ```
 
 **Output:** `~/.clawdbot/logs/commands.log`
@@ -270,7 +270,7 @@ Swaps injected `SOUL.md` content with `SOUL_EVIL.md` during a purge window or by
 **Enable:**
 
 ```bash
-moltbot hooks enable soul-evil
+clawdbot hooks enable soul-evil
 ```
 
 **See:** [SOUL Evil Hook](/hooks/soul-evil)
@@ -284,7 +284,7 @@ Runs `BOOT.md` when the gateway starts (after channels start).
 **Enable**:
 
 ```bash
-moltbot hooks enable boot-md
+clawdbot hooks enable boot-md
 ```
 
 **See:** [boot-md documentation](/hooks#boot-md)