Beautifully integrated Beans issue tracking for VS Code
Beans is a file-based issue tracker that lives alongside your code. This extension brings the full Beans experience into VS Code with native tree views, AI integration, and powerful workflow automation.
- 🌴 Tree Views: Organized sidebar panes for drafts, open, completed, and scrapped beans with hierarchical nesting, in-progress descendant badges, and item counts
- 📋 Details View: Rich webview panel with rendered markdown, interactive checklists, editable properties, relationship navigation, and browsing history with back navigation
- 🔍 Search & Filter: Full-text search across all fields, filter by status/type/priority/tags, five sort modes, and dedicated search results view with context menus
- 🎯 Drag & Drop: Create parent-child hierarchies visually with cycle detection and confirmation
- 🔗 Relationships: Parent-child hierarchies (milestone > epic > feature > task) and blocking/blocked-by dependency tracking
- 🤖 AI Integration: MCP tools for all operations,
@beanschat participant with 7 slash commands, auto-generated Copilot skills & instructions, and "Start Work" templates for Copilot-assisted workflows - 🌐 Remote Ready: Works seamlessly in SSH, WSL, containers, and Codespaces
- ⚡ Keyboard-First: Configurable shortcuts for all operations
- 📂 File Watching: Automatic tree refresh on filesystem changes with configurable debounce
- 🛡️ Resilient: Offline mode with caching, request deduplication, retry with exponential backoff, malformed bean detection, and structured error handling with actionable guidance
- 🧪 Extensively Tested: Comprehensive automated unit and integration test suite
- ♿ Accessible: Built following WCAG 2.2 Level AA guidelines
- 🤫 Privacy Respecting: No telemetry or data collection of any kind
- 🐶 Completely Dogfooded: The extension was used by the developer to project manage developing the extension
Beans is a modern, file-based issue tracker designed for developers who want their issues to live alongside their code. Each "bean" is a markdown file in your repository—no databases, no external services, just version-controlled files.
Why file-based?
- ✅ Version controlled with your code
- ✅ Readable in any text editor
- ✅ Works offline
- ✅ No vendor lock-in
- ✅ Greppable and scriptable
- ✅ Perfect for remote development
Learn more about Beans: github.com/hmans/beans
Install the beans CLI
brew install hmans/beans/beansgo install github.com/hmans/beans@latestUse the IDE's Extension sidebar to search for beans or execute the following command:
code --install-extension selfagency.beans-vscode- Open your project in VS Code
- Press
Cmd+Shift+P/Ctrl+Shift+P - Run: "Beans: Initialize Beans in Workspace"
cd <project-folder>
beans init- Click the
+icon in the Beans sidebar - Enter a title: "My first bean"
- Select type: "task"
- Optionally add a description
- Bean created! 🎉
- Sidebar: Click any bean in the Active tree
- Details Panel: Opens with bean markdown content
- Edit: Click pencil icon to edit bean file directly
This extension fully supports VS Code Remote Development (SSH, WSL, containers, Codespaces).
Critical requirement: The Beans CLI must be installed on the remote machine, not your local machine.
Full user and developer documentation can be found at beans.self.agency.
If you find this extension useful, please leave a review on the VS Code Marketplace or Open VSX. Reviews help other developers discover the extension.
- Hendrik Mans: Creator of Beans
This extension is built with accessibility in mind following WCAG 2.2 Level AA guidelines, but issues may still exist. Please manually test keyboard navigation and screen-reader workflows. Consider auditing with Accessibility Insights.
Feedback and accessibility improvement suggestions are welcome—please file an issue!