Beads

Steve Yegge · GasTownHall.Beads

A memory upgrade for your coding agent

Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.

winget install --id GasTownHall.Beads --exact --source winget

Latest 1.0.0

Release Notes

Features

  • 5e60961852167574687f4d4681761f077559bacf feat(init): add --non-interactive and --role flags for CI/cloud agents
  • 29531d2b68adf4ba6ddd304c5649b9717d303c3a feat: GitLab sync — dedup fixes, type filtering, epic→milestone mapping, work item hierarchy (#2889)
  • 7806fbf47f6284a79d421203690a28565b096ce3 feat: add --non-interactive flag to bd bootstrap for CI (#2942)
  • 677f7bcd3da65755c7abc9c0cc7e10bbd2438fd7 feat: add SlotSet/SlotGet/SlotClear to Storage interface (#2870)
  • c46be6eee501e2eaa70d38abca8e3aa39c23ea91 feat: add bd config set-many for batch config operations (#2943)
  • 4d88e4ac75bcfd79659bada15a158b3f55ea6c4b feat: add public format package for issue rendering (#2871)
  • 08ee138917621d1d27f70aafd3f267eda703ca67 feat: add spike, story, and milestone as first-class issue types (#2923)
  • 9b90ada4f6deb6df1f8293a113b5c67e40d21c0b feat: export WispFilter type from root package (#2868)
  • 8537d943bb3da00974f9fa923d19ab48a3adc548 feat: migrate custom statuses and types to normalized tables (#2961)
  • 73409d51d4877cb12a0553b3a38400ab683a02f3 feat: move hook firing into storage layer via decorator (#2891)
  • dc39fdc128af83d8b9fe48a0cc4f0a4176d22a50 feat: support batch dep list for multiple issue IDs (#2875)
  • bf4025be04ff245e6f67cb8b5d5ce9be1e5d28e5 feat: support comma-separated status values in bd list --status (GH#2846) (#2929) Bug Fixes
  • d56bf01d68accc99f150b6bda33dac3b51e9f491 fix(ado): apply --types/--states/--no-create filters to push operations (#2944)
  • 9e34b07a4b9553cb7aaf65846d4d201ec0882aaf fix(ado): create work items in initial state then transition to target
  • 20b39b3616242adc8b03a885a299114954940c93 fix(deps): migrate from lipgloss v1 to charm.land/lipgloss/v2
  • dc398f5acc770c7a7875778550ac76799ac23246 fix(deps): update github.com/yuin/goldmark to v1.8.2
  • 30cb4a51e9860a447c081ee5fb4493fc52ab7526 fix(deps): update module github.com/cenkalti/backoff/v4 to v5 (#2857)
  • 933253ec42e6999dd86d72a8426cc2aff90fdb14 fix(dolt): add recovery guidance for diverged history errors (#2941)
  • ead8d09a82059b80cd803bc3165b81e9128445dd fix(gitlab): resolve hardcoded work item type ID and O(n) milestone scan
  • a44d4f9d583c2a3da90fb37e531699e1b4cae4e2 fix(init): replace 'bd onboard' references with 'bd prime' in AGENTS.md (#2902)
  • 41001f7a07d73998095c59e08cbce1cda3a35239 fix(install): redirect log functions to stderr to fix WSL platform detection
  • 5e751f814a5757154729d8fd8c7bfce3c2a1b382 fix(lint): suppress gosec G122 false positive in noms LOCK cleanup
  • 999f87593c87d835a35e3d2003ac6049eccfed64 fix(test): remove tautological TestRoleFlagValidation
  • 59b49c45f0c3438f1eef09689d3b18795175add1 fix: add missing //go:build cgo tags to embedded test files and cmd
  • 87252269a5e3d4f75e0550bcc7e6881887319751 fix: add missing created_at index on wisp_events (GH#2760) (#2877)
  • 1f4863b85b114c6cad1371db3729cb776d76a8fa fix: add whitespace trimming to env var parsing in IsAutoStartDisabled (#2955)
  • 2cd88e9426218b16e62941dd6a7c6f0ff4dee15d fix: address PR review feedback
  • 63c7a2601df16194aadc314ac7318d4949c83d0b fix: adopt existing project_id when init --database targets shared server (#2925)
  • 685cb841b974adede1236a12c9e89d2fd25e8334 fix: bd bootstrap detects remote data in fresh clones (GH#2792)
  • bbc8128230d204e1ce4a4b93b9ed044da6969da6 fix: bump currentSchemaVersion to 11 for custom_statuses/custom_types tables
  • dbdc9555b8e8ac7e3ae38ae485806a4f7fbd4bac fix: clean stale noms LOCK files after bootstrap clone (bd-cmo)
  • dfa54aad60ff4275f47c4ac76106bcdfb762bda2 fix: configure link checker root dir for docusaurus deploy
  • a2fc789faf78f9672c07fc2383c6fd2308692d6a fix: make --yes/-y the primary flag in bd bootstrap, --non-interactive as alias
  • 223895b89fcc93711512d0944732473dc24862c7 fix: make bd setup claude project-local by default and auto-setup in bd init (#2935) (#2972)
  • 0a1be381ca1eec5aaec9da7f531dd286fb7063f5 fix: pass parent env vars to dolt-sql-server child process
  • 4e4d958baf3dae3e0d2c327c2f20451a83e47ff0 fix: prefer bootstrap for missing database recovery (#2940)
  • 2a71d7fc4120b5d175f28cb7d9359e5ef97009f3 fix: preserve spaces in embedded Dolt paths
  • 543e1943b61b3beae7b143089c6ffcdf839d26c6 fix: prevent concurrent embedded Dolt panic with exclusive flock (#2571)
  • 33cab03193efa80ecd40f9f86cc9e3485a7bd5df fix: recognize ado:NNNNN shorthand in IsExternalRef and ExtractIdentifier (#2966)
  • 37382b0dbd89255adb9cf434804eccc8da59697e fix: remove bogus //nolint:gosec G122 directive (rule does not exist)
  • 870cb83e377e9fd0cec492ad5b7b33f2a51c8027 fix: remove dead rig routing code and unused variable after rebase
  • ba46bd5f3b76bdb96335282dbde60a3d7ba9aecf fix: repair nightly test failures for TestInitCancel_E2E and dolt autostart (#2969)
  • ae77bd43d9de2f0d3b801c2f022de8e3399bef89 fix: replace fragile string matching with typed APIError for HTTP status checks
  • 163c27bc68fb9d3eb58d9db9bde9cb8bd2e07f20 fix: set ADO Severity field for Bug work items during sync
  • 29bef78283de694f05c2859f968c888594335433 fix: show blocked icon for dependency-blocked issues in bd list (#2858) (#2878)
  • 265de3c47e6cbbc09743c08c7a63ee40e47ee614 fix: skip E2E test that requires Dolt server in embedded mode (#2888)
  • a097723f2893f8a1ba508d3afcebb6905de59d1c fix: suppress auto-backup address conflict warning (#2927)
  • baa9d02457ea0c2eb2046078839c9ba0be06153b fix: treat --shared-server as server mode for DoltMode (#2947)
  • 9d9d0e53c2330bd081bef350883f56c2557eb78b fix: unwrap HookFiringStore decorator before optional interface type assertions (#2937)
  • c1744167af9c704fc7b3d601830bad3c15a1650d fix: update goreleaser owner to gastownhall (repo moved from steveyegge)
  • 36e063d8b4b17a5eb91f0e470416a3c9e3b1bf09 fix: update workflow gates from steveyegge/beads to gastownhall/beads (#2936)
  • 299b5f620fcec280cc26358cc81318c3546c7d15 fix: use ResolveCustomTypesInTx in create path to honor YAML custom types (GH#2793) (#2930)
  • 8cd24769fca28a50c58534ea4bda9652f4a22aa3 fix: use proper RFC3339 timezone in WIQL date formatting (bd-wz8)
  • 9f3b813572030924f52fd3ebe1f407b0b9c61c2b fix: use strconv.ParseBool for env var parsing in IsAutoStartDisabled (#2956)
  • ca67253d7b577f67cbb08408f45da53dfa5c1058 fix: validate graph plan node types against custom types (#2874) Others
  • 15f96967ef07e9d328a7ac8ad1eb86a7b1bb8905 /cmd/bd/doctor: formatting
  • d326a27b4b3d40766ae0b3ceb74c6edddeac6adb /: enable embedded by default on mac (#2971)
  • 44c764e5a30d1aa75cf6fb37e76ba4ac0ffe632f /{cmd,docs,internal}: more cleanup
  • f1bf098d079b9ec64914f037d5be07a45022b2f2 /{cmd,docs,internal}: remove file removal that can cause data corruption
  • 4191643672798884931dc4ff910e7a45db88bd60 Add --explain flag to bd ready for dependency-aware reasoning
  • 5d524cf7e9170c15858b0a6ebb72abee19f70ec6 Add Integration Charter: define scope boundary for tracker integrations
  • 6863ca7be8e063a09b6895d8bf2e58ffff1b4dbf Add bd rules audit and bd rules compact commands (#2810)
  • bbd6c41a9cc2aa5d8d0f6ea907a44dd7b1800d1a Add claude-workspace-snapshot to Claude Code Orchestration
  • 7e4da9ab20def535a9e89ffdca6c73cdcdea90bf Add credentials file support for Dolt server passwords (#2854)
  • 2efa094bc5e1cacc2f0319f0b082bcd3be9beefc Add integration test coverage for partial failures, warnings, and self-deps
  • c5e033f93e9cbc8df6f16ac873b6ee1ec7efe523 Add pagination guards to Linear and context checks to Jira client
  • 9d7882c049b79843fe82a194b2fac3d2c1385654 Add release stability gate for upgrade safety (GH#2951) (#2963)
  • 00b78da7498e6a817d4ed40fbc76ccfdb4c4f441 Add retry logic to Jira client and jitter to all tracker HTTP clients
  • 047e506859e98fd683ebde08e7e5ae2619bb7ff4 Enforce .beads/ directory permissions at runtime
  • 0383ad7e9d2b5e2b38ec2de0aaaf7166636c6d76 Enforce graph integrity: extend cycle detection and add bd graph check
  • ac4ee4a3748b97cce454c6d4b2d6863aa6e59940 Expand SECURITY.md with tracker integration trust model
  • 5708a36c456683e5f7c8d994f0449136636b3f4d Fix ADO Init tests leaking environment variables
  • ca1ae15d025e2d4b6c63bcaf007dc02253985ff0 Fix init leaving beads.role unset in edge cases (GH#2950) (#2964)
  • 5588033438aa6fed3b557be94edfb9b4d0665abf Improve compaction dry-run and analyze output with per-issue details
  • 917c5f6f40c1ccc895c6b4d7c81246c72edfcd77 Improve quickstart docs with Why Beads section and --explain examples
  • 733b8fab894404cf8d2991466fbbb770cfb797e4 Sanitize external tracker content for terminal display and add response size limits
  • 8d41e70e2d2ffaf5e5c686be5a32f0235b776963 Surface sync engine warnings in SyncResult and fix silent failure paths
  • dbcc2db0a92bc9ff99d66e5b728e8222c06234c0 [codex] Fix installer ICU/CGO fallback handling (#2965)
  • d15b4487e2c4f38d14bd522b16f7bdfa2fea1e36 chore(deps): bump charm.land/lipgloss/v2 from 2.0.1 to 2.0.2 (#2919)
  • d02f1f92e0a74bc157f034f722e6cddf3b58808f chore(deps): bump fastmcp from 3.1.1 to 3.2.0 in /integrations/beads-mcp (#2918)
  • 72170267e00a96ec888f68a3279ddf0173b7adc7 ci: fix macOS smoke test temp dir with dots in name
  • edb6f58d81c8d342b51ed48fb3e0f19341d53b5c ci: retrigger after flaky Dolt lock contention in TestEmbeddedInit
  • ad53f30680f3780b331fd7f8c622d1fee357c302 cmd/bd: honor explicit repo selection for no-db commands (#2844)
  • 73f786ffb8d8e8211a49fe7f343886c4dee124a4 github,ado: fix Retry-After jitter in retry loops
  • 82c28903b4cc07c019e10783ad1f8366fdcfea1b jira: add MaxPages pagination guard and fix Retry-After jitter
  • 860ef5969b3de1b5a53486c897128d6775db4c5b lint: suppress gosec G404 for retry jitter (math/rand is fine for backoff)
  • db5b05a72f1a2dd85c12844456828b54476ca470 release: beads v1.0.0
  • 11d366cf5df2b414d52a6990c387aec07cb6098b tests: add coverage for explain logic, cycle detection, and engine warnings
  • 4fc7410c8532f961235fdd29d1a51e43aa55a48f tests: add integration tests for config set-many mixed key routing and validation

Installer type: zip

Architecture Scope Download SHA256
x64 Download 8B856CDBE7F313A411EC2AD6132BD372B43BA2C1080645F5CD2B455554854C50
arm64 Download 19547979225453758912B8E0282C6F9470C3675D1AFC403373493D9CA7B8916F

Details

Homepage
https://github.com/gastownhall/beads
License
MIT
Publisher
Steve Yegge
Support
https://github.com/gastownhall/beads/issues
Copyright
Copyright (c) 2026 Beads Contributors

Tags

agentagenticaichatbotcodecodinglarge-language-modelllmprogramming

Older versions (8)

0.63.3
Architecture Scope Download SHA256
x64 Download 88E020BBEE8F3076FC4D0D5353CABFDF66E2119B85575E3D201B07CF3E071F91
arm64 Download F3DCB4AF7E58BD04F0CFFF3CC54E82C0C57B5FB8B087B6C5AF3ED3428F2BE628
0.62.0
Architecture Scope Download SHA256
x64 Download 689943F325ADAB8F2BCCE2088783AC9CCFF9236B681548750A4802E13F1D4FE1
arm64 Download CEAABF2140A53D7D5FFE9FB43734D73D632D94DD12B09EF49EA7C455C8B2A3A6
0.61.0
Architecture Scope Download SHA256
x64 Download 99F5DD7F2F6AF84663CF8A1548F86009BA2C55C27F1CB2F6C949181F17102FE1
arm64 Download 55C77AF1870D8125254497840622BAC211B66F728DB4DD29574059D75F1043F8
0.60.0
Architecture Scope Download SHA256
x64 Download 8E13F5C412EF1949630004DF5F9010BF86FBF1F1716E2B9444126A474C252779
arm64 Download D6A7ACF6383843F63E040E05D68944DBFAFE96FC964618D5BC23526E486B9DDB
0.59.0
Architecture Scope Download SHA256
x64 Download 8535BF4EC0B5E86EDA4AC46C98148AC4F77606D2F8A769D97378DAE081DC92F4
arm64 Download A978AF2C0414F80BC76D147D4D5C3A79F29717F0247EFAF8F4D1D4B7C9205F10
0.58.0
Architecture Scope Download SHA256
x64 Download FA3359489A83518630A6FEAD14FC863699102AD15F2F31CF301C5B26D1DAE858
arm64 Download E5BB6EAE48381664BF28618049350603EC99DE45960FAB77B30E77C23899F35C
0.57.0
Architecture Scope Download SHA256
x64 Download 84B525116123F28ACA71591DB2014BB9037EE745387633D1EAFAAE6702D24ABE
arm64 Download 7725DC53E0F2ACB529D00ABB992938207C193374D9C604EBE64E3CB4CEF1EDB9
0.56.1
Architecture Scope Download SHA256
x64 Download 35D443DEB0EF5CADF91AF48F52C2A62E3B5BB81F35B3A06B98567F381CC6F8C7
arm64 Download 22837D7DAEFE184CED51CE95B234303CC695014DB4927495644D190CA4F84CC3