Codecast
by @allanjeng
Stream coding agent sessions (Claude Code, Codex, Gemini CLI, etc.) to a Discord channel in real-time via webhook. Use when invoking coding agents and wantin...
clawhub install codecastπ About This Skill
version: 4.1.0 name: codecast description: Stream coding agent sessions (Claude Code, Codex, Gemini CLI, etc.) to a Discord channel in real-time via webhook. Use when invoking coding agents and wanting transparent, observable dev sessions β no black box. Parses Claude Code's stream-json output into clean formatted Discord messages showing tool calls, file writes, bash commands, and results with zero AI token burn. Use when asked to "stream to Discord", "relay agent output", or "make dev sessions visible". metadata: {"openclaw":{"emoji":"π¬","requires":{"anyBins":["unbuffer","python3"]}}}
Codecast
Live-stream coding agent sessions to Discord. Zero AI tokens burned.
Setup
First-time setup: see references/setup.md for webhook creation, unbuffer install, bot token, and smoke test.
Invocation
Launch with exec background:true. Background exec sessions survive agent turns and OpenClaw fires notifyOnExit automatically when the process ends.
exec background:true command:"{baseDir}/scripts/dev-relay.sh -w ~/projects/myapp -- claude -p --dangerously-skip-permissions --output-format stream-json --verbose 'Your task here'"
Note the session ID from the response β use it to monitor via process.
Options
| Flag | Description | Default |
|------|------------|---------|
| -w | Working directory | Current dir |
| -t | Timeout | 1800 |
| -h | Hang threshold | 120 |
| -n | Agent display name | Auto-detected |
| -r | Rate limit (posts/60s) | 25 |
| --thread | Post into a Discord thread | Off |
| --skip-reads | Hide Read tool events | Off |
| --review | PR review mode | β |
| --parallel | Parallel tasks mode | β |
| --resume | Replay session | β |
For PR review, parallel tasks, Discord bridge, and Codex structured output: see references/advanced-modes.md.
Agent Launch Checklist
1. Start background session β note session ID and PID from response 2. Post to dev channel β announce agent name, workdir, task 3. Write breadcrumb for completion routing:
echo '{"channel":"","relayDir":"","pid":}' > /tmp/codecast-pending-.json
The breadcrumb file tells the heartbeat precheck where to post results when the session completes. It auto-detects completion by checking if the PID is still alive.
That's it. When the process ends, OpenClaw's notifyOnExit fires a system event + heartbeat request. The heartbeat handler reads the result from the relay dir's stream.jsonl and posts to the invoking channel.
Completion Detection
OpenClaw handles this natively:
tools.exec.notifyOnExit: true (default) β system event + heartbeat on process exit/tmp/dev-relay-sessions/Backup: Append this to the inner agent's prompt for an additional signal:
When completely finished, run: openclaw system event --text "Done: " --mode now
Monitoring
process poll sessionId: # Check status
process log sessionId: # View recent output
process kill sessionId: # Stop session
Agent Support
| Agent | Output Mode | Status | |-------|------------|--------| | Claude Code | stream-json | Full support | | Codex | --json JSONL | Full support | | Any CLI | Raw ANSI | Basic support |
Session Tracking
/tmp/dev-relay-sessions/.json (auto-removed on end)/tmp/dev-relay.XXXXXX/stream.jsonl (7-day auto-cleanup)process submit sessionId: data:"message" Reference Docs
βοΈ Configuration
| Flag | Description | Default |
|------|------------|---------|
| -w | Working directory | Current dir |
| -t | Timeout | 1800 |
| -h | Hang threshold | 120 |
| -n | Agent display name | Auto-detected |
| -r | Rate limit (posts/60s) | 25 |
| --thread | Post into a Discord thread | Off |
| --skip-reads | Hide Read tool events | Off |
| --review | PR review mode | β |
| --parallel | Parallel tasks mode | β |
| --resume | Replay session | β |
For PR review, parallel tasks, Discord bridge, and Codex structured output: see references/advanced-modes.md.