Changelog - twamp22/BumbaClaude GitHub Wiki

Changelog

v0.1.0 (Released April 2026)

This is the initial release of BumbaClaude. It introduces the core features needed to manage multi-agent Claude Code workflows.

Dashboard

  • Dashboard home page showing all active teams with status indicators
  • Team cards with quick stats (agents, tasks, events)
  • Recent activity feed (last 20 events across all teams)
  • Color-coded status system (green=active, amber=idle, red=error, gray=completed)
  • Dark mode design with industrial control room aesthetic

Team Management

  • Team creation wizard with four steps:
    • Project setup (working directory, team name, execution mode)
    • Agent roles (name, description, model tier, system prompt)
    • Governance rules (file creation, shell commands, git push, max turns)
    • Review and launch
  • Quick templates for common team configurations:
    • Full-stack feature (4 agents)
    • Code review (3 agents)
    • Research sprint (2 agents)
  • Team list with status and control options

Live Monitoring

  • Live monitor page for each team showing:
    • Agent cards with status and real-time terminal output
    • Last 50 lines of agent terminal capture
    • Status indicators with color coding
    • "Send message" input to communicate with agents
    • Task board showing all tasks and their assignments
    • Team controls (pause, resume, add agent, end team, kill team)

Task Management

  • Task list with status, assigned agent, and description
  • Task status indicators (pending, claimed, in-progress, review, completed, blocked)
  • Manual task status updates
  • Task hierarchy support (parent/child task relationships)
  • Agent-created vs. user-created task tracking
  • Timestamps for task creation and completion

Audit Log

  • Complete event history for each team
  • Event types logged:
    • Agent spawned / ended
    • Task created / claimed / in-progress / completed / blocked
    • Message sent (agent-to-user)
    • File created / modified
    • Command executed
    • Governance limit reached
    • Error occurred
    • Team ended
  • Filterable by agent, event type, and time range
  • JSON event data for detailed inspection
  • Persistent storage in SQLite

Workflow Templates

  • Save team configurations as reusable templates
  • Template library page with all saved templates
  • "Launch from template" to pre-fill team creation wizard
  • Export templates as JSON files
  • Import templates from JSON
  • Share templates with teammates

Token and Tool Usage Tracking

  • Token usage per agent response:
    • Input tokens
    • Output tokens
    • Cache read tokens (prompt caching)
    • Cache creation tokens (prompt caching)
    • Estimated cost in USD
    • Model used
    • Response duration
  • Tool usage tracking:
    • Tool invocation logging
    • MCP tool detection and tracking
    • Tool invocation count and frequency
    • Input summary (first 200 chars)
  • Team-wide and per-agent token/tool dashboards
  • Usage charts and trends

MCP Server Discovery

  • Automatic discovery of available MCP servers
  • MCP server status tracking
  • Server detection from multiple sources:
    • Agent output streams
    • Project configuration
    • Global configuration
  • Manual server registration option

Scheduled Recurring Tasks

  • Create recurring tasks that run on a schedule
  • Schedule types:
    • Interval (milliseconds between runs)
    • Cron expressions (for complex schedules)
  • Task scheduling per agent
  • Schedule history (last run time, run count)
  • Enable/disable schedules without deleting

Context File Discovery

  • Auto-discovery of context files in project directory
  • Searchable file list with previews
  • Identify context available to agents
  • Specify additional context paths in governance settings

Standalone Electron Desktop App

  • Native Windows application using Electron 41+
  • System tray icon with status indicator:
    • Green: All agents healthy
    • Amber: Agents idle/waiting
    • Red: Agent error
    • Gray: No active teams
  • Tray menu with:
    • Show/Hide window
    • Active team count
    • Quit option
  • Native Windows toast notifications for:
    • Task completion
    • Agent errors
    • Waiting for human input
    • Governance limits reached
  • Close-to-tray behavior (agents continue running in background)
  • Window state persistence (size and position saved)
  • Global hotkey (Ctrl+Shift+B by default) to show/hide window
  • Auto-update via electron-updater (GitHub Releases)
  • NSIS Windows installer with Start Menu shortcuts
  • Portable .zip distribution option

Backend Infrastructure

  • SQLite database (better-sqlite3) with comprehensive schema
  • WebSocket server for real-time dashboard updates
  • File watcher (chokidar) monitoring ~/.claude/ for changes
  • tmux integration for agent spawning and control
  • RESTful API for all operations
  • Error handling with meaningful messages
  • Transaction support for multi-step operations

Data Persistence

  • SQLite database auto-created on first run at ./data/dashboard.db
  • Tables for teams, agents, tasks, governance rules, audit events, templates
  • Additional tables for token usage, tool usage, schedules, MCP servers
  • Database indexes for common query patterns
  • Automatic schema initialization

Code Quality

  • TypeScript strict mode throughout
  • Server components by default (App Router)
  • Client components only for interactive UI
  • No ORM - raw SQL with parameterized queries
  • Comprehensive error handling
  • Type-safe API contracts
  • Linting with ESLint

Documentation

  • Comprehensive README with quick start guide
  • MVP specification document
  • CLAUDE.md for development workflow
  • CONTRIBUTING.md for contributors
  • Architecture documentation
  • User guide for desktop app features
  • Installation and troubleshooting guide

Known Limitations (by design for v0.1)

  • Execution mode limited to tmux (Agent SDK integration planned for v0.2)
  • Task board is list view, not kanban (kanban planned for v0.3)
  • No per-agent fine-grained permissions (planned for v0.2)
  • No workflow replay feature (planned for v0.3)
  • Windows only (macOS/Linux planned for v0.4)
  • No plugin system (planned for v0.4)

Technical Details

  • Next.js 16+ with App Router and TypeScript
  • Tailwind CSS for styling
  • better-sqlite3 for local database
  • ws library for WebSocket
  • chokidar for file watching
  • electron and electron-builder for desktop packaging
  • child_process for tmux integration
  • pnpm for package management

Version History

  • v0.1.0 -- Initial release with core dashboard, team management, live monitoring, and desktop app
  • v0.2.0 -- Planned: Agent SDK integration, per-agent permissions, Kanban board, template registry
  • v0.3.0 -- Planned: Workflow replay, webhook notifications, context graph visualization
  • v0.4.0 -- Planned: Plugin system, GitHub Actions, cross-platform builds (macOS/Linux)