Weatherdeck: open source status board for AI agent workloads
Weatherdeck is a read-only status board for machines and the work running on them. You mount it on a TV or check it on your phone. Small pushers send JSON to it; it displays what is waiting on you, what is in progress, and whether every source is still reporting.
It is not a monitoring system, not an alerting system, and not a hosted service. It never pages anyone. It shows only what sources push to it, and it runs entirely on hardware you choose.
️ What It Shows
- Waiting on you: an amber plate listing decisions, approvals, and capacity problems, with how long each has waited.
- Honest progress: percent ranges where the source provides one (for example, 38-42%), not a false single number. A lane the board cannot read is counted as “can’t tell,” not shown as fine.
- Source health: a lamp by the clock reads “2/3 live” when one source stops reporting. That machine’s ship is drawn in fog and labelled silent. Stale data is never presented as fresh.
- TV and phone in one page: wide screen gets the full fleet view; 390-pixel phone gets a single-column layout of calls, problems, and status tiles.
How It Works
Any tool that can POST one JSON document over HTTP is a valid source. Sources are discovered automatically; you do not configure them by hand. Each machine appears on the board on its own once it starts pushing.
The stack is intentionally minimal: Python standard library only, one SQLite file, one plain HTML/JS/CSS page. No build step, no CDN, no telemetry, no root access required. It runs natively on Windows 11, macOS, and Linux from Python 3.9 through 3.14. pip install is not supported yet.
To try it immediately without installing anything, run weatherdeck run --demo and open http://127.0.0.1:8787/. Three invented sources report; one stops after about two and a half minutes so you can see the offline state.
Privacy Controls
Weatherdeck binds only the addresses you explicitly list. It refuses 0.0.0.0 and ::. Three view profiles let you control what different audiences see:
- Full view at
/: everything. - TV view at
/tv/: task titles and repo names, no free-text worker notes. - Public view at
/public/: counts, group names, and percentages only.
Each profile takes its own optional read token. Redaction happens on the host, not in the browser.
Cost and License
MIT licensed and free. No hosted tier, no subscription. The test suite runs 453 tests across Python 3.9 to 3.14 on Windows, macOS, and Linux. Pre-1.0 hobby software, open-sourced because it solved a problem the author had. Support is best effort via GitHub issues.
I’m founder of BizStack at Cagri Sarigoz LLC and a passionate advocate for entrepreneurs.
With over 14 years in tech, marketing, and AI, including my role as Head of SEO at CitizenShipper and co-founder of TaleBot at Intale AI, I’m dedicated to sharing genuine, useful product insights and tips.
At BizStack, I aim to cut through the digital noise to provide clear, actionable advice.
And more than all else, I’m a father to a (always) little girl and a husband.
Contact me at [email protected] for assistance.
