Beads - VS Code Extension
VS Code extension for managing Beads issues. Communicates with the Beads daemon via bd CLI.
Features
- Issues Panel: Sortable, filterable table with search
- Details Panel: View/edit individual issues with markdown rendering
- Multi-Project: Auto-detects
.beads directories, switch between projects
- Daemon Management: Auto-start option, status monitoring
Development
See docs/development.md for build commands, architecture, and beads setup.
Requirements
- VS Code 1.85.0+
- Beads CLI (
bd) in PATH
- Initialized project (
bd init)
Installation
Install from the VS Code Marketplace or search "Beads" in VS Code Extensions.
Usage
- Initialize:
bd init
- Start daemon:
bd daemon start
- Click Beads icon in Activity Bar
Issues Panel
- Click column headers to sort
- Search filters by title/description/ID
- Filter by status, priority, type via filter bar
- Show/hide columns via ⋮ menu
- Click row to view details
Details Panel
- View/edit title, description, status, priority, type, labels
- Markdown rendering in description and notes fields
- Manage dependencies
- Click Edit to modify, Save to commit changes
Commands
| Command |
Description |
Beads: Switch Project |
Select active project |
Beads: Open Issues Panel |
Open the issues panel |
Beads: Open Issue Details |
Open the details panel |
Beads: Refresh |
Refresh all views |
Beads: Create New Issue |
Create issue via quick input |
Beads: Start Daemon |
Start daemon for active project |
Beads: Stop Daemon |
Stop daemon |
Settings
| Setting |
Default |
Description |
beads.pathToBd |
"bd" |
Path to bd CLI |
beads.autoStartDaemon |
true |
Auto-start daemon on project switch |
beads.refreshInterval |
30000 |
Auto-refresh interval in ms (0 = disable) |
beads.renderMarkdown |
true |
Render markdown in text fields |
Troubleshooting
"No Beads projects found" - Run bd init in project root
"Daemon not running" - Click "Start Daemon" or run bd daemon start
Commands fail - Check "Beads" output channel, verify bd in PATH
Credits
Built with 💜 using Claude Code
Icon inspired by Beads icons created by imaginationlol - Flaticon
License
Apache License 2.0
| |
