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.