Skip to content

CHANGELOG.md

Latest commit

 

History

History
632 lines (520 loc) · 39.4 KB

CHANGELOG.md

File metadata and controls

632 lines (520 loc) · 39.4 KB
Raw

Changelog

All notable changes to Ripperdoc will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.6.2] - 2026-05-23

Added

  • LLM input prediction - Added LLM input prediction support

Changed

  • Compaction improvements - Deduplicated compaction summary logic and added streaming progress bars with progress cleanup
  • Tool parameter cleanup - Removed deprecated tool input fields and unified parameter naming
  • Team cleanup behavior - Clean up teams at session end and use in-memory leader team name
  • Code quality cleanup - Replaced wildcard imports with explicit imports, removed dead code, batched type hint fixes, and updated documentation

Fixed

  • Adaptive Anthropic thinking - Support adaptive Anthropic thinking behavior
  • Messaging import compatibility - Restore legacy import surface in the messaging module
  • Read tool cache behavior - Ensure Read tool dedup cache respects offset and limit
  • Root bypass mode guard - Reject bypassPermissions mode when running as root or sudo

Removed

  • Deprecated tools and features - Removed the built-in Memory tool, cron scheduling, PDF Read support, and related code paths

0.6.1 - 2026-05-19

Added

  • Task reminder nudge system - Periodic 10-turn reminder injection that lists all current tasks when TaskCreate/TaskUpdate haven't been used recently, helping prevent stale tasks from lingering in the task list
  • Agent tool infinite timeout - Removed 300s timeout for the Agent tool (added to _INFINITE_TIMEOUT_TOOLS alongside AskUserQuestion), preventing premature termination of subagents like the explore agent
    • ClaimTaskResult, AgentStatus, UnassignTasksResult models for inter-agent coordination
    • claim_task, block_task, get_agent_statuses, unassign_teammate_tasks operations
    • Observer/event pattern for task change notifications
    • High water mark mechanism for numeric task ID generation
    • Verification nudge when closing 3+ tasks in TaskUpdate

Changed

  • Codebase modularization - Continued restructuring for better maintainability:
    • Split models.py into modular model_types package with migrated message type imports
    • Split permission_engine into a modular package structure
    • Refactored message type module, renaming messages import to types
    • Moved background_shell from tools to services directory, unifying service layer structure
    • Renamed Task-related tools and configurations to Agent, standardizing naming conventions
  • Cron tools consolidation - Merged CronCreate/CronDelete/CronList into a single schedule_cron module with shared cron expression helpers
  • Task lifecycle simplification - Removed "deleted" status from task lifecycle; tasks now flow through pending → in_progress → completed only; TaskList and summary views filter out completed tasks by default
  • Documentation sync - Updated README and README_CN with 10 missing slash commands, missing tools, and restructured tool categories

Fixed

  • Asyncio initialization - Ensure event loop exists before creating asyncio primitives
  • Test path correction - Update stale module path for system_prompt after refactor
  • Subagent finalization - Simplify early return guard in subagent finalization
  • Task blocker check - Fix blocker check logic in task management

Removed

  • Deprecated tools - Removed MultiEdit (merged into Edit), TaskOutput, Config, and SendUserMessage tools, along with associated imports, permission logic, preview rendering, and tests

0.6.0 - 2026-05-13

Added

  • Multi-session, mTLS, and v2 protocol for remote control bridging - Comprehensive upgrade of the remote control bridge with multi-session management, mutual TLS authentication, v2 protocol transport, trusted device support, direct connect mode, echo deduplication, flush gate, and environment-less bridge modes
  • Visual line navigation for input - Up/down arrow keys now navigate by visual line for soft-wrapped long text, while preserving original history navigation logic

Changed

  • Codebase restructuring - Major reorganization of the project structure:
    • Moved commands/ from cli/ to top-level package
    • Moved services/ from core/ to top-level package
    • Reorganized tools into individual subpackages under tools/
    • Moved message_utils.py and plan_mode.py from core/ to top-level
    • Extracted managed_settings.py and model_catalog.py into services/
    • Split utils/ into subpackages (git/, lsp/, mcp/, memory/, messaging/, telemetry/)
    • Extracted constants into constants/ subpackage
    • Standardized import paths across the codebase

0.5.3 - 2026-03-14

Fixed

  • MCP tools preservation with default preset - Preserve MCP tools when "default" tools preset is active without explicit --tools list; SDK agents using ToolsPreset no longer lose access to registered MCP tools
  • Stdin message loss - Prevent stdin message loss caused by zombie executor threads when readline timeout/retry loop left a blocking thread consuming the next message from stdin
  • Built-in tools with allowed_tools - Preserve built-in tools when using "default" preset with explicit allowed_tools; only MCP tools (mcp__*) are subject to whitelist restriction

Changed

  • Model catalog update - Updated model pricing and context window data
  • Code cleanup - Removed unused STDIO_TOOL_TIMEOUT_SEC constant

0.5.2 - 2026-03-09

Added

  • SOCKS proxy support - Added httpx[socks] dependency for SOCKS proxy support
  • Anthropic prompt caching - Unified system prompt handling with Anthropic prompt caching support
  • Enhanced export formats - Improved export formats with plan mode and MCP SDK support enhancements
  • OAuth customization - Expanded OAuth customization options for providers
  • Graceful abort support - Support for graceful abort and foreground-to-background subagent handoff

Changed

  • Tool defaults enhancement - Enhanced tool defaults with async support and expanded LSP/MCP capabilities
  • Thinking mode controls - Enhanced thinking mode controls with provider-specific configuration
  • Stdio signal handling - Improved stdio signal handling and MCP schema coercion
  • Type safety improvements - Enhanced type safety throughout the codebase
  • Message handling alignment - Refined message handling patterns for improved consistency
  • Session message handling - Cache attribute lookups in session message handling for better performance

Fixed

  • Tool-set filtering - Decoupled tool-set filtering from permission controls and wired disallowed_tools properly
  • Built-in tools preservation - Fixed built-in tools preservation when "default" tools preset is active
  • Tmux worktree support - Synchronized tmux worktree support with CLI main function
  • OpenAI tool history - Enhanced OpenAI tool history sanitization

0.5.1 - 2026-03-05

Added

  • Remote-control bridge command - New remote-control bridge command for remote work sessions with explicit ACK and session token refresh
  • Provider preset mode - Added provider preset mode for simplified model configuration
  • AI-powered prompt suggestions - Intelligent prompt suggestion feature to help users craft better queries
  • Plugin marketplace management - Enhanced plugin system with marketplace management commands and improved installation workflow
  • Environment variable overrides - Added multiple new environment variable configuration options:
    • RIPPERDOC_EXIT_AFTER_STOP_DELAY - Auto-exit after idle delay in stdio mode
    • RIPPERDOC_ENABLE_TOOL_SEARCH - Control deferred MCP tool search
    • RIPPERDOC_AUTOCOMPACT_PCT_OVERRIDE - Override auto-compaction percentage threshold
    • Storage env override diagnostics for configuration debugging
  • Centralized temp path management - New centralized utility for managing temporary paths across the application
  • Expanded LLM provider support - Added support for additional providers: volcengine seed 2.0, aliyun-coding, stepfun, and nvidia
  • Replay user messages flag - New --replay-user-messages flag for improved remote control protocol support

Changed

  • Utils modularization - Reorganized utils package into modular subpackages for better maintainability
  • Tab completion refactoring - Extracted tab completion logic into dedicated functions for better code organization
  • Auto-completion improvement - Enhanced auto-completion logic for single completion scenarios
  • Config path management - Unified configuration path management with added managed settings support

Fixed

  • Prompt handler escape bindings - Fixed escape key bindings in prompt handlers by setting eager=True
  • Terminal CPR - Fixed terminal cursor position reporting issues

Removed

  • AI prompt suggestion feature - Reverted AI-powered prompt suggestion feature due to user experience concerns

0.5.0 - 2026-03-03

Added

  • JSON-RPC 2.0 Protocol - Refactored stdio protocol to JSON-RPC 2.0 format with enhanced session management and improved message handling
  • Remote WebSocket SDK transport - Added --sdk-url option for remote WebSocket SDK transport enabling distributed agent architectures
  • Git worktree isolation for Task tool - Task tool now runs in isolated git worktrees with unified task management for safer multi-agent operations
  • Structured task notification system - New notification system with auto-response support for inter-agent communication and coordination
  • Auto-memory system - Persistent auto-memory system with permission bypass for improved context retention across sessions
  • Memory tool with aliases - New Memory tool for persistent knowledge storage with convenient tool input aliases
  • Clipboard enhancements - New /copy command for conversation export and improved tmux clipboard handling
  • Custom session agents - Added --agent and --agents options for selecting and managing custom session agents
  • CLI debugging options - New --debug and --disable-slash-commands flags for development and troubleshooting
  • Permission diff preview - Write tool permission prompts now show unified diff previews before applying changes
  • Interactive plan-mode exit - Plan mode now includes interactive exit confirmation with mode cycling support
  • Runtime permission mode cycling - Real-time permission mode switching with status display in UI
  • MCP server management subcommands - Dedicated MCP subcommands for server lifecycle management
  • OpenAI mode for models - Added openai_mode option to explicitly select API endpoint for model compatibility
  • Model profile actions - Copy and rename actions for model profiles in management TUI
  • Version output customization - New -v short option for version with customizable output format

Changed

  • CLI modularization - Refactored CLI into separate components with new agents subcommand for better maintainability
  • Code cleanup and type safety - Comprehensive code quality improvements with enhanced type annotations and safety checks
  • Tmux escape sequence handling - Improved readability and reliability of tmux escape sequences
  • CLI tips documentation - Updated CLI tips with new features and commands
  • Permission management - Enhanced permission system with better UI feedback and mode visibility
  • Model management - Improved model profile management with copy and rename capabilities

Fixed

  • Background task status repair - Added fallback logic to repair stale running states when monitor misses completion events, ensuring completion callbacks are always dispatched
  • Tool execution deadlock - Added reentrant lock to prevent deadlocks during parallel tool execution
  • AskUserQuestion timeout - Disabled timeout for AskUserQuestion tool to allow unlimited user response time
  • Model profile alignment test - Added monkeypatch for get_effective_model_profile in test suite

Changed

  • Protocol refactoring - Major stdio protocol refactoring to JSON-RPC 2.0 with improved session state management
  • Task isolation architecture - Task tool now uses git worktree isolation for safer concurrent operations

0.4.5 - 2026-02-26

Added

  • Session rename command - New /rename command for changing session title during conversation
  • Codex OAuth authentication - OAuth authentication support for Codex models with improved API handling
  • Extended OAuth providers - OAuth support for Copilot and GitLab providers
  • Unified User-Agent header - Consistent User-Agent header across all API requests for better tracking
  • Custom SDK version - Support for custom SDK version via RIPPERDOC_SDK_VERSION environment variable
  • In-process teammate state - State management for multi-agent team coordination

Changed

  • Diff rendering utilities - Extracted diff rendering into reusable utilities module
  • Task graph renderer - Simplified by removing hidden task count display

Fixed

  • Compound command parsing - Improved parsing for read-only shell checks in compound commands (e.g., cd dir && ls)

0.4.4 - 2026-02-23

Added

  • Diff preview for edit permissions - Edit and MultiEdit permission prompts now show a diff preview before applying changes
  • Adaptive onboarding palette - Onboarding UI automatically adapts to light/dark terminal backgrounds using COLORFGBG detection
  • Theme-aware diff styles - Choice UI diff styles now follow the active theme for consistent appearance
  • Restart notice for theme switching - /themes command now displays a restart notice when switching themes

Changed

  • EditResultRenderer improvement - Now formats raw unified diff lines with line numbers instead of using preformatted tags
  • Tool count update - Updated documentation to reflect 30+ built-in tools (was 26+)

0.4.3 - 2026-02-15

Added

  • Conversation export command - New /export command to export conversation history to clipboard or file
  • MCP server management TUI - Interactive Textual-based UI for managing MCP servers with /mcp command
  • PyInstaller build system - New build system with PyInstaller support including hooks and UPX compression
  • PyInstaller spec files - Added spec files for both onefile and onedir build modes
  • Non-blocking MCP connections - MCP server connections now use circuit breaker pattern for better resilience
  • Session usage tracking rebuild - Rebuild session usage tracking with configurable replay message limit
  • Enhanced clear command - /clear now resets session state completely with new /reset alias

Changed

  • Model catalog performance - Migrated model catalog from JSON to Python module for faster loading
  • Build system migration - Migrated from Nuitka to PyInstaller for better cross-platform binary support
  • Provider error handling - Standardized error handling across all providers with unified error types
  • Permissions TUI - Improved exit behavior via Escape key in permissions management TUI
  • File tool display - Removed file_path: prefix from tool argument display for cleaner output
  • Provider configurations - Updated provider configurations and cleaned up model data

Fixed

  • Windows executable naming - Handle Windows executable naming correctly in build script
  • OpenAI error handling - Enhanced error handling for httpx transport exceptions in OpenAI provider
  • Build scripts - Various improvements to PyInstaller and Nuitka build scripts

Removed

  • UPX auto-download - Removed automatic UPX download from build script for security

0.4.2 - 2026-02-10

Added

  • Hide completed tasks - Completed tasks are now hidden from UI output by default for cleaner display
  • Display completed tasks option - New opt-in option to show completed tasks when needed
  • MCP stderr log inspection - New /mcp logs command for inspecting MCP server stderr logs
  • Thinking mode configuration - Support for thinking mode configuration in model profiles
  • Enhanced model configuration - Separate max input/output tokens configuration for models

Fixed

  • Flaky async hook test - Fixed flaky async hook test by increasing wait time
  • Anthropic extended thinking signatures - Properly handle Anthropic extended thinking signatures in streaming and message replay
  • Token management - Remove redundant context_window field and simplify token management

Changed

  • MCP runtime initialization - Improved type safety and optimized MCP runtime initialization
  • Plugin uninstall confirmation - Added confirmation dialog for plugin uninstall operations
  • Documentation sync - Synced Chinese README with English version
  • CLI alias removal - Removed rd CLI alias for consistency

Refactored

  • Task ID display - Removed "id:" prefix from task ID display for cleaner output
  • Task ID separator - Changed task ID separator from hyphen to colon for better display consistency

0.4.1 - 2026-02-08

Added

  • Plugin system with marketplace support - Comprehensive plugin architecture enabling users to extend Ripperdoc with custom commands, skills, agents, hooks, and MCP/LSP servers
  • Plugin marketplace operations - Support for discovering, installing, and managing plugins from online marketplaces
  • Plugin scope management - User, project, and local scopes for flexible plugin installation and usage
  • Plugin registry system - Centralized registry for tracking installed plugins across different scopes
  • Plugin Textual TUI - Interactive terminal UI for comprehensive plugin management

Fixed

  • Context budget validation - Add ContextBudgetConfigurationError for invalid model token configurations
  • MCP server resilience - Isolate MCP server connection failures to prevent cascade errors
  • Token budget calculation - Support split input/output token budgets without double subtraction
  • Task ID display formatting - Simplify task ID display format for cleaner output

Changed

  • Plugin system enhancements - Improved marketplace operations with better error handling and feedback
  • Task rendering optimization - Streamlined task ID display format

0.4.0 - 2026-02-08

⚠️ BREAKING CHANGES - Configuration File Format Incompatible

IMPORTANT: Please backup your configuration files before upgrading!

This release includes major architectural changes that introduce incompatible changes to the configuration file format. Before upgrading to v0.4.0, please:

  1. Backup your configuration: Copy your ~/.ripperdoc/c, ~/.ripperdoc.json, and any project-specific .ripperdoc/ files
  2. Review provider settings: The provider field has been renamed to protocol
  3. Update model configurations: Model profiles now use a new structure with auto-completion from the built-in model catalog

Added

  • Task graph and team collaboration system - Complete task management with persistent task graph, dependency tracking, and multi-agent team coordination
  • Model catalog system - Comprehensive built-in model catalog with pricing, context windows, and capability metadata for 200+ models
  • Output style customization - New /output-style command with 8+ predefined output styles (concise, detailed, json, markdown, etc.)
  • Output language control - New /output-language command to control AI response language independently from UI language
  • Session-scoped working directories - Support for multiple working directories per session with /add-dir command
  • Interactive question system - New AskUserQuestion tool for single and multi-select interactive prompts
  • Custom commands management TUI - Interactive terminal UI for managing custom commands with /commands slash command
  • Skills enable/disable - New TUI and commands to enable/disable individual skills
  • Enhanced bash output - Detailed truncation metadata for command output with size and line limit information
  • SDK can_use_tool integration - Permission preview support for SDK tool usage
  • Async hook support - Hooks now support async commands and bidirectional SDK protocol callbacks
  • Hook scopes - Add hook scopes for skills and agents for more granular control
  • Agent hook type - New hook event type specifically for agent lifecycle events
  • JSON output format - New JSON output mode for programmatic consumption
  • Auto input format - Enhanced input parsing with automatic format detection
  • Custom system prompts - Support for per-query custom system prompts
  • Max turns option - Limit conversation turns with --max-turns option
  • Sidecar session index - Fast session lookup and statistics with new index file format
  • Python 3.10 asyncio compatibility - Add asyncio.timeout compatibility layer for Python 3.10

Changed

  • Provider → Protocol rename - Renamed ProviderType to ProtocolType throughout codebase for clarity
  • Core module reorganization - Major refactoring of core modules:
    • query_utils.py → message_utils.py
    • permissions.py → permission_engine.py
    • provider_catalog.py → provider_metadata.py
    • default_tools.py → tool_defaults.py
  • Model profile structure - Model profiles now auto-populate from model catalog with pricing, context windows, and capabilities
  • Bash output rendering - Simplified bash output rendering with improved test coverage
  • Query runtime helpers - Extracted query runtime helpers for better modularity
  • Message normalization - Enhanced message normalization in query loop
  • Permission decision engine - Modularized permission decision engine into separate functions
  • Dynamic subagent prompts - Subagent prompts now adapt based on available tools
  • Environment variable handling - Simplified environment variable handling across the codebase
  • Stdio handler - Split stdio handler into mixins for better separation of concerns
  • Session resume replay - Improved tool rendering in conversation replay for session resume
  • SessionStart/End hooks - Ensure hooks execute once per session with deterministic cleanup
  • Permission mode synchronization - Sync permission mode across query context, hooks, and permissions
  • Thinking spinner - Auto-refresh thinking spinner via async tick loop
  • CLI integration - Integrated stdio mode into main CLI with SDK-compatible options
  • TUI notifications - Replace inline error widgets with app notifications in TUI forms
  • Internationalization - Translated Chinese comments to English in source code
  • Public API promotion - Promoted internal utilities to public API for extensibility
  • Type annotation coverage - Improved type annotation coverage and mypy compatibility

Fixed

  • Model profile pricing - Use model profile pricing and fix num_turns calculation
  • Permission override - Ensure deny/block decisions override allow in hooks
  • Gitignore warnings - Suppress gitignore warnings when writing files
  • Input validation - Add input validation tests and edge case coverage

Removed

  • Outdated examples - Removed outdated example scripts and documentation
  • Unused commands module - Removed unused core commands module
  • Legacy provider aliases - Removed legacy provider string aliases (use protocol types instead)

0.3.3 - 2026-02-04

Added

  • Conversation history picker - Add interactive conversation history picker accessible via double-Esc shortcut for quick access to previous messages
  • Session fork and resume - Add /fork command to create new session branches from current conversation state and resume capability
  • Interactive hooks management TUI - Add comprehensive terminal UI for managing hooks with visual interface
  • New hook events - Add new hook events for enhanced extensibility
  • ESC key to quit TUIs - Add ESC key binding to quit agents and models management TUIs
  • OLDPWD validation - Add validation support for cd - command to prevent directory traversal issues
  • Enhanced user tips - Add new commands and improved descriptions to random tips system

Changed

  • Default temperature - Update default model temperature from 0.7 to 1.0 for more creative responses
  • Hooks system improvements - Improve hook system architecture with manager and better integration

Fixed

  • Double exception during tool cancellation - Avoid raising double exceptions during concurrent tool cancellation
  • Grep output parsing - Improve output parsing for paths with colons and Windows paths
  • Gitignore matcher - Implement directory-aware gitignore matcher with proper pattern scoping
  • Rich UI modularization - Split rich_ui.py into modular components for better maintainability

Refactored

  • Query module - Split query module into package structure (context, errors, loop, permissions, tools)
  • Protocol module - Reorganize stdio protocol into package structure (command, handler, timeouts, watchdog)
  • Git utilities - Implement directory-aware gitignore matcher with proper pattern scoping
  • Permissions system - Refactor permission interpreter and add shell command validation

0.3.2 - 2026-02-03

Added

  • Ask rules support - Add explicit ask rules to permission system for commands requiring user confirmation
  • Interactive management TUIs - Add interactive terminal UIs for managing agents, models, and permissions
  • Cache tokens tracking - Add support for Anthropic cache tokens and alternative API usage tracking
  • Random tips system - Add random tips feature to help users discover features during usage
  • Tool filtering - Add tool filtering capability and optimize file slice reading performance

Changed

  • Unified choice component - Introduce unified choice component and refactor permission prompts for consistency
  • Session selection UI - Modernize session selection interface with interactive choice component
  • Theme selection UI - Enhance theme selection with custom styling and interactive prompts
  • Welcome panel and status bar - Improve UX information display in welcome panel and status bar
  • File editing utilities - Extract common file editing utilities to shared module for better code organization

Fixed

  • Long tool descriptions - Truncate long tool descriptions in MCP server list for better display
  • Terminal line calculation - Improve terminal line count calculation for choice prompts
  • Ask rules precedence - Ensure proper precedence: deny > ask > allow in permission evaluation

0.3.1 - 2026-02-02

Added

  • ESC key for permission denial - Press ESC to quickly deny permission requests
  • ESC key interrupt support - Press ESC to interrupt running queries

Changed

  • Permission prompts refactor - Refactor permission prompts using prompt_toolkit for better consistency
  • Permission prompt styling - Optimize the style and color of permission check prompts for better visual feedback

Fixed

  • ESC interrupt handling - Remove ESC interrupt functionality during query execution to avoid agent termination issues

0.3.0 - 2026-01-31

Added

  • Theme management system - Comprehensive theme support with custom color schemes and styling options
  • Image input support - Add support for image input in queries with automatic image processing
  • Sub-process SDK architecture - Complete rewrite of SDK with sub-process architecture for better isolation and reliability
  • Claude Agent SDK compatibility - Full compatibility with Claude Agent SDK protocol and interfaces
  • File encoding detection - Automatic file encoding detection and handling for international text files
  • Tool execution timeout - Implement timeout mechanism for tool execution to prevent hanging
  • Environment variable configuration - Support RIPPERDOC_ prefixed environment variables for model parameters
  • Detailed tool call logging - Enhanced logging system with detailed tool call information
  • Thinking mode toggle - Add toggle and status display for thinking mode
  • Skill list command - New /skills command to list available skills
  • Stdin pipe input - Support piped stdin input for initial queries
  • Session continuation - Implement session continuation feature with enhanced logging
  • Pending message queue - Implement pending message queue for background tasks
  • Fuzzy command matching - Add fuzzy matching for mistyped slash commands with suggestions
  • Background task tracking - Add runtime and age tracking for background tasks
  • Platform utilities - Unified platform detection logic and platform utility module
  • LSP and Skill tools - Add dedicated LSP and Skill tools with enhanced functionality
  • Sub-agent message forwarding - Add message forwarding functionality for sub-agents
  • File read limits - Enhanced file reading tool with size and line limits
  • Doctor command - Add /doctor command for system diagnostics

Changed

  • Protocol package refactor - Move stdio_cmd module to protocol package for better organization
  • SDK removal - Remove legacy in-process SDK implementation
  • Query processing improvements - Ensure tool inputs are always dictionaries with better validation
  • Parallel tool execution - Improved error handling for parallel tool execution with tool names in context
  • File operations enhancement - Enhanced file editing, reading, and writing tools with encoding support
  • Background shell improvements - Better integration with pending message queue
  • UI improvements - Enhanced rich UI with better rendering and user interaction
  • Spinner fixes - Fix terminal output flickering and layout issues
  • Permission checker - Improved tooltip handling and rendering
  • Error messages - Enhanced error messages with model information in error and interrupt messages
  • Git utilities - New comprehensive git utility functions
  • Shell utilities - Improved shell path handling using PureWindowsPath
  • Message formatting - Enhanced message formatting with better image support

Fixed

  • Timestamp conversion - Correct timestamp conversion to use UTC in StructuredFormatter
  • Interrupt handling - Refine interrupt key detection logic on Windows
  • Tool input validation - Ensure tool inputs are always dictionaries
  • File mention completer - Improved file mention completion with better search
  • Type checking - Format code and fix type-checking issues
  • Test coverage - Add comprehensive test coverage for new features

Removed

  • Legacy SDK docs - Remove old SDK documentation
  • QUICKSTART.md - Remove quickstart guide (integrated into main README)
  • In-process SDK mode - Remove in-process mode in favor of sub-process architecture

0.2.10 - 2026-01-14

Added

  • LSP tool integration - Add Language Server Protocol support for code intelligence queries (goToDefinition, findReferences, hover, etc.)
  • Session statistics and heatmap - Visualize session activity patterns with statistics panel and heatmap visualization
  • Bounded file cache - Implement memory-managed file snapshot caching with size limits
  • Enhanced CLI options - Add --tools filter for limiting available tools, custom system prompts, and model selection
  • Double Ctrl+C exit - Implement improved exit handling with double Ctrl+C functionality
  • Quickstart guide - Add comprehensive quickstart documentation for new users
  • Background agent execution - Support for running agents in background mode
  • Flexible permission patterns - Enhanced permission system with wildcard matching and glob patterns
  • New keyboard shortcuts - Additional keyboard shortcuts for improved user interaction

Changed

  • UI rendering improvements - Replace Rich Status with Live+Spinner for cleaner terminal output
  • Permission system refactor - Update shell command validation to use permission checks
  • Model pointer simplification - Reduce model pointer system from 4 to 2 pointers for better performance
  • Session statistics optimization - Consolidate longest session and activity patterns calculation
  • Agent management enhancements - Improved session tracking and hooks integration
  • Permission rule integration - Better global/local rule management in permission system

Fixed

  • Assistant task cancellation - Prevent unnecessary cancellation of assistant_task during query iteration
  • Bounded file cache memory - Ensure memory size does not go negative and improve reasoning preview logic
  • Error handling improvements - Enhanced validation in tools and better memory management
  • Code quality issues - Resolve ruff and mypy code quality problems
  • Legacy code cleanup - Remove outdated code and optimize query queue handling
  • LSP error handling - Improve error handling for Language Server Protocol operations

0.2.9 - 2025-12-20

Added

  • Full thinking output flag - New --show-full-thinking CLI option to display full provider reasoning
  • Spinner pause control - UI spinner now pauses around blocking operations for cleaner terminal output

Changed

  • Permission mode rename - Renamed safe_mode to yolo_mode to better describe relaxed permission behavior
  • Provider selection refactor - Streamlined provider selection logic and defaults
  • Shell command validation - Improved quote handling and interpreter detection for safer execution
  • Hooks typing improvements - Better type annotations and parameter handling for hooks

Fixed

  • DeepSeek tool call compatibility - Include reasoning_content for DeepSeek API tool calls to prevent errors

0.2.8 - 2025-12-19

Added

  • Comprehensive hooks system - Custom script execution at various points during operation (PreToolUse, PermissionRequest, PostToolUse, etc.)
  • Custom command system - File-based command definitions with frontmatter support, parameter substitution, and bash command execution
  • Enhanced hooks CLI - Guided add/edit/delete operations for hook management
  • Hook examples - Comprehensive example scripts for various use cases (logging, validation, notifications, etc.)

Changed

  • Improved hooks integration - Better integration with existing permission and tool systems
  • Enhanced UI for hooks management - User-friendly interface for managing hooks configuration

Fixed

  • Type checking and code quality issues - Various fixes for better code reliability

0.2.7 - 2025-12-19

Added

  • Message formatting utilities - Improved conversation compaction and message handling

Changed

  • Enhanced UI components - Better modularization and user interface improvements
  • Improved type annotations - Better code quality and type checking

Fixed

  • Type checking issues - Resolved various type checking and code quality problems

0.2.6 - 2025-12-18

Added

  • @ symbol file mention completion - Type @ followed by Tab to autocomplete file paths with recursive search
  • ESC key interrupt support - Press ESC to interrupt running queries and commands
  • UI modularization - New modular UI components for better maintainability
  • Conversation compaction - Automatic conversation length management to handle context limits
  • Session resume pagination - Navigate through session history with paginated interface
  • Improved command aliases - Enhanced command shortcuts and usability

Changed

  • UI refactoring - Major UI codebase reorganization into modular components
  • Enhanced interrupt handling - Simplified ESC/Ctrl+C interrupt handling with single raw-mode loop
  • Improved permission dialogs - Better handling of ESC listener during permission checks
  • Better conversation management - Enhanced message compaction and conversation state handling

Fixed

  • ESC key blocking - Fixed ESC key listener blocking terminal during permission dialogs
  • Pydantic validation - Fixed file_state_cache validation for proper cache sharing
  • Shell command permissions - Improved user confirmation for sensitive directory operations

0.2.5 - 2025-12-17

Added

  • Enhanced shell command permissions with user confirmation for sensitive directories
  • Comprehensive path ignore system with gitignore-style patterns
  • Improved shell command security with destructive command detection
  • Comprehensive permission management system
  • File state validation to prevent race conditions
  • Context-length error detection for auto-compaction support
  • Enhanced skill system with context updates and validation
  • Longer MCP lifecycle support
  • Truncation for long grep results
  • Thinking max tokens configuration

Changed

  • Improved error handling and query loop architecture
  • Enhanced tool rendering and model management
  • Better type annotations, error handling, and code formatting
  • Improved system prompt with better guidance and tool integration

0.2.4 - 2025-12-16

Added

  • Experimental support for skills.md
  • Explore and plan agents with improved MCP command parsing

Changed

  • Improved type annotations and error handling across providers
  • Enhanced system prompt with improved guidance and tool integration

0.2.0 - 2025-12-15

Added

  • Python SDK for headless usage
  • MCP (Model Context Protocol) server integration
  • Skill system for extending agent capabilities
  • Subagent system for task delegation
  • Comprehensive tool system with 20+ built-in tools
  • Multi-model support (Anthropic, OpenAI-compatible, Gemini)
  • Permission system with safe mode as default
  • Session management and history tracking
  • Jupyter Notebook support
  • Todo tracking system

Changed

  • Complete rewrite of the architecture for better extensibility
  • Improved security with command validation and path restrictions
  • Enhanced UI with rich terminal interface

0.1.0 - 2025-11-01

Added

  • Initial release
  • Basic AI-powered terminal assistant
  • File operations and code editing
  • Simple command execution
  • Basic project navigation