# Beads

## Docs

- [Introduction](https://mintlify.wiki/steveyegge/beads/introduction.md): Distributed, git-backed issue tracking for AI agents - giving coding agents persistent memory and dependency-aware task management
- [Quickstart](https://mintlify.wiki/steveyegge/beads/quickstart.md): Get up and running with Beads in 2 minutes - create your first issues, add dependencies, and find ready work
- [Installation](https://mintlify.wiki/steveyegge/beads/installation.md): Install Beads on macOS, Linux, Windows, or FreeBSD via Homebrew, npm, Go, or shell script
- [Architecture](https://mintlify.wiki/steveyegge/beads/concepts/architecture.md): Understanding Beads' two-layer design and how components fit together
- [Dependencies](https://mintlify.wiki/steveyegge/beads/concepts/dependencies.md): Ordering work and managing relationships between issues
- [Workflows](https://mintlify.wiki/steveyegge/beads/concepts/workflows.md): Contributor mode, stealth mode, and maintainer mode for different collaboration scenarios
- [Memory](https://mintlify.wiki/steveyegge/beads/concepts/memory.md): Persistent agent knowledge that survives sessions and account rotations
- [Agent workflow](https://mintlify.wiki/steveyegge/beads/guides/agent-workflow.md): How AI agents use Beads for task management and long-horizon work
- [Contributor mode](https://mintlify.wiki/steveyegge/beads/guides/contributor-mode.md): Route planning issues to a separate repo when working on forked projects
- [Stealth mode](https://mintlify.wiki/steveyegge/beads/guides/stealth-mode.md): Use Beads locally without committing files to the main repository
- [Sync and backup](https://mintlify.wiki/steveyegge/beads/guides/sync-and-backup.md): Dolt push/pull workflows for team collaboration and backup strategies
- [Molecules](https://mintlify.wiki/steveyegge/beads/guides/molecules.md): Advanced multi-issue workflow management with mol commands
- [Claude Code Integration](https://mintlify.wiki/steveyegge/beads/integrations/claude.md): Integrate Beads with Claude Code using CLI hooks for efficient context injection
- [GitHub Copilot Integration](https://mintlify.wiki/steveyegge/beads/integrations/copilot.md): Use Beads with GitHub Copilot through MCP for natural language issue tracking
- [Aider Integration](https://mintlify.wiki/steveyegge/beads/integrations/aider.md): Integrate Beads with Aider for AI-assisted coding with human-in-the-loop issue tracking
- [MCP Server](https://mintlify.wiki/steveyegge/beads/integrations/mcp.md): Model Context Protocol server for AI agents to access Beads through native tool calls
- [Commands Overview](https://mintlify.wiki/steveyegge/beads/cli/overview.md): Core CLI commands for issue management in Beads
- [bd create](https://mintlify.wiki/steveyegge/beads/cli/create.md): Create new issues with rich metadata and dependencies
- [bd update](https://mintlify.wiki/steveyegge/beads/cli/update.md): Update issue fields and claim work atomically
- [bd ready](https://mintlify.wiki/steveyegge/beads/cli/ready.md): Find unblocked work ready to be started
- [bd dep](https://mintlify.wiki/steveyegge/beads/cli/dep.md): Manage dependencies between issues
- [bd show](https://mintlify.wiki/steveyegge/beads/cli/show.md): View detailed issue information with full audit trail
- [bd list](https://mintlify.wiki/steveyegge/beads/cli/list.md): Search and filter issues with powerful queries
- [bd close](https://mintlify.wiki/steveyegge/beads/cli/close.md): Close completed issues with reason
- [bd compact](https://mintlify.wiki/steveyegge/beads/cli/compact.md): Semantic memory decay to summarize old issues
- [bd graph](https://mintlify.wiki/steveyegge/beads/cli/graph.md): Visualize issue dependency graphs
- [bd dolt](https://mintlify.wiki/steveyegge/beads/cli/dolt.md): Direct Dolt database operations
- [bd doctor](https://mintlify.wiki/steveyegge/beads/cli/doctor.md): Check and fix beads installation health
- [bd backup](https://mintlify.wiki/steveyegge/beads/cli/backup.md): Back up and restore your beads database
- [bd remember](https://mintlify.wiki/steveyegge/beads/cli/remember.md): Store persistent memories that survive sessions and account rotations
- [bd memories](https://mintlify.wiki/steveyegge/beads/cli/memories.md): List or search persistent memories across your project
- [bd recall](https://mintlify.wiki/steveyegge/beads/cli/recall.md): Retrieve the full content of a specific memory by key
- [bd forget](https://mintlify.wiki/steveyegge/beads/cli/forget.md): Remove a persistent memory by its key
- [bd mol seed](https://mintlify.wiki/steveyegge/beads/cli/mol-seed.md): Verify formula accessibility or seed patrol formulas
- [bd mol bond](https://mintlify.wiki/steveyegge/beads/cli/mol-bond.md): Bond two formulas, protos, or molecules together
- [bd mol current](https://mintlify.wiki/steveyegge/beads/cli/mol-current.md): Show current position in molecule workflow
- [bd mol distill](https://mintlify.wiki/steveyegge/beads/cli/mol-distill.md): Extract a reusable formula from an existing epic
- [Frequently Asked Questions](https://mintlify.wiki/steveyegge/beads/resources/faq.md): Common questions about Beads and how to use it effectively
- [Troubleshooting](https://mintlify.wiki/steveyegge/beads/resources/troubleshooting.md): Common issues and solutions for Beads users
- [Community Tools](https://mintlify.wiki/steveyegge/beads/resources/community-tools.md): UIs, extensions, and integrations built by the Beads community
- [Contributing Guide](https://mintlify.wiki/steveyegge/beads/resources/contributing.md): How to contribute to Beads development

## OpenAPI Specs

- [openapi](https://mintlify.wiki/steveyegge/beads/api-reference/openapi.json)