Automic VaultAutomic Vault

brew

使用 Homebrew, apt, Nix, winget, MacPorts 安装 beads

查看 beads 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

安装命令安全说明

安装

其他安装命令

macOS

Homebrew已验证 · 100%
brew install beads

local Homebrew formula metadata

MacPorts已验证 · 94%
sudo port install bd

MacPorts ports tree · sysutils/bd/Portfile · 来源: api.github.com

Linux

Debian apt已验证 · 92%
sudo apt install beads

Debian stable package indexes · beads · 来源: deb.debian.org

Nix已验证 · 92%
nix profile install nixpkgs#beads

nixpkgs package indexes · pkgs/by-name/be/beads/package.nix · 来源: api.github.com

Windows

Windows Package Manager已验证 · 92%
winget install --id GasTownHall.Beads -e

Windows Package Manager source index · GasTownHall.Beads · 来源: cdn.winget.microsoft.com

概览

软件包摘要

Memory upgrade for your coding agent

命令和别名

  • bd
  • beads

历史

项目历史与用法

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.

安全态势

尚未找到受保护工具覆盖

没有找到 beads 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。

安装行为

  • formula 元数据中未记录 Homebrew post-install 钩子。
  • Homebrew bottle 元数据适用于 6 个平台目标。
  • 安装时包含 2 个运行时依赖。
  • 构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

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
~/.beads/config.yaml~/.config/bd/config.yaml<repo>/.beads/config.yaml$BEADS_DIR/config.yaml<repo>/.beads/config.local.yaml

可执行文件

已安装的可执行文件

命令类型暴露范围备注
bdcli全局可执行文件
beadscli全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-25
管理器版本1.1.0
管理器更新时间2026-07-04
本地数据OK
上游当前
检测到的最新版本v1.1.0

https://github.com/gastownhall/beads

  • OK没有生成新鲜度警告。

安装元数据

软件包元数据

软件包键brew:beads
版本1.1.0
软件包管理器Homebrew
软件包管理器页面https://formulae.brew.sh/formula/beads
主页https://github.com/gastownhall/beads
仓库https://github.com/gastownhall/beads
上游文档https://gastownhall.github.io/beads
许可证MIT
源码归档https://github.com/gastownhall/beads/archive/refs/tags/v1.1.0.tar.gz
最后更新2026-07-04T10:22:22+03:00
Pulseupdated
依赖dolt, icu4c@78
构建依赖go
Bottle可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install未定义
服务未声明

注册表事实

源数据库详情

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

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Debian apt95%

beads 1.1.22-1+b5

2-DE electrophoresis gel image spot detection

http://pappso.inrae.fr/bioinfo/beads

sudo apt install beads
  • Section: science
  • Architecture: amd64
  • Source Package: beads
  • 13 依赖
  • normalized package name match
  • 匹配方式：Beads
Debian stable package indexes · deb.debian.org · Debian stable package indexes: beads from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

beads

nix profile install nixpkgs#beads
  • normalized package name match
  • 匹配方式：Beads
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/be/beads/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

beads 1.1.22-1build4

2-DE electrophoresis gel image spot detection

http://pappso.inrae.fr/bioinfo/beads

sudo apt install beads
  • Section: universe/science
  • Architecture: amd64
  • 13 依赖
  • normalized package name match
  • 匹配方式：Beads
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: beads from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
winget95%

GasTownHall.Beads

winget install --id GasTownHall.Beads -e
  • normalized package name match
  • 匹配方式：Beads
Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: GasTownHall.Beads from https://cdn.winget.microsoft.com/cache/source.msix
MacPorts94%

bd

sudo port install bd
  • installed executable or alias match
  • 匹配方式：Bd
MacPorts ports tree · api.github.com · MacPorts ports tree: sysutils/bd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
Debian apt92%

bd 1.03-5

quickly go back to a specific parent directory in bash

https://github.com/vigneshwaranr/bd

sudo apt install bd
  • Section: utils
  • Architecture: all
  • 1 依赖
  • installed executable or alias match
  • 匹配方式：Bd
Debian stable package indexes · deb.debian.org · Debian stable package indexes: bd from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Ubuntu apt92%

bd 1.03-3

quickly go back to a specific parent directory in bash

https://github.com/vigneshwaranr/bd

sudo apt install bd
  • Section: universe/utils
  • Architecture: all
  • 1 依赖
  • installed executable or alias match
  • 匹配方式：Bd
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: bd from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

相关工具

  • doltRuntime dependency declared by Homebrew.
  • goBuild dependency declared by Homebrew.
  • gascityPopular package that depends on this formula.
  • gastownPopular package that depends on this formula.

相同工作流

  • letta-codeShares av.db curated category or tags: ai, cli, coding-agent, coding-agents, memory.
  • mimo-codeShares av.db curated category or tags: ai, cli, coding-agent, coding-agents, memory.
  • clineShares av.db curated category or tags: ai, cli, coding-agent, coding-agents.
  • forgecodeShares av.db curated category or tags: ai, cli, coding-agent, coding-agents.
  • kimi-cliShares av.db curated category or tags: ai, cli, coding-agent, coding-agents.
  • mistral-vibeShares av.db curated category or tags: ai, cli, coding-agent, coding-agents.

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

使用的来源

  • 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
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment