installation

Commandes d'installation supplémentaires

macOS

Homebrewvérifié · 100%

brew install beads

local Homebrew formula metadata

MacPortsvérifié · 94%

sudo port install bd

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

Linux

Debian aptvérifié · 92%

sudo apt install beads

Debian stable package indexes · beads · Source: deb.debian.org

Nixvérifié · 92%

nix profile install nixpkgs#beads

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

Windows

Windows Package Managervérifié · 92%

winget install --id GasTownHall.Beads -e

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

aperçu

Résumé du paquet

Memory upgrade for your coding agent

Liens du projet

Commandes et alias

bd
beads

historique

Historique du projet et usages

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.

Historique du projet

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.

Historique d'adoption

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.

Modes d'utilisation

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.

Pourquoi les passionnés de paquets s'y intéressent

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.

Chronologie

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.

Sources

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

posture de sécurité

Aucune couverture d'outil protégé trouvée pour le moment

Aucun manifest local de gestion des secrets correspondant n'a été trouvé pour beads. Les métadonnées de paquet Nucleus restent publiées ici afin que la couverture future dispose d'une URL stable.

Comportement d'installation

Aucun hook post-install Homebrew n’est enregistré dans les métadonnées de formule.
Les métadonnées de bottle Homebrew sont disponibles pour 6 plateformes.
S’installe avec 2 dépendances d’exécution.
Les métadonnées de compilation listent 1 dépendances de compilation.

Revue recommandée

Avant une utilisation sans surveillance par un agent, vérifiez si l'outil lit des identifiants en clair, écrit un état distant, publie des artefacts ou lance des 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: ~/.beads/config.yaml~/.config/bd/config.yaml<repo>/.beads/config.yaml$BEADS_DIR/config.yaml<repo>/.beads/config.local.yaml

exécutables

Exécutables installés

Commande	Type	Exposition	Note
`bd`	cli	exécutable global
`beads`	cli	exécutable global

fraîcheur

Version et fraîcheur

Ces signaux séparent l'âge de génération de la page, l'activité du gestionnaire de paquets et la comparaison avec les versions amont. Un retard de version n'est signalé que lorsqu'une URL de preuve et des versions comparables sont présentes.

page générée2026-07-25

version du gestionnaire1.1.0

gestionnaire mis à jour2026-07-04

données localesOK

amontà jour

dernière version détectéev1.1.0

https://github.com/gastownhall/beads

OKAucun avertissement de fraîcheur n'a été généré.

métadonnées d'installation

Métadonnées du paquet

Clé du paquet	brew:beads
Version	1.1.0
Gestionnaire de paquets	Homebrew
Page du gestionnaire de paquets	https://formulae.brew.sh/formula/beads
Page d'accueil	https://github.com/gastownhall/beads
Dépôt	https://github.com/gastownhall/beads
Docs amont	https://gastownhall.github.io/beads
Licence	MIT
Archive source	https://github.com/gastownhall/beads/archive/refs/tags/v1.1.0.tar.gz
Dernière mise à jour	2026-07-04T10:22:22+03:00
Pulse	updated
Dépendances	dolt, icu4c@78
Dépendances de compilation	go
Bouteille	disponible (sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
post-install Homebrew	non défini
Service	aucun déclaré

faits du registre

Détails de la base source

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	beads
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

correspondances dans les bases sources

Autres enregistrements de gestionnaires de paquets

Les correspondances proviennent d’index externes de gestionnaires de paquets et restent séparées des liens de paquets Automic Vault locaux.

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 Dépendances
normalized package name match
Correspondance par : 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
Correspondance par : 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 Dépendances
normalized package name match
Correspondance par : 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
Correspondance par : 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
Correspondance par : 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 Dépendances
installed executable or alias match
Correspondance par : 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 Dépendances
installed executable or alias match
Correspondance par : 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

graphe de paquets

Les liens viennent du graphe local de relations entre paquets, des suppléments, des dépendances, des correspondances d'écosystèmes et de l'appartenance aux hubs.

piste source

Généré depuis les données du dépôt

Cette page est servie par av-web depuis l'artéfact SQLite privé des paquets généré par scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/beads.yml

Sources utilisées

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

Installer beads avec Homebrew, apt, Nix, winget, MacPorts