# Bridge Dashboard

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-bks-lab-open-bridge-bridge-dashboard`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bks-lab](https://agentstack.voostack.com/s/bks-lab)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bks-lab](https://github.com/bks-lab)
- **Source:** https://github.com/bks-lab/open-bridge/tree/main/skills/bridge-dashboard
- **Website:** https://bks-lab.github.io/open-bridge/

## Install

```sh
agentstack add skill-bks-lab-open-bridge-bridge-dashboard
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Bridge Dashboard

## What it does

A Python generator (`scripts/bridge-dashboard.py`, 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

```bash
# 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)

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bks-lab](https://github.com/bks-lab)
- **Source:** [bks-lab/open-bridge](https://github.com/bks-lab/open-bridge)
- **License:** MIT
- **Homepage:** https://bks-lab.github.io/open-bridge/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bks-lab-open-bridge-bridge-dashboard
- Seller: https://agentstack.voostack.com/s/bks-lab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.