ScuttleBot
chore: neutralize public docs — fix broken memory links, swap internal hostnames and nicks
Commit
8800fb6c4a6085e0723f030e2f39655391122e524191bbc49edc472c1d0731ce
Parent
9588e2022e8a100…
9 files changed
+8
-8
+1
-1
+1
-1
+3
-3
+4
-4
+4
-4
+4
-4
+4
-4
+3
-3
+8
-8
| --- .gitignore | ||
| +++ .gitignore | ||
| @@ -9,13 +9,13 @@ | ||
| 9 | 9 | tmp-*.sh |
| 10 | 10 | REPORT.md |
| 11 | 11 | coverage.out |
| 12 | 12 | test-results/ |
| 13 | 13 | |
| 14 | -# Compiled binaries | |
| 15 | -claude-agent | |
| 16 | -claude-relay | |
| 17 | -codex-agent | |
| 18 | -codex-relay | |
| 19 | -gemini-relay | |
| 20 | -scuttlebot | |
| 21 | -scuttlectl | |
| 14 | +# Compiled binaries (root-level only) | |
| 15 | +/claude-agent | |
| 16 | +/claude-relay | |
| 17 | +/codex-agent | |
| 18 | +/codex-relay | |
| 19 | +/gemini-relay | |
| 20 | +/scuttlebot | |
| 21 | +/scuttlectl | |
| 22 | 22 |
| --- .gitignore | |
| +++ .gitignore | |
| @@ -9,13 +9,13 @@ | |
| 9 | tmp-*.sh |
| 10 | REPORT.md |
| 11 | coverage.out |
| 12 | test-results/ |
| 13 | |
| 14 | # Compiled binaries |
| 15 | claude-agent |
| 16 | claude-relay |
| 17 | codex-agent |
| 18 | codex-relay |
| 19 | gemini-relay |
| 20 | scuttlebot |
| 21 | scuttlectl |
| 22 |
| --- .gitignore | |
| +++ .gitignore | |
| @@ -9,13 +9,13 @@ | |
| 9 | tmp-*.sh |
| 10 | REPORT.md |
| 11 | coverage.out |
| 12 | test-results/ |
| 13 | |
| 14 | # Compiled binaries (root-level only) |
| 15 | /claude-agent |
| 16 | /claude-relay |
| 17 | /codex-agent |
| 18 | /codex-relay |
| 19 | /gemini-relay |
| 20 | /scuttlebot |
| 21 | /scuttlectl |
| 22 |
+1
-1
| --- CLAUDE.md | ||
| +++ CLAUDE.md | ||
| @@ -42,6 +42,6 @@ | ||
| 42 | 42 | - No global state. Dependencies injected via constructor args or struct fields. |
| 43 | 43 | - Env vars for secrets only (e.g. `ORACLE_OPENAI_API_KEY`); everything else in `scuttlebot.yaml` |
| 44 | 44 | |
| 45 | 45 | ## Memory |
| 46 | 46 | |
| 47 | -See `~/.claude/projects/<sanitized-cwd>/memory/MEMORY.md` | |
| 47 | +See [`memory/MEMORY.md`](memory/MEMORY.md) | |
| 48 | 48 |
| --- CLAUDE.md | |
| +++ CLAUDE.md | |
| @@ -42,6 +42,6 @@ | |
| 42 | - No global state. Dependencies injected via constructor args or struct fields. |
| 43 | - Env vars for secrets only (e.g. `ORACLE_OPENAI_API_KEY`); everything else in `scuttlebot.yaml` |
| 44 | |
| 45 | ## Memory |
| 46 | |
| 47 | See `~/.claude/projects/<sanitized-cwd>/memory/MEMORY.md` |
| 48 |
| --- CLAUDE.md | |
| +++ CLAUDE.md | |
| @@ -42,6 +42,6 @@ | |
| 42 | - No global state. Dependencies injected via constructor args or struct fields. |
| 43 | - Env vars for secrets only (e.g. `ORACLE_OPENAI_API_KEY`); everything else in `scuttlebot.yaml` |
| 44 | |
| 45 | ## Memory |
| 46 | |
| 47 | See [`memory/MEMORY.md`](memory/MEMORY.md) |
| 48 |
+1
-1
| --- GEMINI.md | ||
| +++ GEMINI.md | ||
| @@ -1,6 +1,6 @@ | ||
| 1 | 1 | # Gemini — scuttlebot |
| 2 | 2 | |
| 3 | 3 | Primary conventions doc: [`bootstrap.md`](bootstrap.md) |
| 4 | -Context seed: [`memory.md`](memory.md) | |
| 4 | +Context seed: [`memory/MEMORY.md`](memory/MEMORY.md) | |
| 5 | 5 | |
| 6 | 6 | Read both before writing any code. |
| 7 | 7 |
| --- GEMINI.md | |
| +++ GEMINI.md | |
| @@ -1,6 +1,6 @@ | |
| 1 | # Gemini — scuttlebot |
| 2 | |
| 3 | Primary conventions doc: [`bootstrap.md`](bootstrap.md) |
| 4 | Context seed: [`memory.md`](memory.md) |
| 5 | |
| 6 | Read both before writing any code. |
| 7 |
| --- GEMINI.md | |
| +++ GEMINI.md | |
| @@ -1,6 +1,6 @@ | |
| 1 | # Gemini — scuttlebot |
| 2 | |
| 3 | Primary conventions doc: [`bootstrap.md`](bootstrap.md) |
| 4 | Context seed: [`memory/MEMORY.md`](memory/MEMORY.md) |
| 5 | |
| 6 | Read both before writing any code. |
| 7 |
+3
-3
| --- docs/guide/relays.md | ||
| +++ docs/guide/relays.md | ||
| @@ -238,15 +238,15 @@ | ||
| 238 | 238 | |
| 239 | 239 | For a remote scuttlebot instance, pass the full URL and optionally select IRC transport: |
| 240 | 240 | |
| 241 | 241 | ```bash |
| 242 | 242 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 243 | - --url http://scuttlebot.internal:8080 \ | |
| 243 | + --url http://scuttlebot.example.com:8080 \ | |
| 244 | 244 | --token "$SCUTTLEBOT_TOKEN" \ |
| 245 | 245 | --channel fleet \ |
| 246 | 246 | --transport irc \ |
| 247 | - --irc-addr scuttlebot.internal:6667 | |
| 247 | + --irc-addr scuttlebot.example.com:6667 | |
| 248 | 248 | ``` |
| 249 | 249 | |
| 250 | 250 | Install in disabled mode (hooks present but silent): |
| 251 | 251 | |
| 252 | 252 | ```bash |
| @@ -305,11 +305,11 @@ | ||
| 305 | 305 | |
| 306 | 306 | To switch Gemini or Codex to IRC transport with a remote server: |
| 307 | 307 | |
| 308 | 308 | ```bash |
| 309 | 309 | SCUTTLEBOT_TRANSPORT=irc |
| 310 | -SCUTTLEBOT_IRC_ADDR=scuttlebot.internal:6667 | |
| 310 | +SCUTTLEBOT_IRC_ADDR=scuttlebot.example.com:6667 | |
| 311 | 311 | ``` |
| 312 | 312 | |
| 313 | 313 | --- |
| 314 | 314 | |
| 315 | 315 | ## Hooks as fallback |
| 316 | 316 |
| --- docs/guide/relays.md | |
| +++ docs/guide/relays.md | |
| @@ -238,15 +238,15 @@ | |
| 238 | |
| 239 | For a remote scuttlebot instance, pass the full URL and optionally select IRC transport: |
| 240 | |
| 241 | ```bash |
| 242 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 243 | --url http://scuttlebot.internal:8080 \ |
| 244 | --token "$SCUTTLEBOT_TOKEN" \ |
| 245 | --channel fleet \ |
| 246 | --transport irc \ |
| 247 | --irc-addr scuttlebot.internal:6667 |
| 248 | ``` |
| 249 | |
| 250 | Install in disabled mode (hooks present but silent): |
| 251 | |
| 252 | ```bash |
| @@ -305,11 +305,11 @@ | |
| 305 | |
| 306 | To switch Gemini or Codex to IRC transport with a remote server: |
| 307 | |
| 308 | ```bash |
| 309 | SCUTTLEBOT_TRANSPORT=irc |
| 310 | SCUTTLEBOT_IRC_ADDR=scuttlebot.internal:6667 |
| 311 | ``` |
| 312 | |
| 313 | --- |
| 314 | |
| 315 | ## Hooks as fallback |
| 316 |
| --- docs/guide/relays.md | |
| +++ docs/guide/relays.md | |
| @@ -238,15 +238,15 @@ | |
| 238 | |
| 239 | For a remote scuttlebot instance, pass the full URL and optionally select IRC transport: |
| 240 | |
| 241 | ```bash |
| 242 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 243 | --url http://scuttlebot.example.com:8080 \ |
| 244 | --token "$SCUTTLEBOT_TOKEN" \ |
| 245 | --channel fleet \ |
| 246 | --transport irc \ |
| 247 | --irc-addr scuttlebot.example.com:6667 |
| 248 | ``` |
| 249 | |
| 250 | Install in disabled mode (hooks present but silent): |
| 251 | |
| 252 | ```bash |
| @@ -305,11 +305,11 @@ | |
| 305 | |
| 306 | To switch Gemini or Codex to IRC transport with a remote server: |
| 307 | |
| 308 | ```bash |
| 309 | SCUTTLEBOT_TRANSPORT=irc |
| 310 | SCUTTLEBOT_IRC_ADDR=scuttlebot.example.com:6667 |
| 311 | ``` |
| 312 | |
| 313 | --- |
| 314 | |
| 315 | ## Hooks as fallback |
| 316 |
+4
-4
| --- skills/gemini-relay/FLEET.md | ||
| +++ skills/gemini-relay/FLEET.md | ||
| @@ -87,15 +87,15 @@ | ||
| 87 | 87 | |
| 88 | 88 | Example: |
| 89 | 89 | |
| 90 | 90 | ```bash |
| 91 | 91 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 92 | - --url http://scuttlebot.internal:8080 \ | |
| 92 | + --url http://scuttlebot.example.com:8080 \ | |
| 93 | 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | 94 | --channel fleet \ |
| 95 | 95 | --transport irc \ |
| 96 | - --irc-addr scuttlebot.internal:6667 | |
| 96 | + --irc-addr scuttlebot.example.com:6667 | |
| 97 | 97 | ``` |
| 98 | 98 | |
| 99 | 99 | If you need hooks present but inactive until the server is live: |
| 100 | 100 | |
| 101 | 101 | ```bash |
| @@ -154,12 +154,12 @@ | ||
| 154 | 154 | 5. The pre-tool hook still blocks on the next action if needed. |
| 155 | 155 | |
| 156 | 156 | Examples: |
| 157 | 157 | |
| 158 | 158 | ```text |
| 159 | -glengoolie: gemini-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 160 | -glengoolie: gemini-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 159 | +operator: gemini-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 160 | +operator: gemini-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 161 | 161 | ``` |
| 162 | 162 | |
| 163 | 163 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 164 | 164 | |
| 165 | 165 | ## When IRC/scuttlebot is down |
| 166 | 166 |
| --- skills/gemini-relay/FLEET.md | |
| +++ skills/gemini-relay/FLEET.md | |
| @@ -87,15 +87,15 @@ | |
| 87 | |
| 88 | Example: |
| 89 | |
| 90 | ```bash |
| 91 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 92 | --url http://scuttlebot.internal:8080 \ |
| 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | --channel fleet \ |
| 95 | --transport irc \ |
| 96 | --irc-addr scuttlebot.internal:6667 |
| 97 | ``` |
| 98 | |
| 99 | If you need hooks present but inactive until the server is live: |
| 100 | |
| 101 | ```bash |
| @@ -154,12 +154,12 @@ | |
| 154 | 5. The pre-tool hook still blocks on the next action if needed. |
| 155 | |
| 156 | Examples: |
| 157 | |
| 158 | ```text |
| 159 | glengoolie: gemini-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 160 | glengoolie: gemini-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 161 | ``` |
| 162 | |
| 163 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 164 | |
| 165 | ## When IRC/scuttlebot is down |
| 166 |
| --- skills/gemini-relay/FLEET.md | |
| +++ skills/gemini-relay/FLEET.md | |
| @@ -87,15 +87,15 @@ | |
| 87 | |
| 88 | Example: |
| 89 | |
| 90 | ```bash |
| 91 | bash skills/gemini-relay/scripts/install-gemini-relay.sh \ |
| 92 | --url http://scuttlebot.example.com:8080 \ |
| 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | --channel fleet \ |
| 95 | --transport irc \ |
| 96 | --irc-addr scuttlebot.example.com:6667 |
| 97 | ``` |
| 98 | |
| 99 | If you need hooks present but inactive until the server is live: |
| 100 | |
| 101 | ```bash |
| @@ -154,12 +154,12 @@ | |
| 154 | 5. The pre-tool hook still blocks on the next action if needed. |
| 155 | |
| 156 | Examples: |
| 157 | |
| 158 | ```text |
| 159 | operator: gemini-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 160 | operator: gemini-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 161 | ``` |
| 162 | |
| 163 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 164 | |
| 165 | ## When IRC/scuttlebot is down |
| 166 |
+4
-4
| --- skills/openai-relay/FLEET.md | ||
| +++ skills/openai-relay/FLEET.md | ||
| @@ -87,15 +87,15 @@ | ||
| 87 | 87 | |
| 88 | 88 | Example: |
| 89 | 89 | |
| 90 | 90 | ```bash |
| 91 | 91 | bash skills/openai-relay/scripts/install-codex-relay.sh \ |
| 92 | - --url http://scuttlebot.internal:8080 \ | |
| 92 | + --url http://scuttlebot.example.com:8080 \ | |
| 93 | 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | 94 | --channel fleet \ |
| 95 | 95 | --transport irc \ |
| 96 | - --irc-addr scuttlebot.internal:6667 | |
| 96 | + --irc-addr scuttlebot.example.com:6667 | |
| 97 | 97 | ``` |
| 98 | 98 | |
| 99 | 99 | If you need hooks present but inactive until the server is live: |
| 100 | 100 | |
| 101 | 101 | ```bash |
| @@ -155,12 +155,12 @@ | ||
| 155 | 155 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 156 | 156 | |
| 157 | 157 | Examples: |
| 158 | 158 | |
| 159 | 159 | ```text |
| 160 | -glengoolie: codex-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 161 | -glengoolie: codex-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 160 | +operator: codex-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 161 | +operator: codex-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 162 | 162 | ``` |
| 163 | 163 | |
| 164 | 164 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 165 | 165 | |
| 166 | 166 | ## When IRC/scuttlebot is down |
| 167 | 167 |
| --- skills/openai-relay/FLEET.md | |
| +++ skills/openai-relay/FLEET.md | |
| @@ -87,15 +87,15 @@ | |
| 87 | |
| 88 | Example: |
| 89 | |
| 90 | ```bash |
| 91 | bash skills/openai-relay/scripts/install-codex-relay.sh \ |
| 92 | --url http://scuttlebot.internal:8080 \ |
| 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | --channel fleet \ |
| 95 | --transport irc \ |
| 96 | --irc-addr scuttlebot.internal:6667 |
| 97 | ``` |
| 98 | |
| 99 | If you need hooks present but inactive until the server is live: |
| 100 | |
| 101 | ```bash |
| @@ -155,12 +155,12 @@ | |
| 155 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 156 | |
| 157 | Examples: |
| 158 | |
| 159 | ```text |
| 160 | glengoolie: codex-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 161 | glengoolie: codex-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 162 | ``` |
| 163 | |
| 164 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 165 | |
| 166 | ## When IRC/scuttlebot is down |
| 167 |
| --- skills/openai-relay/FLEET.md | |
| +++ skills/openai-relay/FLEET.md | |
| @@ -87,15 +87,15 @@ | |
| 87 | |
| 88 | Example: |
| 89 | |
| 90 | ```bash |
| 91 | bash skills/openai-relay/scripts/install-codex-relay.sh \ |
| 92 | --url http://scuttlebot.example.com:8080 \ |
| 93 | --token "$SCUTTLEBOT_TOKEN" \ |
| 94 | --channel fleet \ |
| 95 | --transport irc \ |
| 96 | --irc-addr scuttlebot.example.com:6667 |
| 97 | ``` |
| 98 | |
| 99 | If you need hooks present but inactive until the server is live: |
| 100 | |
| 101 | ```bash |
| @@ -155,12 +155,12 @@ | |
| 155 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 156 | |
| 157 | Examples: |
| 158 | |
| 159 | ```text |
| 160 | operator: codex-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 161 | operator: codex-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 162 | ``` |
| 163 | |
| 164 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 165 | |
| 166 | ## When IRC/scuttlebot is down |
| 167 |
| --- skills/openai-relay/hooks/README.md | ||
| +++ skills/openai-relay/hooks/README.md | ||
| @@ -216,20 +216,20 @@ | ||
| 216 | 216 | This is the critical fallback behavior. Ambient channel chat must not halt a live tool loop. |
| 217 | 217 | |
| 218 | 218 | Examples that block: |
| 219 | 219 | |
| 220 | 220 | ```text |
| 221 | -glengoolie: codex-scuttlebot-8421 stop and re-read the schema | |
| 222 | -glengoolie: codex-scuttlebot-8421 wrong file, look at internal/api first | |
| 221 | +operator: codex-scuttlebot-8421 stop and re-read the schema | |
| 222 | +operator: codex-scuttlebot-8421 wrong file, look at internal/api first | |
| 223 | 223 | ``` |
| 224 | 224 | |
| 225 | 225 | Examples that do not block: |
| 226 | 226 | |
| 227 | 227 | ```text |
| 228 | -glengoolie: can someone check the schema | |
| 228 | +operator: can someone check the schema | |
| 229 | 229 | codex-otherrepo-7712: read internal/config/config.go |
| 230 | -bridge: [glengoolie] hello | |
| 230 | +bridge: [operator] hello | |
| 231 | 231 | ``` |
| 232 | 232 | |
| 233 | 233 | ## Per-session state |
| 234 | 234 | |
| 235 | 235 | The check hook stores its last-seen timestamp in: |
| 236 | 236 |
| --- skills/openai-relay/hooks/README.md | |
| +++ skills/openai-relay/hooks/README.md | |
| @@ -216,20 +216,20 @@ | |
| 216 | This is the critical fallback behavior. Ambient channel chat must not halt a live tool loop. |
| 217 | |
| 218 | Examples that block: |
| 219 | |
| 220 | ```text |
| 221 | glengoolie: codex-scuttlebot-8421 stop and re-read the schema |
| 222 | glengoolie: codex-scuttlebot-8421 wrong file, look at internal/api first |
| 223 | ``` |
| 224 | |
| 225 | Examples that do not block: |
| 226 | |
| 227 | ```text |
| 228 | glengoolie: can someone check the schema |
| 229 | codex-otherrepo-7712: read internal/config/config.go |
| 230 | bridge: [glengoolie] hello |
| 231 | ``` |
| 232 | |
| 233 | ## Per-session state |
| 234 | |
| 235 | The check hook stores its last-seen timestamp in: |
| 236 |
| --- skills/openai-relay/hooks/README.md | |
| +++ skills/openai-relay/hooks/README.md | |
| @@ -216,20 +216,20 @@ | |
| 216 | This is the critical fallback behavior. Ambient channel chat must not halt a live tool loop. |
| 217 | |
| 218 | Examples that block: |
| 219 | |
| 220 | ```text |
| 221 | operator: codex-scuttlebot-8421 stop and re-read the schema |
| 222 | operator: codex-scuttlebot-8421 wrong file, look at internal/api first |
| 223 | ``` |
| 224 | |
| 225 | Examples that do not block: |
| 226 | |
| 227 | ```text |
| 228 | operator: can someone check the schema |
| 229 | codex-otherrepo-7712: read internal/config/config.go |
| 230 | bridge: [operator] hello |
| 231 | ``` |
| 232 | |
| 233 | ## Per-session state |
| 234 | |
| 235 | The check hook stores its last-seen timestamp in: |
| 236 |
+4
-4
| --- skills/scuttlebot-relay/FLEET.md | ||
| +++ skills/scuttlebot-relay/FLEET.md | ||
| @@ -65,15 +65,15 @@ | ||
| 65 | 65 | |
| 66 | 66 | Example: |
| 67 | 67 | |
| 68 | 68 | ```bash |
| 69 | 69 | bash skills/scuttlebot-relay/scripts/install-claude-relay.sh \ |
| 70 | - --url http://scuttlebot.internal:8080 \ | |
| 70 | + --url http://scuttlebot.example.com:8080 \ | |
| 71 | 71 | --token "$SCUTTLEBOT_TOKEN" \ |
| 72 | 72 | --channel fleet \ |
| 73 | 73 | --transport irc \ |
| 74 | - --irc-addr scuttlebot.internal:6667 | |
| 74 | + --irc-addr scuttlebot.example.com:6667 | |
| 75 | 75 | ``` |
| 76 | 76 | |
| 77 | 77 | If you need hooks present but inactive until the server is live: |
| 78 | 78 | |
| 79 | 79 | ```bash |
| @@ -132,12 +132,12 @@ | ||
| 132 | 132 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 133 | 133 | |
| 134 | 134 | Examples: |
| 135 | 135 | |
| 136 | 136 | ```text |
| 137 | -glengoolie: claude-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 138 | -glengoolie: claude-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 137 | +operator: claude-scuttlebot-a1b2c3d4 stop and re-read bridge.go | |
| 138 | +operator: claude-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first | |
| 139 | 139 | ``` |
| 140 | 140 | |
| 141 | 141 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 142 | 142 | |
| 143 | 143 | ## When IRC/scuttlebot is down |
| 144 | 144 |
| --- skills/scuttlebot-relay/FLEET.md | |
| +++ skills/scuttlebot-relay/FLEET.md | |
| @@ -65,15 +65,15 @@ | |
| 65 | |
| 66 | Example: |
| 67 | |
| 68 | ```bash |
| 69 | bash skills/scuttlebot-relay/scripts/install-claude-relay.sh \ |
| 70 | --url http://scuttlebot.internal:8080 \ |
| 71 | --token "$SCUTTLEBOT_TOKEN" \ |
| 72 | --channel fleet \ |
| 73 | --transport irc \ |
| 74 | --irc-addr scuttlebot.internal:6667 |
| 75 | ``` |
| 76 | |
| 77 | If you need hooks present but inactive until the server is live: |
| 78 | |
| 79 | ```bash |
| @@ -132,12 +132,12 @@ | |
| 132 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 133 | |
| 134 | Examples: |
| 135 | |
| 136 | ```text |
| 137 | glengoolie: claude-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 138 | glengoolie: claude-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 139 | ``` |
| 140 | |
| 141 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 142 | |
| 143 | ## When IRC/scuttlebot is down |
| 144 |
| --- skills/scuttlebot-relay/FLEET.md | |
| +++ skills/scuttlebot-relay/FLEET.md | |
| @@ -65,15 +65,15 @@ | |
| 65 | |
| 66 | Example: |
| 67 | |
| 68 | ```bash |
| 69 | bash skills/scuttlebot-relay/scripts/install-claude-relay.sh \ |
| 70 | --url http://scuttlebot.example.com:8080 \ |
| 71 | --token "$SCUTTLEBOT_TOKEN" \ |
| 72 | --channel fleet \ |
| 73 | --transport irc \ |
| 74 | --irc-addr scuttlebot.example.com:6667 |
| 75 | ``` |
| 76 | |
| 77 | If you need hooks present but inactive until the server is live: |
| 78 | |
| 79 | ```bash |
| @@ -132,12 +132,12 @@ | |
| 132 | 5. The pre-tool hook still blocks on the next `Bash|Edit|Write` if needed. |
| 133 | |
| 134 | Examples: |
| 135 | |
| 136 | ```text |
| 137 | operator: claude-scuttlebot-a1b2c3d4 stop and re-read bridge.go |
| 138 | operator: claude-scuttlebot-a1b2c3d4 wrong file, inspect policies.go first |
| 139 | ``` |
| 140 | |
| 141 | Ambient channel chat does not block the loop. Only explicit nick mentions do. |
| 142 | |
| 143 | ## When IRC/scuttlebot is down |
| 144 |
| --- skills/scuttlebot-relay/hooks/README.md | ||
| +++ skills/scuttlebot-relay/hooks/README.md | ||
| @@ -183,18 +183,18 @@ | ||
| 183 | 183 | Only addressed instructions block the loop. |
| 184 | 184 | |
| 185 | 185 | Examples that block: |
| 186 | 186 | |
| 187 | 187 | ```text |
| 188 | -glengoolie: claude-scuttlebot-a1b2c3d4 stop and inspect the schema first | |
| 189 | -glengoolie: claude-scuttlebot-a1b2c3d4 wrong file | |
| 188 | +operator: claude-scuttlebot-a1b2c3d4 stop and inspect the schema first | |
| 189 | +operator: claude-scuttlebot-a1b2c3d4 wrong file | |
| 190 | 190 | ``` |
| 191 | 191 | |
| 192 | 192 | Examples that do not block: |
| 193 | 193 | |
| 194 | 194 | ```text |
| 195 | -glengoolie: someone should inspect the schema | |
| 195 | +operator: someone should inspect the schema | |
| 196 | 196 | claude-otherrepo-e5f6a7b8: read config.go |
| 197 | 197 | ``` |
| 198 | 198 | |
| 199 | 199 | The last-check timestamp is stored in a session-scoped file under `/tmp`, keyed by: |
| 200 | 200 | - nick |
| 201 | 201 |
| --- skills/scuttlebot-relay/hooks/README.md | |
| +++ skills/scuttlebot-relay/hooks/README.md | |
| @@ -183,18 +183,18 @@ | |
| 183 | Only addressed instructions block the loop. |
| 184 | |
| 185 | Examples that block: |
| 186 | |
| 187 | ```text |
| 188 | glengoolie: claude-scuttlebot-a1b2c3d4 stop and inspect the schema first |
| 189 | glengoolie: claude-scuttlebot-a1b2c3d4 wrong file |
| 190 | ``` |
| 191 | |
| 192 | Examples that do not block: |
| 193 | |
| 194 | ```text |
| 195 | glengoolie: someone should inspect the schema |
| 196 | claude-otherrepo-e5f6a7b8: read config.go |
| 197 | ``` |
| 198 | |
| 199 | The last-check timestamp is stored in a session-scoped file under `/tmp`, keyed by: |
| 200 | - nick |
| 201 |
| --- skills/scuttlebot-relay/hooks/README.md | |
| +++ skills/scuttlebot-relay/hooks/README.md | |
| @@ -183,18 +183,18 @@ | |
| 183 | Only addressed instructions block the loop. |
| 184 | |
| 185 | Examples that block: |
| 186 | |
| 187 | ```text |
| 188 | operator: claude-scuttlebot-a1b2c3d4 stop and inspect the schema first |
| 189 | operator: claude-scuttlebot-a1b2c3d4 wrong file |
| 190 | ``` |
| 191 | |
| 192 | Examples that do not block: |
| 193 | |
| 194 | ```text |
| 195 | operator: someone should inspect the schema |
| 196 | claude-otherrepo-e5f6a7b8: read config.go |
| 197 | ``` |
| 198 | |
| 199 | The last-check timestamp is stored in a session-scoped file under `/tmp`, keyed by: |
| 200 | - nick |
| 201 |