v2.2.0 - Natural Language Settings & Persistent Character Selection

What's New in v2.2.0

New Features

• Natural Language Settings - Use /claude-fx:change-fx-settings to customize settings conversationally without manually editing JSON
• Persistent Character Selection - Character folder choice now persists across sessions (previously session-only)
• CLAUDE_FX_SESSION Support - Explicit session targeting via environment variable for advanced use cases

Improvements

• Performance Optimizations - Enhanced reliability and reduced overhead
• New Character Pack - Added character3 theme with 6 new character states (celebrating, error, greeting, idle, success, working)

Bug Fixes

• Fixed variable names in applyReloadedSettings to match actual overlay properties
• Improved settings reload mechanism

Files Changed

• commands/change-fx-settings.md - New command documentation
• scripts/hook-handler.py - Settings customization logic, persistent character selection
• scripts/overlay.py - Settings reload support, improved state management
• settings-fx.json - Added characterFolder field
• themes/default/character3/ - New character pack (6 PNG files)
• CLAUDE.md - Updated documentation
• README.md - Added v2.2 features and new command

Installation

/plugin marketplace add octaviusp/claude-fx-plugin
/plugin install claude-fx-plugin@claude-fx-marketplace

Run /claude-fx:setup to check dependencies.

Full Changelog

v2.1.0...v2.2.0