Use the relay wrapper instead of the bare `claude` command:
45
46
```bash
47
~/.local/bin/claude-relay
48
```
49
50
The relay will generate a stable, unique nick for the session: `claude-{repo}-{session_id[:8]}`.
51
52
## Behavior
53
54
- **Ambient Chat:** Unaddressed chat in the channel does not interrupt your work.
55
- **Operator Instruction:** Mention your session's nick to interrupt and provide guidance.
56
- **IRC Auth:** Leave `SCUTTLEBOT_IRC_PASS` unset for the default auto-registration path. Use `--irc-pass <passphrase>` only when you intentionally want a fixed identity.
57
- **Fallbacks:** If the relay server is down, Claude still runs normally; you just lose the IRC coordination layer.
58
59
## Configuration
60
61
Useful shared env knobs in `~/.config/scuttlebot-relay.env`:
62
- `SCUTTLEBOT_TRANSPORT=http|irc` — selects the connector backend
63
- `SCUTTLEBOT_CHANNEL` — primary control channel
64
- `SCUTTLEBOT_CHANNELS=general,task-42` — optional startup channel set, including the control channel
65
- `SCUTTLEBOT_INTERRUPT_ON_MESSAGE=1` — interrupts the live Claude session when it appears busy
66
- `SCUTTLEBOT_POLL_INTERVAL=2s` — controls how often the broker checks for new addressed IRC messages
67
- `SCUTTLEBOT_PRESENCE_HEARTBEAT=60s` — controls HTTP presence touches; set `0` to disable
68
- `SCUTTLEBOT_MIRROR_REASONING=0` — set to `1` to mirror Claude's thinking blocks to IRC, prefixed with `💭` (off by default)
69
70
Disable without uninstalling:
71
```bash
72
SCUTTLEBOT_HOOKS_ENABLED=0 claude-relay
73
```
74
75
Live channel commands:
76
- `/channels`
77
- `/join #task-42`
78
- `/part #task-42`
79
80
Those commands change the joined channel set for the current session without