Skip to content

Access via Cmd+, (Mac) or Ctrl+, (Windows/Linux), search "Beans".

Core Settings ​

SettingTypeDefaultDescription
beans.cliPathstring"beans"Path to Beans CLI executable
beans.workspaceRootstring""Override workspace root (advanced)
beans.enableOnlyIfInitializedbooleanfalseOnly activate if .beans.yml exists
beans.autoInit.enabledbooleantrueShow initialization prompt for uninitialized workspaces
beans.hideClosedInQuickPickbooleantrueHide completed/scrapped beans from quick picks

AI Settings ​

SettingTypeDefaultDescription
beans.ai.enabledbooleantrueMaster switch for AI features (MCP and chat)
beans.mcp.enabledbooleantrueEnable MCP server definition provider
beans.mcp.portnumber39173Port metadata propagated to MCP process
beans.mcp.showStartupNotificationbooleantrueShow notification when MCP server starts

UI Settings ​

SettingTypeDefaultDescription
beans.view.displayModeenum"separate-panes"Sidebar layout: separate panes by status
beans.view.showCountsbooleantrueShow item counts in panel headers
beans.defaultSortModeenum"status-priority-type-title"Default sort mode for trees
beans.fileWatcher.debounceMsnumber20000File watcher debounce interval in ms (1000-120000)
beans.logging.levelenum"info"Extension log verbosity
beans.logging.diagnostics.enabledbooleanfalseVerbose diagnostics including GraphQL queries

Sort Modes ​

  • status-priority-type-title (default): Grouped by status with priority
  • priority-status-type-title: Highest priority first
  • updated: Most recently updated first
  • created: Newest beans first
  • id: Alphabetical by bean code