Skip to content

Beans

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.

Key Features ​

  • 🌴 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, @beans chat 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

About Beans ​

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