---

name: session-listen description: "Start or stop the SSE event stream for real-time Codeman session events. Trigger on: 'listen for sessions', 'start event stream', 'stop listening', 'session events', 'watch sessions'." metadata: {"openclaw":{"emoji":"📡"}} allowed-tools: "Read,Bash,Grep,Glob"

Session Event Stream Listener

Start or stop the SSE event stream for real-time Codeman session events. Requires CODEMAN_URL and CODEMAN_PASSWORD env vars.

Usage

/session-listen start
/session-listen stop

Instructions

1. Start (or no args): python -m famdeck.sessions.manager listen -- report "SSE event stream started." On failure: suggest famdeck doctor.
2. Stop: python -m famdeck.sessions.manager stop-listen -- report "SSE event stream stopped."

Parse JSON output in both cases.

Events monitored: permission_prompt (session waiting for approval), session:completed (finished), session:error (failed). Auto-reconnects with exponential backoff (1s to 60s). On reconnect, reconciles state by checking active sessions for missed events.