@poolzin/pool-bot 2026.1.26 → 2026.1.30

package/docs/cli/devices.md

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

package/docs/cli/directory.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `clawdbot directory` (self, peers, groups)"
+summary: "CLI reference for `poolbot 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
 ---
 
-# `clawdbot directory`
+# `poolbot 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 `clawdbot message send --target ...`).
+- `directory` is meant to help you find IDs you can paste into other commands (especially `poolbot 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
-clawdbot directory peers list --channel slack --query "U0"
-clawdbot message send --channel slack --target user:U012ABCDEF --message "hello"
+poolbot directory peers list --channel slack --query "U0"
+poolbot message send --channel slack --target user:U012ABCDEF --message "hello"
 ```
 
 ## ID formats (by channel)
@@ -40,21 +40,21 @@ clawdbot message send --channel slack --target user:U012ABCDEF --message "hello"
 ## Self (“me”)
 
 ```bash
-clawdbot directory self --channel zalouser
+poolbot directory self --channel zalouser
 ```
 
 ## Peers (contacts/users)
 
 ```bash
-clawdbot directory peers list --channel zalouser
-clawdbot directory peers list --channel zalouser --query "name"
-clawdbot directory peers list --channel zalouser --limit 50
+poolbot directory peers list --channel zalouser
+poolbot directory peers list --channel zalouser --query "name"
+poolbot directory peers list --channel zalouser --limit 50
 ```
 
 ## Groups
 
 ```bash
-clawdbot directory groups list --channel zalouser
-clawdbot directory groups list --channel zalouser --query "work"
-clawdbot directory groups members --channel zalouser --group-id <id>
+poolbot directory groups list --channel zalouser
+poolbot directory groups list --channel zalouser --query "work"
+poolbot directory groups members --channel zalouser --group-id <id>
 ```

package/docs/cli/dns.md

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

package/docs/cli/docs.md

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

package/docs/cli/doctor.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `clawdbot doctor` (health checks + guided repairs)"
+summary: "CLI reference for `poolbot doctor` (health checks + guided repairs)"
 read_when:
   - You have connectivity/auth issues and want guided fixes
   - You updated and want a sanity check
 ---
 
-# `clawdbot doctor`
+# `poolbot doctor`
 
 Health checks + quick fixes for the gateway and channels.
 
@@ -16,14 +16,14 @@ Related:
 ## Examples
 
 ```bash
-clawdbot doctor
-clawdbot doctor --repair
-clawdbot doctor --deep
+poolbot doctor
+poolbot doctor --repair
+poolbot 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/clawdbot.json.bak` and drops unknown config keys, listing each removal.
+- `--fix` (alias for `--repair`) writes a backup to `~/.poolbot/poolbot.json.bak` and drops unknown config keys, listing each removal.
 
 ## macOS: `launchctl` env overrides
 

package/docs/cli/gateway.md

@@ -1,5 +1,5 @@
 ---
-summary: "Clawdbot Gateway CLI (`clawdbot gateway`) — run, query, and discover gateways"
+summary: "Pool Bot Gateway CLI (`poolbot 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 Clawdbot’s WebSocket server (channels, nodes, sessions, hooks).
+The Gateway is Pool Bot’s WebSocket server (channels, nodes, sessions, hooks).
 
-Subcommands in this page live under `clawdbot gateway …`.
+Subcommands in this page live under `poolbot gateway …`.
 
 Related docs:
 - [/gateway/bonjour](/gateway/bonjour)
@@ -22,17 +22,17 @@ Related docs:
 Run a local Gateway process:
 
 ```bash
-clawdbot gateway
+poolbot gateway
 ```
 
 Foreground alias:
 
 ```bash
-clawdbot gateway run
+poolbot gateway run
 ```
 
 Notes:
-- 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.
+- By default, the Gateway refuses to start unless `gateway.mode=local` is set in `~/.poolbot/poolbot.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
-clawdbot gateway health --url ws://127.0.0.1:18789
+poolbot gateway health --url ws://127.0.0.1:18789
 ```
 
 ### `gateway status`
@@ -84,8 +84,8 @@ clawdbot gateway health --url ws://127.0.0.1:18789
 `gateway status` shows the Gateway service (launchd/systemd/schtasks) plus an optional RPC probe.
 
 ```bash
-clawdbot gateway status
-clawdbot gateway status --json
+poolbot gateway status
+poolbot 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
-clawdbot gateway probe
-clawdbot gateway probe --json
+poolbot gateway probe
+poolbot 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
-clawdbot gateway probe --ssh user@gateway-host
+poolbot gateway probe --ssh user@gateway-host
 ```
 
 Options:
@@ -133,18 +133,18 @@ Config (optional, used as defaults):
 Low-level RPC helper.
 
 ```bash
-clawdbot gateway call status
-clawdbot gateway call logs.tail --params '{"sinceMs": 60000}'
+poolbot gateway call status
+poolbot gateway call logs.tail --params '{"sinceMs": 60000}'
 ```
 
 ## Manage the Gateway service
 
 ```bash
-clawdbot gateway install
-clawdbot gateway start
-clawdbot gateway stop
-clawdbot gateway restart
-clawdbot gateway uninstall
+poolbot gateway install
+poolbot gateway start
+poolbot gateway stop
+poolbot gateway restart
+poolbot gateway uninstall
 ```
 
 Notes:
@@ -153,10 +153,10 @@ Notes:
 
 ## Discover gateways (Bonjour)
 
-`gateway discover` scans for Gateway beacons (`_clawdbot-gw._tcp`).
+`gateway discover` scans for Gateway beacons (`_poolbot-gw._tcp`).
 
 - Multicast DNS-SD: `local.`
-- Unicast DNS-SD (Wide-Area Bonjour): `clawdbot.internal.` (requires split DNS + DNS server; see [/gateway/bonjour](/gateway/bonjour))
+- Unicast DNS-SD (Wide-Area Bonjour): `poolbot.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
-clawdbot gateway discover
+poolbot gateway discover
 ```
 
 Options:
@@ -182,6 +182,6 @@ Options:
 Examples:
 
 ```bash
-clawdbot gateway discover --timeout 4000
-clawdbot gateway discover --json | jq '.beacons[].wsUrl'
+poolbot gateway discover --timeout 4000
+poolbot gateway discover --json | jq '.beacons[].wsUrl'
 ```

package/docs/cli/health.md

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

package/docs/cli/hooks.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `clawdbot hooks` (agent hooks)"
+summary: "CLI reference for `poolbot hooks` (agent hooks)"
 read_when:
   - You want to manage agent hooks
   - You want to install or update hooks
 ---
 
-# `clawdbot hooks`
+# `poolbot hooks`
 
 Manage agent hooks (event-driven automations for commands like `/new`, `/reset`, and gateway startup).
 
@@ -16,7 +16,7 @@ Related:
 ## List All Hooks
 
 ```bash
-clawdbot hooks list
+poolbot hooks list
 ```
 
 List all discovered hooks from workspace, managed, and bundled directories.
@@ -41,7 +41,7 @@ Ready:
 **Example (verbose):**
 
 ```bash
-clawdbot hooks list --verbose
+poolbot hooks list --verbose
 ```
 
 Shows missing requirements for ineligible hooks.
@@ -49,7 +49,7 @@ Shows missing requirements for ineligible hooks.
 **Example (JSON):**
 
 ```bash
-clawdbot hooks list --json
+poolbot hooks list --json
 ```
 
 Returns structured JSON for programmatic use.
@@ -57,7 +57,7 @@ Returns structured JSON for programmatic use.
 ## Get Hook Information
 
 ```bash
-clawdbot hooks info <name>
+poolbot hooks info <name>
 ```
 
 Show detailed information about a specific hook.
@@ -71,7 +71,7 @@ Show detailed information about a specific hook.
 **Example:**
 
 ```bash
-clawdbot hooks info session-memory
+poolbot hooks info session-memory
 ```
 
 **Output:**
@@ -82,10 +82,10 @@ clawdbot hooks info session-memory
 Save session context to memory when /new command is issued
 
 Details:
-  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
+  Source: poolbot-bundled
+  Path: /path/to/poolbot/hooks/bundled/session-memory/HOOK.md
+  Handler: /path/to/poolbot/hooks/bundled/session-memory/handler.ts
+  Homepage: https://docs.molt.bot/hooks#session-memory
   Events: command:new
 
 Requirements:
@@ -95,7 +95,7 @@ Requirements:
 ## Check Hooks Eligibility
 
 ```bash
-clawdbot hooks check
+poolbot 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
-clawdbot hooks enable <name>
+poolbot hooks enable <name>
 ```
 
-Enable a specific hook by adding it to your config (`~/.clawdbot/config.json`).
+Enable a specific hook by adding it to your config (`~/.poolbot/config.json`).
 
-**Note:** Hooks managed by plugins show `plugin:<id>` in `clawdbot hooks list` and
+**Note:** Hooks managed by plugins show `plugin:<id>` in `poolbot 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
-clawdbot hooks enable session-memory
+poolbot hooks enable session-memory
 ```
 
 **Output:**
@@ -150,7 +150,7 @@ clawdbot hooks enable session-memory
 ## Disable a Hook
 
 ```bash
-clawdbot hooks disable <name>
+poolbot 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
-clawdbot hooks disable command-logger
+poolbot hooks disable command-logger
 ```
 
 **Output:**
@@ -176,13 +176,13 @@ clawdbot hooks disable command-logger
 ## Install Hooks
 
 ```bash
-clawdbot hooks install <path-or-spec>
+poolbot hooks install <path-or-spec>
 ```
 
 Install a hook pack from a local folder/archive or npm.
 
 **What it does:**
-- Copies the hook pack into `~/.clawdbot/hooks/<id>`
+- Copies the hook pack into `~/.poolbot/hooks/<id>`
 - Enables the installed hooks in `hooks.internal.entries.*`
 - Records the install under `hooks.internal.installs`
 
@@ -195,23 +195,23 @@ Install a hook pack from a local folder/archive or npm.
 
 ```bash
 # Local directory
-clawdbot hooks install ./my-hook-pack
+poolbot hooks install ./my-hook-pack
 
 # Local archive
-clawdbot hooks install ./my-hook-pack.zip
+poolbot hooks install ./my-hook-pack.zip
 
 # NPM package
-clawdbot hooks install @clawdbot/my-hook-pack
+poolbot hooks install @poolbot/my-hook-pack
 
 # Link a local directory without copying
-clawdbot hooks install -l ./my-hook-pack
+poolbot hooks install -l ./my-hook-pack
 ```
 
 ## Update Hooks
 
 ```bash
-clawdbot hooks update <id>
-clawdbot hooks update --all
+poolbot hooks update <id>
+poolbot 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
-clawdbot hooks enable session-memory
+poolbot hooks enable session-memory
 ```
 
 **Output:** `~/clawd/memory/YYYY-MM-DD-slug.md`
@@ -243,22 +243,22 @@ Logs all command events to a centralized audit file.
 **Enable:**
 
 ```bash
-clawdbot hooks enable command-logger
+poolbot hooks enable command-logger
 ```
 
-**Output:** `~/.clawdbot/logs/commands.log`
+**Output:** `~/.poolbot/logs/commands.log`
 
 **View logs:**
 
 ```bash
 # Recent commands
-tail -n 20 ~/.clawdbot/logs/commands.log
+tail -n 20 ~/.poolbot/logs/commands.log
 
 # Pretty-print
-cat ~/.clawdbot/logs/commands.log | jq .
+cat ~/.poolbot/logs/commands.log | jq .
 
 # Filter by action
-grep '"action":"new"' ~/.clawdbot/logs/commands.log | jq .
+grep '"action":"new"' ~/.poolbot/logs/commands.log | jq .
 ```
 
 **See:** [command-logger documentation](/hooks#command-logger)
@@ -270,7 +270,7 @@ Swaps injected `SOUL.md` content with `SOUL_EVIL.md` during a purge window or by
 **Enable:**
 
 ```bash
-clawdbot hooks enable soul-evil
+poolbot 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
-clawdbot hooks enable boot-md
+poolbot hooks enable boot-md
 ```
 
 **See:** [boot-md documentation](/hooks#boot-md)