# beads を Homebrew, apt, Nix, scoop, winget, MacPorts でインストール

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

## インストール

```sh
sudo av install brew:beads
```

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

### macOS

- Homebrew (100%):

```sh
brew install beads
```

  証拠: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install bd
```

  証拠: MacPorts ports tree: sysutils/bd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install beads
```

  証拠: Debian stable package indexes: beads from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#beads
```

  証拠: nixpkgs package indexes: pkgs/by-name/be/beads/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/beads
```

  証拠: Scoop official bucket manifest trees: bucket/beads.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id GasTownHall.Beads -e
```

  証拠: Windows Package Manager source index: GasTownHall.Beads from https://cdn.winget.microsoft.com/cache/source.msix

## パッケージ情報

- **パッケージキー:** brew:beads
- **パッケージマネージャ:** Homebrew
- **バージョン:** 1.1.2
- **ソース概要:** Memory upgrade for your coding agent
- **ホームページ:** <https://github.com/gastownhall/beads>
- **リポジトリ:** <https://github.com/gastownhall/beads>
- **最終更新:** 2026-07-27T03:23:28Z
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- bd (エイリアス)
- beads (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

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

Beads is a distributed graph issue tracker for AI-assisted software work. Its core idea is to give coding agents persistent, structured project memory using a dependency-aware issue graph stored in Dolt rather than ad hoc markdown plans.

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

The public GitHub repository for gastownhall/beads was created on 2025-10-12. Its README presents the tool as 'bd - Beads' and describes a cross-platform CLI for macOS, Linux, Windows, and FreeBSD, with Dolt as the version-controlled SQL storage backend.

The project moved quickly from pre-1.0 tags in October 2025 to 1.0.x releases in April and May 2026, followed by a 1.1.0 release candidate in June 2026. The README documents agent setup commands for Codex, Claude Code, Factory.ai Droid, Cursor, Copilot, and other environments, showing that agent integration became part of the main product surface rather than an add-on.

### 採用の歴史

Beads adoption is unusually fast for a young developer tool. The official repository metadata showed 24,977 stars and 1,668 forks on 2026-06-30, and the README documents installation through Homebrew, npm, an install script, Go source builds, Windows support, Arch AUR, and related MCP/PyPI packaging.

The package-manager facts in this batch list Homebrew, Debian, Ubuntu, MacPorts, Nix, and winget entries. That distribution spread matters because Beads is meant to be installed once and used across projects, including by automated agents that need a predictable CLI.

### 使われ方

Typical use starts with 'bd init' inside a project. Core commands include 'bd ready' for unblocked work, 'bd create' for new tasks, 'bd update --claim' for atomic claiming, 'bd dep add' for dependency links, 'bd show' for details, 'bd prime' for agent context, and 'bd remember' for persistent project memory.

The README documents two storage modes: embedded Dolt by default for a single-writer local database, and server mode for an external dolt sql-server when concurrent writers matter. It also describes git-free and stealth modes for non-git workspaces, CI, monorepos, evaluations, and personal planning.

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

Beads is package-nerd significant because it packages a new workflow assumption: issue tracking as local, mergeable, agent-readable state in the repository neighborhood. It sits at the intersection of CLI issue trackers, local-first databases, Dolt, MCP, and coding-agent coordination.

It is also a good example of a modern package needing many ecosystem edges at once: Homebrew formulae for shell users, npm for Node workflows, PyPI/MCP for agent integrations, winget for Windows, and docs that teach agents as first-class users.

### タイムライン

- 2025-10-12: gastownhall/beads repository is created.
- 2025-10-14: v0.9.1 is published as an early public release.
- 2026-04-15: v1.0.1 and v1.0.2 are published.
- 2026-05-09: v1.0.4 is published.
- 2026-06-26: v1.1.0-rc.1 is published.

### Related projects

- Dolt is the storage backend named by the README.
- Beads Viewer is a companion terminal UI and graph-analysis sidecar for Beads issue exports.
- MCP, Codex, Claude Code, Factory.ai Droid, Cursor, and Copilot appear in the official setup and integration docs as agent/editor surfaces.

### ソース

- <https://api.github.com/repos/gastownhall/beads>
- <https://api.github.com/repos/gastownhall/beads/releases>
- <https://raw.githubusercontent.com/gastownhall/beads/main/README.md>
- source_facts.package-manager


## セキュリティノート

beads に一致するローカルシークレット処理マニフェストは見つかりませんでした。将来の対応で安定したパッケージ 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: ~/.beads/config.yaml, ~/.config/bd/config.yaml, <repo>/.beads/config.yaml, $BEADS_DIR/config.yaml, <repo>/.beads/config.local.yaml
## 他のパッケージマネージャ記録

- Debian apt - beads - 1.1.22-1+b5: normalized package name match | Debian stable package indexes: beads from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | 2-DE electrophoresis gel image spot detection | http://pappso.inrae.fr/bioinfo/beads
- Nix - beads: normalized package name match | nixpkgs package indexes: pkgs/by-name/be/beads/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - beads - 1.1.22-1build4: normalized package name match | Ubuntu 24.04 LTS package indexes: beads from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | 2-DE electrophoresis gel image spot detection | http://pappso.inrae.fr/bioinfo/beads
- Scoop - main/beads: normalized package name match | Scoop official bucket manifest trees: bucket/beads.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - GasTownHall.Beads: normalized package name match | Windows Package Manager source index: GasTownHall.Beads from https://cdn.winget.microsoft.com/cache/source.msix
- MacPorts - bd: installed executable or alias match | MacPorts ports tree: sysutils/bd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Debian apt - bd - 1.03-5: installed executable or alias match | Debian stable package indexes: bd from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | quickly go back to a specific parent directory in bash | https://github.com/vigneshwaranr/bd
- Ubuntu apt - bd - 1.03-3: installed executable or alias match | Ubuntu 24.04 LTS package indexes: bd from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | quickly go back to a specific parent directory in bash | https://github.com/vigneshwaranr/bd


## Combined YAML source

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


## ソース

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