# ijfw-dashboard

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

- Skill: `ferroxlabs/ijfw-dashboard` (Agent Skill)
- Install (CLI): `npx skillmds add ferroxlabs/ijfw-dashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ferroxlabs/ijfw-dashboard/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: FerroxLabs (https://skillmd.com/u/ferroxlabs)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/ferroxlabs/ijfw-dashboard

---


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