Automic VaultAutomic Vault

brew

Install beads_viewer with Homebrew

Terminal-based UI for the Beads issue tracker. Version 0.18.0 via Homebrew; verified 2026-07-07.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified ยท 100%
brew install beads_viewer

local Homebrew formula metadata

overview

Package summary

Terminal-based UI for the Beads issue tracker

Commands and aliases

  • bv

history

Project history and usage

Beads Viewer, invoked as bv, is a terminal UI and robot-mode analyzer for projects that use the Beads issue tracker. It turns Beads JSONL exports into browsable lists, kanban boards, dependency graphs, graph metrics, and deterministic JSON/TOON outputs for agents.

Project history

The public repository was created on 2025-11-26, shortly after Beads itself appeared. The README positions it as a keyboard-driven terminal interface for Beads and describes graph-aware features such as PageRank, critical path, cycles, kanban, dependency DAG visualization, and robot-mode JSON APIs.

The release stream moved quickly from v0.8.2 and v0.9.x on 2025-11-27 through v0.10.x in late 2025 and v0.17.x in June 2026. Repository metadata showed 1,596 stars and 130 forks on 2026-06-30, substantial adoption for a companion tool.

Adoption history

Beads Viewer adoption follows Beads adoption: users install it when they want a richer terminal workflow or when agents need graph calculations without parsing raw JSONL. The README documents Homebrew for macOS/Linux, Scoop for Windows, direct release archives, and install scripts.

Its agent-facing adoption is explicit: the README warns not to run bare bv in an agent context and instead documents --robot-triage, --robot-next, --robot-plan, --robot-insights, --robot-history, and related structured-output modes.

How it is used

Human users run bv as an interactive TUI over .beads/issues.jsonl or legacy .beads/beads.jsonl exports, with views for lists, kanban, insights, history, graph navigation, and markdown export.

Agent users call robot flags to get deterministic triage, graph metrics, label health, dependency flow, plans, histories, diffs, forecasts, alerts, suggestions, and graph exports. The README emphasizes stdout-only structured data, stderr diagnostics, bounded history analysis, and checking status fields for approximated or skipped metrics.

Why package nerds care

Beads Viewer matters as a package because it is a sidecar rather than the primary datastore: it consumes an issue export and supplies terminal UX plus graph algorithms. That split mirrors a broader CLI trend where small tools expose both human TUI and machine JSON modes.

For agent workflows, bv packages graph algorithms as a command-line contract. That is useful because LLMs should not have to reconstruct dependency DAGs, PageRank, cycle checks, or critical paths from raw JSONL on every turn.

Timeline

  • 2025-11-26: Dicklesworthstone/beads_viewer repository is created.
  • 2025-11-27: v0.8.2 and v0.9.x releases are published.
  • 2025-11-30: v0.10.x releases are published.
  • 2026-06-09: v0.17.0 is published.
  • 2026-06-26: v0.17.1 is published.

Related projects

  • Beads is the issue tracker whose JSONL exports bv reads.
  • Graphviz and Mermaid are output formats mentioned for graph export.
  • MCP Agent Mail is referenced by the README as a separate coordination tool for agent-to-agent messaging.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for beads_viewer. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
~/.config/bv/config.yaml.bv/hooks.yaml.bv/workspace.yaml.beads/recipes/*.yaml

executables

Installed executables

CommandKindExposureNote
bvcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.18.0
manager updated2026-07-07
local dataok
upstreamcurrent
latest detectedv0.18.0

https://github.com/Dicklesworthstone/beads_viewer

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:beads_viewer
Version0.18.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/beads_viewer
Homepagehttps://github.com/Dicklesworthstone/beads_viewer
Repositoryhttps://github.com/Dicklesworthstone/beads_viewer
Upstream docshttps://github.com/Dicklesworthstone/beads_viewer#readme
LicenseMIT
Source archivehttps://github.com/Dicklesworthstone/beads_viewer/archive/refs/tags/v0.18.0.tar.gz
Last updated2026-07-07T03:21:35Z
Pulseupdated
Build dependenciesgo
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namebeads_viewer
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • goBuild dependency declared by Homebrew.
  • beadsPackage names and metadata indicate a similar tool family. Shared terms: beads, cli, developer, developer-tools.

Same workflow

  • cdkShares av.db curated category or tags: cli, developer-tools, terminal-ui.
  • desedShares av.db curated category or tags: cli, developer-tools, terminal-ui.
  • dhexShares av.db curated category or tags: cli, developer-tools, terminal-ui.
  • diagramShares av.db curated category or tags: cli, developer-tools, terminal-ui.
  • dialogShares av.db curated category or tags: cli, developer-tools, terminal-ui.
  • difiShares av.db curated category or tags: cli, developer-tools, terminal-ui.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • package relationship graph
  • package version freshness
  • package-page enrichment