beads
Beads - A memory upgrade for your coding agent
Master running all Beads tests with `make test`. This guide covers test suite execution, flaky test skipping, and environment variable configurations for timeouts and coverage.
How to Access Beads Storage and Issue Operations Using the Go APIAccess Beads storage and issue operations programmatically with the Go API. Learn to use methods like CreateIssue, AddDependency, and RunInTransaction for CRUD and atomic transactions.
How to List Tasks That Are Ready to Be Worked on in BeadsList ready tasks in Beads with the bd ready command or store.GetReadyWork() Go API. Discover issues without active blockers for immediate development.
How to Create a New Task with a Specific Priority Using the Beads CLIEasily create a new task with a specific priority using the Beads CLI. Learn how to use the bd create command with the -p flag to set priority levels from 0 to 4.
Beads Git Integration: How It Uses Git as Primary StorageDiscover how Beads Git integration uses Git as primary storage. Learn about its work-tree aware helper for O(1) path lookups and seamless operation.
Complete Guide to Beads Environment Variables: Configuration Reference for the bd CLIMaster Beads environment variables to configure UI rendering, Dolt connections, tests, telemetry, and integrations. Explore the comprehensive `bd` CLI configuration reference.
How to Initialize Beads in Contributor Mode for Forked RepositoriesInitialize Beads in contributor mode for forked repos using bd init --contributor. Keep upstream PRs clean and manage personal issues privately.
What Is Beads Stealth Mode and When to Use It: A Complete GuideDiscover Beads stealth mode, a flush-only configuration perfect for CI/CD pipelines and automation. Learn when to use this powerful feature to suppress Git operations while generating workflow context.
How to Initialize Beads in Standard Mode: Interactive Setup GuideInitialize Beads in standard mode using the interactive setup wizard. Run "bd init" in your Git repo root to create a .beads directory, embed a Dolt database, and configure your project role.
How the Beads Messaging System with Threading Support WorksDiscover how the Beads messaging system with threading support efficiently handles conversations by storing messages as ephemeral issues and threading replies via dependency edges.
What Is Semantic Compaction and Memory Decay in Beads?Learn about semantic compaction and memory decay in Beads. Discover how Beads summarizes closed issues to reduce database size and LLM context, while agents intentionally forget details.
How the Priority System Works in Beads: P0-P4 Implementation ExplainedUnderstand the Beads priority system P0-P4 with clear explanations. Learn how to implement this validated, color-coded system for effective task management.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →