/ijfw-dashboard

name: ijfw-dashboard
description: "Control the IJFW observation dashboard (start/stop/status). Trigger: 'ijfw dashboard', 'open dashboard', 'show observations', 'dashboard start', 'dashboard stop', 'dashboard status', 'view session activity'."

IJFW Dashboard

Local observability dashboard at `http://localhost:37891`. Shows observations from all platforms (Claude Code, Codex, Gemini) in real time via SSE.

Commands

ijfw dashboard start    # bind port 37891, open browser (unless $CI)
ijfw dashboard stop     # send shutdown, clean up PID + port files
ijfw dashboard status   # show port, uptime, observation count

How it works

• Port 37891 by default; walks to 37900 if busy. Actual port written to `.ijfw/dashboard.port`.
• Reads `~/.ijfw/observations.jsonl` (shared ledger across all platforms).
• SSE delivers new observations within 150ms of ledger append.
• Single-file HTML viewer -- no React, no build step, no external network.
• `localhost`-gated: external requests return 403.

Platform coverage

| Platform | Writes observations | Reads dashboard | |---|---|---| | Claude Code | yes | yes | | Codex | yes | yes | | Gemini | yes | yes | | Cursor | view-only | yes | | Windsurf | view-only | yes | | Copilot | view-only | yes |

Session start

Dashboard observations render at session start via `session-start-dashboard.sh`. Run `ijfw dashboard start` to also open the browser view.