Bridge dashboard

Skill bks-lab/open-bridge/skills/bridge-dashboard

Generates the Bridge Control Center — a single-file HTML dashboard that bundles Fleet (infra/remotes/), Work Board, Calendar (next 24h), Channels, Git activity, optional Bridge-Deck /metrics, and upstream drift into one view. Stands alone; the pixel-art Bridge-Deck renderer it can complement is not yet public (coming soon). Trigger: "/bridge-dashboard", "bridge dashboard", "control center", "ops dashboard", "open dashboard", "show me everything at a glance".From its SKILL.md

Install

npx -y skills add bks-lab/open-bridge --skill bridge-dashboard

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 3 commands, including `python3 scripts/bridge-dashboard.py` and 2 more.
fetches URLsInstructs the agent to fetch 1 URL, including http://homeserver:8791/metrics.

SKILL.md

3.8 KB, 830 tokens by cl100k_base, as published. Nobody here has run it

Bridge Dashboard

What it does

A Python generator — scripts/bridge-dashboard.py, a shared repo-root utility shipped with the Bridge repo itself (not inside this skill's own directory), stdlib + PyYAML only — aggregates the entire Bridge state in parallel and renders a self-contained HTML:

Tile	Source	Parallel probe
Fleet	`infra/remotes/*.yaml` + ICMP ping (Tailscale > LAN)	yes, 8 workers
Work Board	`work/board.md` (doing/backlog/done)	yes
Calendar 24h	`workflow/calendars/entries.yaml` + RRULE expander	yes
Channels	`infra/channels/*.yaml`	yes
Bridge-Deck (optional)	HTTP `http://homeserver:8791/metrics` — tile shows "offline" when absent	yes, 1.5s timeout
Git Activity	all repos from `ecosystem.yaml` via `git log --since=24h`	yes, 6 workers
Upstream	`HEAD..development`	yes
Events	last 10 lines from `work/log.md`	yes

Design: dark theme, cyan/amber, responsive 12-column grid. Sticky header with live counters. Auto-refresh every 30s via meta tag.

Usage

# Generate once → work/dashboard.html
python3 scripts/bridge-dashboard.py

# Generate and open in the browser
python3 scripts/bridge-dashboard.py --open

# Continuous mode: server on :8790, regenerate every 30s
python3 scripts/bridge-dashboard.py --serve

Serve mode is suited for launchd/cron on homeserver. A plist template lives in skills/bridge-dashboard/references/com.example.bridge-dashboard.plist.

Relationship to Bridge-Deck (optional — not yet public, coming soon)

	Bridge-Deck :8791	Bridge Dashboard :8790
Purpose	Ambient pixel-art office view	Ops-grade situational awareness
Tech	Node/React/Pixi + WS live	Python → HTML, 30s refresh
Runs where	homeserver (launchd, always on)	on-demand or launchd (optional)
Scope	Agents/Channels/Calendar	Fleet + Board + integrations-ready + Git

Both read the Bridge's YAML data read-only. No duplicate source.

Decision Tree

User wants to...
├── Quick morning check                  → python3 scripts/bridge-dashboard.py --open
├── Permanently on a 2nd monitor         → --serve + keep a browser tab open
├── Fleet status right now               → generate dashboard, top left
├── Integrate an integration tile (e.g. cloud-function health) → add a tile in scripts/bridge-dashboard.py (Phase 2 — planned)
└── Customize the dashboard              → edit scripts/bridge-dashboard.py

Data Sources & Invariants

Read-only: The script writes exclusively to work/dashboard.html. No changes to YAML/log/board.
Fail-soft: If a source is missing (e.g. bridge-deck offline), the tile shows "offline". Other tiles still run.
Timeouts: Ping 800ms, HTTP 1.5s, Git 3s per repo — the whole dashboard builds in <4s.
No secrets: The HTML contains only paths and metrics, no tokens.

Roadmap (non-blocking)

Integration tile: cloud-function health + log-error count via provider CLI.
Mail tile: unread mail from Microsoft Graph (via an org-overlay mail skill, if your bridge has one).
Telegram/Signal unread count.
Weekly sparkline: commits/day, log events/day.
Dark/light toggle.
PWA manifest for full-screen kiosk on iPad.

What ships with it: 1 file

1.2 KB alongside SKILL.md

references/

com.example.bridge-dashboard.plist1.2 KB