---
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.