Changelog¶

All notable changes to Cub are documented in this file. The format is based on Keep a Changelog.

View All Releases Full Changelog

Versioning Scheme¶

Recent Releases¶

v0.26.x - Captures & Releases¶

Highlights¶

• Consolidated PR management - cub pr and cub merge commands in Python
• GitHub issue integration - Work through GitHub issues in cub run
• Streaming output fixes - Real-time display now flushes properly
• CLI help reorganization - Commands grouped by function

Key Changes¶

v0.25.x - Sandbox Mode¶

Highlights¶

• SandboxProvider Protocol - Pluggable provider interface
• DockerProvider - Full filesystem and network isolation
• --sandbox flag - Run tasks in Docker isolation
• cub sandbox subcommands - Manage sandbox lifecycle

Key Features¶

# Run in sandbox
cub run --sandbox

# Review changes before applying
cub sandbox diff
cub sandbox apply

v0.24.x - Git Worktrees¶

Highlights¶

• WorktreeManager - Core worktree management
• --worktree flag - Run in isolated worktree
• --parallel N flag - Concurrent task execution
• cub worktree subcommands - CLI for worktree management

Key Features¶

# Run in worktree
cub run --worktree

# Parallel execution
cub run --parallel 4

v0.23.x - Live Dashboard & Hybrid CLI¶

Highlights¶

• Rich Dashboard - Task progress visualization
• Tmux Integration - --monitor flag for split pane
• Hybrid CLI - Python + Bash delegation
• cub audit - Codebase health checking

Key Features¶

# Live monitoring
cub run --monitor

# Or standalone dashboard
cub monitor

v0.21.x - Python Core Migration¶

Highlights¶

• Python 3.10+ - Modern Python foundation
• Pydantic v2 - Type-safe models
• 10-50x faster - No jq subprocess overhead
• Full compatibility - Same workflow, faster execution

See Upgrading Guide for migration details.

v0.20.x - Guardrails System¶

Highlights¶

• .cub/guardrails.md - Store lessons learned
• Auto-learn from failures - Extract lessons automatically
• cub guardrails - Show, add, learn, curate commands
• Task prompt integration - Guardrails included in prompts

v0.19.x - Git Workflow Integration¶

Highlights¶

• cub branch - Create and bind branches to epics
• cub checkpoints - Review gates that block tasks
• cub pr - Auto-generate PRs from epic work

v0.16.x - v0.18.x - Planning & Interview¶

Highlights¶

• Interview Mode (v0.16) - Deep questioning to refine task specs
• PRD Import (v0.17) - Import from Markdown, JSON, GitHub, PDF
• Project Init (v0.18) - Interactive setup with templates
• Prep Pipeline (v0.18.1) - Triage -> Architect -> Plan -> Bootstrap

Full Version History¶

Upgrade Notes¶

v0.20.x to v0.21.x (Bash to Python)¶

Key changes:

• Python 3.10+ required
• Virtual environment required
• jq no longer needed
• 10-50x performance improvement

v0.12.x to v0.13.x (Curb to Cub)¶

• Update all curb references to cub
• Rename config: .curb.json -> .cub.json
• Update env vars: CURB_* -> CUB_*
• Move config dir: ~/.config/curb/ -> ~/.config/cub/

v0.8.x to v0.9.x (Flags to Subcommands)¶

Legacy flags show deprecation warnings but still work.

Test Coverage¶

Links¶

• GitHub Releases
• Full CHANGELOG.md
• Report an Issue