From 0250b87c2f349cb74213796c7f8e38c2d97ccb58 Mon Sep 17 00:00:00 2001 From: Chris Sells Date: Tue, 6 Oct 2026 10:21:05 -0700 Subject: [PATCH 01/11] docs(upgrading): scope the shared-server read failure to pre-1.2.0 schemas #7284 said most reads fail between upgrading a shared server's clients and running `bd migrate schema`. That only holds for a schema older than 1.2.0: the leases table ships with main migration 0055 and ignored 0012 and 0016, all in v1.2.0. From 1.2.x, reads keep working and only writes are refused (probed against a 1.2.1 server with 1.3.1 and main builds). Restore the original wording and add the pre-1.2.0 caveat, naming only the observed `bd list` failure from #6929. Refs #6929 --- docs/getting-started/upgrading.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/docs/getting-started/upgrading.md b/docs/getting-started/upgrading.md index 649383129..daa058bed 100644 --- a/docs/getting-started/upgrading.md +++ b/docs/getting-started/upgrading.md @@ -443,8 +443,9 @@ configured, though the two cases consent differently Upgrade one server's clients like this: ```bash -# 1. Upgrade bd on every client of the server. Until step 2, an upgraded -# client refuses writes and most reads fail (see below). +# 1. Upgrade bd on every client of the server. Reads keep working throughout — +# an upgraded client reads the old schema, it just cannot write to it +# (unless the server predates 1.2.0; see below). bd version # on each client, confirm the new version # 2. Once, from a workspace already set up against this server: consent. @@ -454,11 +455,15 @@ bd migrate schema # add --global for the shared global database bd doctor ``` -Between steps 1 and 2, an upgraded client refuses writes with the gate's -guidance, and most reads fail too: `bd list`, `bd show` and `bd ready` stop -with `table not found: leases`, because 1.3 reads expect tables the old schema -lacks. Nothing is silently promoted, so there is no deadline, but nothing works -in that window either, so run step 2 as soon as the clients are upgraded. +Between steps 1 and 2, an upgraded client reads normally and its writes are +refused with the gate's guidance. Nothing is silently promoted, so there is no +deadline — but the window is a degraded one, so keep it short. + +If the server's schema predates 1.2.0 (an upgrade from 1.1.x or earlier), +reads can fail too until step 2: `bd list` stops with +`table not found: leases` +([#6929](https://github.com/gastownhall/beads/issues/6929)). Run step 2 as +soon as the clients are upgraded. **If the shared server also has a Dolt remote**, step 2 is not enough. Two hazards now apply at once — the co-resident lockout above and the cross-clone From 37a9867977cae06ec081f84e082a9998f82a5944 Mon Sep 17 00:00:00 2001 From: cuongntr Date: Mon, 28 Sep 2026 16:44:30 +0700 Subject: [PATCH 02/11] docs: add beads-viewer (Paseo plugin) to community tools Co-Authored-By: Claude Opus 5.5 (cherry picked from commit ad28cf00ba48431ad7c9a0c3e663119cb30f2f27) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index 13ee5b828..6b51f747c 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -49,6 +49,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[beads-manager](https://plugins.jetbrains.com/plugin/30089-beads-manager)** - Jetbrains IDE plugin to manage and view bead details. Maintained by [@developmeh](https://github.com/developmeh). (Kotlin) +- **[beads-viewer](https://github.com/cuongntr/paseo-beads-viewer)** - Read-only Beads console for [Paseo](https://paseo.sh) workspaces: progress per parent issue, ready and waiting work, the critical dependency chain, a whole-project board, issue search and detail, and a composer attachment source for issues. Follows `bd` changes live through the events journal when it is turned on. Reads through `bv` and the `bd`/`br` CLI, never writes. Install with `paseo plugin install beads-viewer`. Built by [@cuongntr](https://github.com/cuongntr). (TypeScript/React Native) + ## Native Apps - **[Beads Task-Issue Tracker](https://github.com/w3dev33/beads-task-issue-tracker)** - Cross-platform desktop application (macOS, Windows, Linux) for browsing, creating, and managing Beads issues with a visual interface. Features multi-project support with favorites, image attachments, dashboard with statistics, advanced filtering, and dark/light theme. Built by [@w3dev33](https://github.com/w3dev33). (Tauri/Vue) From fe50f689df51d5c867fb5d485de93fe8b8387001 Mon Sep 17 00:00:00 2001 From: Leslie Russell Date: Mon, 28 Sep 2026 11:04:07 -0500 Subject: [PATCH 03/11] Add LazyBeads (lb) to community tools - List lesliesrussell/lazybeads under Terminal UIs - Note that it is unrelated to the earlier lazybeads under Historical Co-Authored-By: Claude Opus 5.5 (cherry picked from commit 1aa2b645e240378e8b5a103f53a90e7563996265) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index 6b51f747c..0ea71659e 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -18,6 +18,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[beady-eye](https://github.com/CodeForBreakfast/beady-eye)** - Live terminal viewer that follows agents as they work through a tree of beads, redrawing as they claim and finish them. Integrates with [herdr](https://herdr.dev), and watches several projects at once. Read-only. Built by [@GraemeF](https://github.com/GraemeF). (Rust) +- **[LazyBeads](https://github.com/lesliesrussell/lazybeads)** (`lb`) - Terminal operator console that ranks ready work, explains why each bead is ready, and claims, closes and links beads with confirmation. The TUI and `lb status --watch` follow the events journal and redraw as agents change beads; on Dolt-server workspaces it uses `bd serve`, and the `bd` CLI otherwise. Not related to the earlier lazybeads listed under Historical. Built by [@lesliesrussell](https://github.com/lesliesrussell). (Go) + ## Web UIs - **[bd-board](https://github.com/jeanpfs/bd-board)** - Local-first web dashboard for browsing Beads projects, viewing kanban boards by status or epic swimlanes, and filtering by priority, text search, or sort order. Uses the `bd` CLI for Dolt compatibility, with writes disabled unless explicitly enabled. Built by [@jeanpfs](https://github.com/jeanpfs). (TanStack Start/React) From 69330c3296a2ce7c7599529318ff7a78ed5491f3 Mon Sep 17 00:00:00 2001 From: weselow <598746@gmail.com> Date: Tue, 29 Sep 2026 00:06:19 +0400 Subject: [PATCH 04/11] docs(community-tools): update the beads-web entry Co-Authored-By: Claude Opus 5.5 (cherry picked from commit aa177110b326ccebb8e725aa12ce1a72b3ca3ae0) --- docs/community-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-tools.md b/docs/community-tools.md index 0ea71659e..db63ba41b 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -28,7 +28,7 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[BeadBoard](https://github.com/zenchantlive/beadboard)** - Multi-agent orchestration and communication system with a live dashboard. Agent-to-agent messaging (HANDOFF/BLOCKED/DECISION/INFO), DAG dependency graph, swarm coordination with archetypes and templates, scope-based work reservations, and an embedded execution runtime (bb-pi) built on [Pi](https://github.com/badlogic/pi-mono) that spawns typed worker agents. Cross-platform (macOS, Linux, Windows). Includes the `beadboard-driver` skill for agent integration (`npx skills add zenchantlive/beadboard --skill beadboard-driver`). Built by [@zenchantlive](https://github.com/zenchantlive). (Next.js/TypeScript) -- **[beads-web](https://github.com/weselow/beads-web)** - Actively maintained fork of beads-kanban-ui. Cross-platform single-binary distribution (macOS, Linux, Windows), 7 visual themes, Dolt direct SQL integration, Windows multi-drive path support, drag-and-drop status updates. Download from [GitHub Releases](https://github.com/weselow/beads-web/releases). Built by [@weselow](https://github.com/weselow). (TypeScript/Rust) +- **[beads-web](https://github.com/weselow/beads-web)** - Actively maintained fork of beads-kanban-ui. Multi-project Kanban board with epics and 11 themes. Live updates follow the `bd events` journal on embedded workspaces (bd 1.3.0+); server-mode workspaces are read directly from Dolt over SQL. Single binary for macOS, Linux and Windows, also via Scoop, Homebrew, winget and Nix. Download from [GitHub Releases](https://github.com/weselow/beads-web/releases). Built by [@weselow](https://github.com/weselow). (TypeScript/Rust) - **[Bead Me Up, Scotty](https://github.com/brendan-appstart/bead-me-up-scotty)** - Polished multi-project web UI for creating, updating, and prioritizing beads across all your repos from one place. Kanban board with drag-and-drop status changes and reordering, plus list, epics (with progress bars), and dependency-graph views; faceted filtering and full-text search; live updates via SSE that react the moment `.beads/` changes; and human-vs-agent attribution throughout. Uses the `bd` CLI for full Dolt compatibility. Global install (`scotty`) opens the current directory's project in your browser, and a built-in Publish view generates a shareable static showcase site from your beads. Live demo at [beadmeupscotty.com](https://beadmeupscotty.com). Built by [@brendan-appstart](https://github.com/brendan-appstart). (Next.js/TypeScript) From 6cba0ed8722432ece1770a25f17f072d20a12189 Mon Sep 17 00:00:00 2001 From: weselow <598746@gmail.com> Date: Tue, 29 Sep 2026 14:11:53 +0400 Subject: [PATCH 05/11] docs(community-tools): mention the beads-web tree view Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01QebAVaD36wUemAsdBx8wwJ (cherry picked from commit e0eb482a11f461e3bfa46b2c23de1c97d3055dce) --- docs/community-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-tools.md b/docs/community-tools.md index db63ba41b..ccf80c86b 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -28,7 +28,7 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[BeadBoard](https://github.com/zenchantlive/beadboard)** - Multi-agent orchestration and communication system with a live dashboard. Agent-to-agent messaging (HANDOFF/BLOCKED/DECISION/INFO), DAG dependency graph, swarm coordination with archetypes and templates, scope-based work reservations, and an embedded execution runtime (bb-pi) built on [Pi](https://github.com/badlogic/pi-mono) that spawns typed worker agents. Cross-platform (macOS, Linux, Windows). Includes the `beadboard-driver` skill for agent integration (`npx skills add zenchantlive/beadboard --skill beadboard-driver`). Built by [@zenchantlive](https://github.com/zenchantlive). (Next.js/TypeScript) -- **[beads-web](https://github.com/weselow/beads-web)** - Actively maintained fork of beads-kanban-ui. Multi-project Kanban board with epics and 11 themes. Live updates follow the `bd events` journal on embedded workspaces (bd 1.3.0+); server-mode workspaces are read directly from Dolt over SQL. Single binary for macOS, Linux and Windows, also via Scoop, Homebrew, winget and Nix. Download from [GitHub Releases](https://github.com/weselow/beads-web/releases). Built by [@weselow](https://github.com/weselow). (TypeScript/Rust) +- **[beads-web](https://github.com/weselow/beads-web)** - Actively maintained fork of beads-kanban-ui. Multi-project Kanban board plus a tree view of milestones, epics, tasks and subtasks at any depth, 11 themes. Live updates follow the `bd events` journal on embedded workspaces (bd 1.3.0+); server-mode workspaces are read directly from Dolt over SQL. Single binary for macOS, Linux and Windows, also via Scoop, Homebrew, winget and Nix. Download from [GitHub Releases](https://github.com/weselow/beads-web/releases). Built by [@weselow](https://github.com/weselow). (TypeScript/Rust) - **[Bead Me Up, Scotty](https://github.com/brendan-appstart/bead-me-up-scotty)** - Polished multi-project web UI for creating, updating, and prioritizing beads across all your repos from one place. Kanban board with drag-and-drop status changes and reordering, plus list, epics (with progress bars), and dependency-graph views; faceted filtering and full-text search; live updates via SSE that react the moment `.beads/` changes; and human-vs-agent attribution throughout. Uses the `bd` CLI for full Dolt compatibility. Global install (`scotty`) opens the current directory's project in your browser, and a built-in Publish view generates a shareable static showcase site from your beads. Live demo at [beadmeupscotty.com](https://beadmeupscotty.com). Built by [@brendan-appstart](https://github.com/brendan-appstart). (Next.js/TypeScript) From f975ece24729f7571d913429530dfd2384213642 Mon Sep 17 00:00:00 2001 From: Beyond Better Date: Tue, 29 Sep 2026 10:36:25 +1000 Subject: [PATCH 06/11] Updated community tools documentation with Beads Tracker Applied changes from BB to 1 file Files modified: - docs/community-tools.md Updated community tools documentation Applied changes from BB to 1 file Files modified: - docs/community-tools.md Updated community tools documentation Applied changes from BB to 1 file Files modified: - docs/community-tools.md (cherry picked from commit 75d0f8de0c2a3181d618ade902c73d929d8be221) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index ccf80c86b..a1e69254f 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -63,6 +63,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[Beadazzle](https://github.com/Mosnar/beadazzle)** - Fully native, fully open-source macOS app (SwiftUI, macOS 14+) for browsing and managing Beads issues, tuned for large embedded-mode projects. Unlike the Tauri-based clients, it's built directly on SwiftUI/AppKit for a fast, dense, Linear-inspired desktop UI. Features a sidebar/list/detail layout with outline mode, search, filtering, sorting, and multi-selection; full detail editing with rich Markdown editing and live preview (title, description, design, acceptance criteria, notes, labels, status, priority, assignee, dates); a dedicated gate queue with approve/reject and gate-aware blockers; parent/sub-issue hierarchies with breadcrumbs and inline child creation; fast dependency pickers with quick-create; and a project storage view for Dolt remote health, explicit pull/push, and snapshot freshness. Requires a current Dolt-backed project in embedded, server, or shared-server mode, resolved through `bd context` — legacy SQLite-backed projects are intentionally unsupported. Reads by asking `bd export` for a readable JSONL snapshot in the tracker directory `bd` reports — creating one if none exists, and re-exporting after mutations and manual refreshes — then indexes it in memory for responsive navigation; all writes route through `bd` to preserve Beads hooks, history, and validation. Zero telemetry, analytics, or crash reporting — everything stays local on your machine. Ships as a signed and notarized DMG with Sparkle auto-updates. Built by [@Mosnar](https://github.com/Mosnar). (Native macOS/SwiftUI) +- **[Beads Tracker](https://github.com/cngarrison/beads-tracker)** - Native macOS app (SwiftUI), multi-window with one project per window, for creating and browsing Beads issues without touching the CLI. A create form mirrors `bd create-form` (title, description, type, priority, assignee, labels, external reference, design notes, acceptance criteria, dependencies), plus a live issues list with status indicators, priority badges, and one-click ID copying. Works with both embedded and server-mode Dolt projects. Persistent repo selection across launches. Built and released via GitHub Actions as a signed and notarized DMG — download, mount, drag to Applications, and run, with no Gatekeeper warnings. Deliberately minimal by design — no Xcode project, Swift Package Manager manifest, or third-party dependencies, just a single `swiftc` invocation in the `Makefile` — keeping the codebase small enough for an AI coding agent to pick up and ship a contribution without first onboarding onto a large project. Built by [@cngarrison](https://github.com/cngarrison). (Swift/SwiftUI) + ## Data Source Middleware - **[stringer](https://github.com/davetashner/stringer)** - Codebase archaeology CLI that mines git repos for TODOs, churn hotspots, lottery-risk files, dependency health, and more. Outputs JSONL compatible with `bd init --from-jsonl`. Install with `brew install davetashner/tap/stringer`. Built by [@davetashner](https://github.com/davetashner). (Go) From 86c454d11cb461e234ea3b3dbc0362670d0282e9 Mon Sep 17 00:00:00 2001 From: vanderheijden86 Date: Tue, 29 Sep 2026 11:08:50 +0200 Subject: [PATCH 07/11] docs: add b9s to community tools (TUI and web UI) (cherry picked from commit 8bb6ab6913d9b29d2cd29a8871ec3d2e1881ce5f) --- docs/community-tools.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index a1e69254f..e72bcf8d6 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -20,6 +20,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[LazyBeads](https://github.com/lesliesrussell/lazybeads)** (`lb`) - Terminal operator console that ranks ready work, explains why each bead is ready, and claims, closes and links beads with confirmation. The TUI and `lb status --watch` follow the events journal and redraw as agents change beads; on Dolt-server workspaces it uses `bd serve`, and the `bd` CLI otherwise. Not related to the earlier lazybeads listed under Historical. Built by [@lesliesrussell](https://github.com/lesliesrussell). (Go) +- **[b9s](https://github.com/vanderheijden86/b9s)** - Keyboard-driven terminal UI for Beads, modelled on k9s: issue tree, a list of the latest changes, and a kanban board with epic swimlanes, all updating live as you and your agents work. The same app runs in a desktop or phone browser with full feature parity (see Web UIs). Live demo at [demo.b9s.osen.co](https://demo.b9s.osen.co). Built by [@vanderheijden86](https://github.com/vanderheijden86). (Go) + ## Web UIs - **[bd-board](https://github.com/jeanpfs/bd-board)** - Local-first web dashboard for browsing Beads projects, viewing kanban boards by status or epic swimlanes, and filtering by priority, text search, or sort order. Uses the `bd` CLI for Dolt compatibility, with writes disabled unless explicitly enabled. Built by [@jeanpfs](https://github.com/jeanpfs). (TanStack Start/React) @@ -36,6 +38,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[beadcyte](https://gitlab.com/incytestudios/beadcyte)** - Local web app that draws two things that look alike and are not: what happened, which is measured, and what it expects to happen, which is a model's opinion. Three models drive the projection — a historical-median duration estimator, a greedy WIP-cap scheduler calibrated against your real throughput, and an eight-signal triage score — each shown with its own uncertainty rather than a flat number. Views for what to do next, the team's frontier, what-if plan diffs, and cost per week; a single self-contained SVG export with no server (`beadcyte --out gantt.svg`); and a changelog generated from closed beads that carry ship evidence. Reads and writes through the `bd` CLI (`bd list --all --json`, `bd show`, `bd history`); `beadcyte freeze` additionally reads the embedded Dolt database directly (read-only, opt out with `--no-dolt`) — never `.beads/issues.jsonl`. Run with `npx beadcyte start`. Built by [Incyte Studios](https://incytestudios.com) ([@treystout](https://github.com/treystout)). (Node.js/Vue) +- **[b9s web](https://github.com/vanderheijden86/b9s)** - The b9s terminal UI (see Terminal UIs) in your browser, with full feature parity: tree, kanban board, search and editing, all updating live. Responsive from a phone screen to a wide desktop board with drag-and-drop. Live demo at [demo.b9s.osen.co](https://demo.b9s.osen.co). Built by [@vanderheijden86](https://github.com/vanderheijden86). (Go) + ## Editor Extensions - **[vscode-beads](https://marketplace.visualstudio.com/items?itemName=planet57.vscode-beads)** - VS Code extension with issues panel and server management. Built by [@jdillon](https://github.com/jdillon). (TypeScript) From 5b3b4847535218a26d00fdf3dac805e44c9ac11a Mon Sep 17 00:00:00 2001 From: Andreas Dellrud Date: Tue, 29 Sep 2026 11:53:15 +0200 Subject: [PATCH 08/11] docs: add btui to community tools (btui-bb2) Agent-Signature: codex-unknown-model-unknown-reasoning on behalf of Andreas Dellrud (cherry picked from commit 81da372c63cbbf60995d3865d9077a4a76d76eb3) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index e72bcf8d6..237691ec8 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -22,6 +22,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[b9s](https://github.com/vanderheijden86/b9s)** - Keyboard-driven terminal UI for Beads, modelled on k9s: issue tree, a list of the latest changes, and a kanban board with epic swimlanes, all updating live as you and your agents work. The same app runs in a desktop or phone browser with full feature parity (see Web UIs). Live demo at [demo.b9s.osen.co](https://demo.b9s.osen.co). Built by [@vanderheijden86](https://github.com/vanderheijden86). (Go) +- **[btui](https://github.com/AndreasDellrud/beads-tui)** - Read-only terminal browser with active, ready, and closed views, filtering, keyboard and mouse navigation, and issue details with comments and dependency relationships. Launches Codex or Claude Code sessions for selected work, with optional [Herdr](https://herdr.dev) worktree integration. Reads through the installed `bd --readonly` CLI. Built by [@AndreasDellrud](https://github.com/AndreasDellrud). (Rust/Ratatui) + ## Web UIs - **[bd-board](https://github.com/jeanpfs/bd-board)** - Local-first web dashboard for browsing Beads projects, viewing kanban boards by status or epic swimlanes, and filtering by priority, text search, or sort order. Uses the `bd` CLI for Dolt compatibility, with writes disabled unless explicitly enabled. Built by [@jeanpfs](https://github.com/jeanpfs). (TanStack Start/React) From 614a164a8497580060c3370eb46901120a95c1b5 Mon Sep 17 00:00:00 2001 From: Andreas Dellrud Date: Tue, 29 Sep 2026 12:17:14 +0200 Subject: [PATCH 09/11] docs: mention released btui Beads 1.3 support (btui-0fm) Agent-Signature: codex-unknown-model-unknown-reasoning on behalf of Andreas Dellrud (cherry picked from commit 8f27445bee87eb9d17f15f04179ced18f3bd69c0) --- docs/community-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-tools.md b/docs/community-tools.md index 237691ec8..4a50b41e0 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -22,7 +22,7 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[b9s](https://github.com/vanderheijden86/b9s)** - Keyboard-driven terminal UI for Beads, modelled on k9s: issue tree, a list of the latest changes, and a kanban board with epic swimlanes, all updating live as you and your agents work. The same app runs in a desktop or phone browser with full feature parity (see Web UIs). Live demo at [demo.b9s.osen.co](https://demo.b9s.osen.co). Built by [@vanderheijden86](https://github.com/vanderheijden86). (Go) -- **[btui](https://github.com/AndreasDellrud/beads-tui)** - Read-only terminal browser with active, ready, and closed views, filtering, keyboard and mouse navigation, and issue details with comments and dependency relationships. Launches Codex or Claude Code sessions for selected work, with optional [Herdr](https://herdr.dev) worktree integration. Reads through the installed `bd --readonly` CLI. Built by [@AndreasDellrud](https://github.com/AndreasDellrud). (Rust/Ratatui) +- **[btui](https://github.com/AndreasDellrud/beads-tui)** - Read-only terminal browser with active, ready, and closed views, filtering, keyboard and mouse navigation, and issue details with comments and dependency relationships. Launches Codex or Claude Code sessions for selected work, with optional [Herdr](https://herdr.dev) worktree integration. Reads through the installed `bd --readonly` CLI. Supports Beads 1.3.0 with optional event-triggered refresh, retaining polling fallback for older versions and unjournaled changes. Built by [@AndreasDellrud](https://github.com/AndreasDellrud). (Rust/Ratatui) ## Web UIs From ddc9afb43df31525de4c968b464700308d5f6c74 Mon Sep 17 00:00:00 2001 From: "michal.psencik" Date: Tue, 29 Sep 2026 19:02:14 +0200 Subject: [PATCH 10/11] docs: add beadside to community tools (cherry picked from commit 2c2cb1fd5c895e3a8733ec8c8762564c8521ab5e) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index 4a50b41e0..3e85c706e 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -42,6 +42,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[b9s web](https://github.com/vanderheijden86/b9s)** - The b9s terminal UI (see Terminal UIs) in your browser, with full feature parity: tree, kanban board, search and editing, all updating live. Responsive from a phone screen to a wide desktop board with drag-and-drop. Live demo at [demo.b9s.osen.co](https://demo.b9s.osen.co). Built by [@vanderheijden86](https://github.com/vanderheijden86). (Go) +- **[beadside](https://github.com/thatmike1/beadside)** - Local web reader and inbox between you and your agents. A dense index groups beads into lanes by your own labels, with a waiting-on-you section first, and the selected bead stays open beside it with its description, notes and comment thread rendered as Markdown. Notes you write land as comments under your own author id and can flag the bead so the next agent session reads them first. Live updates follow `bd events tail --follow` when the events journal is on, with polling as the fallback. Full-text search over ids, titles, descriptions, notes and comments, also available to agents as `beadside search --json`. Uses the `bd` CLI for every read and write. Built by [@thatmike1](https://github.com/thatmike1). (TypeScript/React) + ## Editor Extensions - **[vscode-beads](https://marketplace.visualstudio.com/items?itemName=planet57.vscode-beads)** - VS Code extension with issues panel and server management. Built by [@jdillon](https://github.com/jdillon). (TypeScript) From ed4592223c64c6eb1b944a82ca5de850fbdd4125 Mon Sep 17 00:00:00 2001 From: Rome-1 Date: Tue, 29 Sep 2026 23:52:47 -0700 Subject: [PATCH 11/11] docs: add Beads for Obsidian to community tools (cherry picked from commit cb82d067d83c9387dcd2e5279c73030969090a5f) --- docs/community-tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community-tools.md b/docs/community-tools.md index 3e85c706e..6b4477e7f 100644 --- a/docs/community-tools.md +++ b/docs/community-tools.md @@ -61,6 +61,8 @@ A curated list of community-built UIs, extensions, and integrations for Beads. R - **[beads-viewer](https://github.com/cuongntr/paseo-beads-viewer)** - Read-only Beads console for [Paseo](https://paseo.sh) workspaces: progress per parent issue, ready and waiting work, the critical dependency chain, a whole-project board, issue search and detail, and a composer attachment source for issues. Follows `bd` changes live through the events journal when it is turned on. Reads through `bv` and the `bd`/`br` CLI, never writes. Install with `paseo plugin install beads-viewer`. Built by [@cuongntr](https://github.com/cuongntr). (TypeScript/React Native) +- **[Beads for Obsidian](https://github.com/Rome-1/obsidian-beads)** - Obsidian plugin with a tabbed Ready / In progress / Blocked / Closed pane, beads that open and save like notes, and live `beads` query blocks inside any note. With the 1.3 events journal on, it follows `bd events tail` and updates the moment a bead changes; it asks before turning the journal on, and otherwise polls. Reads and writes only through the `bd` CLI. Built by [@Rome-1](https://github.com/Rome-1). (TypeScript) + ## Native Apps - **[Beads Task-Issue Tracker](https://github.com/w3dev33/beads-task-issue-tracker)** - Cross-platform desktop application (macOS, Windows, Linux) for browsing, creating, and managing Beads issues with a visual interface. Features multi-project support with favorites, image attachments, dashboard with statistics, advanced filtering, and dark/light theme. Built by [@w3dev33](https://github.com/w3dev33). (Tauri/Vue)