Added

• MCP Server: Model Context Protocol server for AI assistant integration
  • Enables Claude Code and other AI assistants to manage sessions programmatically
  • STDIO and HTTP transport support
  • Session management tools: create, list, get, delete, archive, activate, swap
  • Worktree management tools: list, add, remove
  • Project management tools: list, add, get
  • Template and rules tools for automation
  • Guided workflow prompts for session creation
  • Dynamic resources for session data access
• New CLI command: sxn mcp start to launch the MCP server
• New binary: sxn-mcp for direct MCP server execution

Documentation

• Added MCP_IMPLEMENTATION.md with architecture and usage details

Installation

gem install sxn

Or add to your Gemfile:

gem 'sxn', '~> 0.4.0'

Full Changelog: v0.3.0...v0.4.0

Added

• Session templates support for creating sessions from predefined configurations
  • sxn templates list to view available templates
  • sxn templates show <name> to view template details
  • --template option for sxn sessions add to create sessions from templates
• TemplateManager for template operations and validation
• TemplatesConfig for loading templates from templates.yml
• Session template error classes for better error handling

Fixed

• Project rules now correctly apply when creating sessions from templates

Full Changelog: v0.2.5...v0.3.0

Added

• sxn enter command to quickly navigate to current session directory
• sxn current enter subcommand as alternative way to enter session
• --path option for sxn current to output only the session path
• sxn shell command to install shell integration (idempotent)
  • Auto-detects shell type (bash/zsh)
  • Installs sxn-enter function to shell config
  • Supports --uninstall to remove integration
  • Supports --shell-type to specify shell explicitly

Full Changelog: v0.2.4...v0.2.5

Added

• Interactive worktree wizard after session creation
  • Prompts to add worktrees with descriptive explanations
  • Supports adding multiple worktrees in sequence
  • Explains branch options including remote tracking syntax
• --skip-worktree flag to bypass the wizard when creating sessions
• --verbose flag for worktree debugging with detailed git output

Changed

• Sessions now automatically switch to newly created session (no need to run sxn use afterwards)
• Improved project manager to safely handle nil projects configuration

Fixed

• Fixed test mocks for verbose parameter in worktree operations
• Fixed version spec to support semver pre-release format

Full Changelog: v0.2.3...v0.2.4

🚀 Release v0.2.3

✨ New Features

Smart Worktree Management

• Session-based branch defaults: Worktrees now use session name as default branch when none specified
• Remote branch tracking: Support for remote: prefix syntax (e.g., sxn worktree add project remote:origin/feature)
• Automatic orphaned worktree recovery: Handles and cleans up orphaned/missing worktrees automatically

🛠️ Improvements

Development Workflow

• Pre-push hooks: Automated RuboCop and RSpec checks before pushing
• Setup script: Easy hook installation with ./script/setup-hooks
• Enhanced documentation: Comprehensive testing and linting workflow in README

Error Handling

• Better error messages with actionable suggestions
• Improved worktree creation logic to handle existing/orphaned states
• Enhanced remote branch operation error handling

🐛 Bug Fixes

• Fixed orphaned worktree cleanup for both existing and missing directories
• Fixed worktree creation branch conflict handling
• Fixed default branch detection test for modern git (main vs master)

📊 Code Quality

• Test coverage improved to 95.92% overall
• Worktree manager coverage increased from 78% to 90%
• All RuboCop violations resolved
• Comprehensive test suite with 2,339 examples

📚 Documentation

• Updated CLI help with new branch options and examples
• Added development workflow guide
• Documented pre-push hooks and quality checks

🔧 For Developers

Run ./script/setup-hooks after pulling to enable automated quality checks.

Full Changelog: v0.2.2...v0.2.3

What's Changed

✨ Features

• Database migration system for automatic schema upgrades
• Support for worktrees and projects columns in sessions

🐛 Bug Fixes

• Fixed sxn remove -f timeout issue with force flag
• Resolved CLI option passing between shortcuts and command classes

🧪 Testing

• Added CI skip conditions for SQLite performance tests
• Improved test stability in CI environments
• Maintained 95.99% test coverage

📝 Documentation

• Added author's note acknowledging Claude Code as primary developer

Technical Details

• Migrates existing databases from schema v1 to v2
• Preserves all existing session data during migration
• Backward compatible with older installations

Full Changelog: v0.2.1...v0.2.2

🐛 Bug Fixes Release

This release fixes critical issues with the sxn list command and SQLite3 compatibility.

🔧 Fixed

• SQLite3 datatype mismatch error when running sxn list
• Empty session list bug where sxn list showed no sessions even when sxn status showed they exist
• Type coercion issues with database parameters
• Enhanced error logging for better debugging of SQLite3 errors

🎯 The Problem

Users were experiencing:

1. SQLite3::MismatchException errors when running sxn list
2. sxn status showing "Total Sessions: 3" but sxn list showing "No sessions found"

✅ The Solution

• Ensured all database parameters (LIMIT, OFFSET) are properly typed as integers
• Fixed Thor CLI options type handling
• Added robust type coercion for all SQLite3 parameters
• Improved error messages for debugging

📦 Installation

gem install sxn

Or update existing installation:

gem update sxn

🔄 Upgrading from 0.2.0

Simply update the gem - no database migration or data changes required:

gem update sxn

🙏 Thanks

Thanks for the bug reports! This fix ensures sxn list works reliably across all Ruby versions (3.2-3.4) and SQLite3 versions.

🎉 First Release

This is the first release of sxn - a powerful session management tool for multi-repository development with git worktree integration.

✨ Highlights

• 🚀 Complete session management system for multi-repository workflows
• 🌳 Git worktree integration with intelligent project detection
• 🔒 Comprehensive security layer with path validation and sandboxed templates
• 💾 SQLite-based persistence for session state
• 📝 Liquid template engine for secure automation
• ✅ 2,324 tests with 87.75% branch coverage

📦 Installation

gem install sxn

🚀 Quick Start

# Initialize sxn in your project
sxn init

# Create a new session
sxn session create my-feature

# List sessions
sxn session list

📋 Full Changelog

See CHANGELOG.md for complete details.

🙏 Acknowledgments

This release includes comprehensive testing and CI compatibility improvements for Ruby 3.2-3.4.