storywatch

A small, cross-platform desktop viewer for the Storybloq .story/ convention. It watches a project's .story/ directory and shows the live ticket board, open issues, session status, and the latest handover — the same idea as the macOS-only Storybloq app, but on Windows and Linux too.

Independent project. storywatch reads the open .story/ JSON/markdown file format directly. It does not bundle or link the @storybloq/storybloq package (which is PolyForm-Noncommercial), so storywatch itself is MIT-licensed and free to release. Storybloq is a trademark of its authors; this is an unaffiliated community viewer.

What it shows

• Live session status (working / idle, current ticket, workflow state from .story/status.json)
• Ticket board grouped by roadmap phase, with status + blocked indicators
• Open issues with severity
• Latest handover rendered inline
• Auto-refreshes every ~1.5s while a session runs

Stack

Tauri v2 (Rust core + system WebView) + React + TypeScript. The Rust side reads .story/ files directly; the UI polls a single load_story command. A write_channel_event command is stubbed in for a future write-back mode (drop events into .story/channel-inbox/).

Develop

Requires Node 20+ and the Rust toolchain.

npm install
npm run tauri dev      # run the desktop app
npm run tauri build    # produce a native installer

Open any project that has a .story/ directory (run storybloq init in a repo first if needed).

Roadmap

• Native fs watching (replace polling) via the notify crate
• Handover timeline (browse all handovers, not just latest)
• Write-back actions: request ticket, pause/resume, priority change (via channel-inbox/)
• Federation view (aggregate multiple node .story/ dirs)
• Markdown rendering for handovers

License

MIT © 2026 — see LICENSE.