# beads_viewer を Homebrew でインストール

beads_viewer のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:beads_viewer
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install beads_viewer
```

  証拠: local Homebrew formula metadata

## パッケージ情報

- **パッケージキー:** brew:beads_viewer
- **パッケージマネージャ:** Homebrew
- **バージョン:** 0.18.0
- **ソース概要:** Terminal-based UI for the Beads issue tracker
- **ホームページ:** <https://github.com/Dicklesworthstone/beads_viewer>
- **リポジトリ:** <https://github.com/Dicklesworthstone/beads_viewer>
- **最終更新:** 2026-07-26T10:56:32+02:00
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- bv (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 0.18.0
## プロジェクトの歴史と使われ方

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.

### プロジェクトの歴史

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.

### 採用の歴史

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.

### 使われ方

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.

### パッケージ好きにとっての重要性

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.

### タイムライン

- 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.

### ソース

- <https://api.github.com/repos/Dicklesworthstone/beads_viewer>
- <https://api.github.com/repos/Dicklesworthstone/beads_viewer/releases>
- <https://raw.githubusercontent.com/Dicklesworthstone/beads_viewer/main/README.md>


## セキュリティノート

beads_viewer に一致するローカルシークレット処理マニフェストは見つかりませんでした。将来の対応で安定したパッケージ URL を使えるよう、Nucleus パッケージメタデータはここに公開されています。



## 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

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

## Combined YAML source

View the package source record on GitHub. [combined/beads_viewer.yml](https://github.com/mxcl/pkgdb/blob/main/combined/beads_viewer.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph