@kikkimo/claude-launcher 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,61 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2025-09-21
+
+### Added
+- **Multi-language Support**: Complete internationalization (i18n) system with support for English, Chinese, German, French, Japanese, Korean, Russian, and Spanish
+- **Third-party API Management**: Full support for multiple third-party API providers with secure configuration management
+- **Interactive API Selection Tables**: Beautiful table-based interface for API switching and removal operations
+- **Version Update Checking**: Automatic and manual version update detection with configurable check intervals
+- **Password-Protected Import/Export**: Secure configuration backup and restore with password encryption
+- **Modular Architecture**: Complete refactor to modular design with separated concerns:
+  - `ApiManager` class for API configuration management
+  - Dedicated authentication modules with password strength validation
+  - UI components for menus, prompts, and interactive tables
+  - Crypto utilities for secure data encryption
+  - Language management system with locale support
+- **Enhanced Menu System**: Global menu objects to prevent screen flickering during navigation
+- **API Usage Statistics**: Track and display API usage patterns and statistics
+- **Advanced Input Validation**: Comprehensive validation for URLs, auth tokens, and model configurations
+- **CJK Character Support**: Improved handling of Chinese, Japanese, and Korean characters in UI
+- **First-time Setup Wizard**: Guided setup process for new users with password configuration options
+
+### Changed
+- **Complete Architecture Overhaul**: Migrated from monolithic script to modular architecture with 28+ separate modules
+- **Enhanced Security Model**: Upgraded from basic encryption to industry-standard AES-256-CBC with machine-specific keys
+- **Improved User Experience**: Redesigned all user interactions with consistent Claude-style theming
+- **Better Error Handling**: Comprehensive error management with user-friendly messages in multiple languages
+- **Stdin Management**: Robust stdin cleanup and management to prevent navigation issues
+- **Menu Navigation**: Enhanced arrow key navigation with better state management
+- **Configuration Storage**: Migrated from `.env` files to encrypted JSON configuration format
+
+### Fixed
+- **Memory Leaks**: Resolved EventEmitter memory leaks in input handling
+- **Screen Flickering**: Eliminated menu recreation issues that caused display flickering
+- **Input State Management**: Fixed stdin cleanup issues that prevented proper navigation
+- **API Token Security**: Improved token masking and secure storage mechanisms
+- **Cross-platform Compatibility**: Enhanced support for different terminal environments
+- **Process Termination**: Better handling of Ctrl+C and graceful shutdown sequences
+- **Duplicate Detection**: Robust checking for duplicate API configurations
+- **Unicode Handling**: Fixed string width calculations for international characters
+
+### Refactored
+- **Code Organization**: Split monolithic launcher into focused, testable modules
+- **API Management**: Centralized API configuration handling with the `ApiManager` class
+- **Authentication System**: Dedicated password handling with strength validation
+- **UI Components**: Separated interface logic into reusable components
+- **Error Handling**: Centralized error management with consistent user feedback
+- **Import/Export Logic**: Streamlined configuration backup and restore processes
+- **Language System**: Implemented comprehensive i18n framework for multi-language support
+
+### Security
+- **Enhanced Encryption**: Upgraded to AES-256-CBC encryption for all sensitive data
+- **Password Strength Validation**: Enforced strong password requirements for configuration protection
+- **Secure Token Storage**: Improved API token encryption and masking in displays
+- **Machine-specific Keys**: Maintained machine-binding for configuration security
+- **Input Sanitization**: Enhanced validation for all user inputs to prevent security issues
+
 ## [1.0.0] - 2025-07-20
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # Claude Launcher
 
-An elegant interactive launcher for Claude Code with a beautiful Claude-style interface. Launch Claude Code with various configurations through an intuitive command-line menu.
+An elegant interactive launcher for Claude Code with a beautiful Claude-style interface and comprehensive third-party API management. Launch Claude Code with various configurations through an intuitive multilingual command-line menu.
 
 ## 📖 Documentation
 
@@ -9,13 +9,33 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
 
 ## ✨ Features
 
-- 🎨 **Claude-style interface** with authentic orange/amber color scheme
-- ⌨️ **Arrow key navigation** with fallback to number selection
-- 🔐 **Encrypted API key storage** using AES-256-CBC encryption
-- 🚀 **Multiple launch options** including permission skipping and Kimi K2 API
-- 🌍 **Global installation** - use `claude-launcher` from anywhere
-- 🔧 **Smart configuration** - automatically finds/creates config files
-- 💻 **Cross-platform** - Windows, macOS, and Linux support
+### 🎨 **Beautiful Interface**
+- Claude-style interface with authentic orange/amber color scheme
+- Arrow key navigation with smooth menu transitions
+- Interactive tables for API selection and management
+- Multi-language support (8 languages including English, Chinese, German, French, Japanese, Korean, Russian, Spanish)
+
+### 🔐 **Advanced Security**
+- AES-256-CBC encryption for all sensitive data
+- Machine-specific encryption keys for enhanced security
+- Password-protected configuration import/export
+- Secure API token storage with masked display
+- Strong password requirements and validation
+
+### 🚀 **Third-party API Management**
+- Full support for multiple third-party API providers
+- Interactive API configuration with validation
+- API usage statistics and tracking
+- Secure configuration backup and restore
+- Easy API switching and removal
+
+### 🌍 **Enterprise-grade Features**
+- Global installation - use `claude-launcher` from anywhere
+- Modular architecture with 28+ specialized modules
+- Comprehensive error handling and recovery
+- Version update checking with automatic notifications
+- Cross-platform support (Windows, macOS, Linux)
+- First-time setup wizard for new users
 
 ## 🚀 Quick Start
 
@@ -29,9 +49,12 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
    claude-launcher
    ```
 
-3. **For Kimi API users:** When prompted for the first time, enter your Kimi API key starting with `sk-`
+3. **First-time setup:** The launcher will guide you through:
+   - Language selection (8 languages available)
+   - Security setup (password configuration for import/export)
+   - Third-party API configuration (if desired)
 
-That's it! The launcher will guide you through the setup process.
+That's it! The intuitive interface will guide you through all available options.
 
 ## 📦 Installation
 
@@ -54,19 +77,23 @@ node claude-launcher
 
 ## 🎮 Usage
 
-### Available Launch Options
+### Available Options
 
 1. **Launch Claude Code** - Standard Claude Code launch
 2. **Launch Claude Code (Skip Permissions)** - Launch with `--dangerously-skip-permissions`
-3. **Launch Claude Code with Kimi K2 API** - Use Kimi API with encrypted storage
-4. **Launch Claude Code with Kimi K2 API (Skip Permissions)** - Combine Kimi API with permission skipping
-5. **Exit** - Close the launcher
+3. **Launch Claude Code with Third-party API** - Use configured third-party API
+4. **Launch Claude Code with Third-party API (Skip Permissions)** - Combine third-party API with permission skipping
+5. **Third-party API Management** - Configure, switch, remove APIs, view statistics
+6. **Language Settings** - Switch between 8 supported languages
+7. **Version Update Check** - Check for launcher updates
+8. **Exit** - Close the launcher
 
 ### Interactive Navigation
 
-- **Arrow Keys**: Use ↑↓ to navigate, Enter to select (in TTY environments)
-- **Number Selection**: Type 1-5 and press Enter (in non-TTY environments)
-- **Quick Exit**: Press Esc or Q to quit anytime
+- **Arrow Keys**: Use ↑↓ to navigate, Enter to select
+- **Escape Key**: Press Esc to go back or exit
+- **Multi-language**: All interface text adapts to your selected language
+- **Smart Tables**: Interactive tables for API management with clear visual feedback
 
 ### Example Session
 
@@ -81,44 +108,76 @@ $ claude-launcher
 
   → Launch Claude Code
     Launch Claude Code (Skip Permissions)
-    Launch Claude Code with Kimi K2 API
-    Launch Claude Code with Kimi K2 API (Skip Permissions)
+    Launch Claude Code with Third-party API
+    Launch Claude Code with Third-party API (Skip Permissions)
+    Third-party API Management
+    Language Settings
+    Version Update Check
     Exit
 ```
 
+### Third-party API Management
+
+Access comprehensive API management through the dedicated menu:
+
+```bash
+📋 Third-party API Management
+
+  → Add New API
+    Remove API
+    Switch Active API
+    View Statistics
+    Export Configuration
+    Import Configuration
+    Change Password
+    Back to Main Menu
+```
+
 ## ⚙️ Configuration
 
-### Automatic Configuration
+### Modern Configuration System
 
-On first run, if you select a Kimi API option and no configuration exists, the launcher will:
+Claude Launcher 2.0 uses an advanced configuration system:
 
-1. Automatically create a configuration file at `~/.claude-launcher.env`
-2. Guide you through entering your Kimi API key
-3. Encrypt and store your API key securely using machine-specific encryption
+1. **Encrypted JSON Storage**: Configuration stored at `~/.claude-launcher-apis.json`
+2. **Interactive Setup**: First-time wizard guides you through all options
+3. **Multi-language Support**: Interface adapts to your preferred language
+4. **Security First**: All sensitive data encrypted with AES-256-CBC
 
-### Manual Configuration
+### First-time Setup Process
 
-If you prefer to set up manually, the config file locations are searched in this order:
+1. **Language Selection**: Choose from 8 supported languages
+2. **Security Setup**:
+   - Set up password protection for import/export (recommended)
+   - Or skip for basic usage (limited features)
+3. **API Configuration**: Add third-party APIs as needed
 
-1. `.claude-launcher.env` in current directory
-2. `.claude-launcher.env` in your home directory
-3. `.claude-launcher.env` in the installation directory
+### Third-party API Configuration
 
-### Configuration File Format
+Configure any third-party API provider through the interactive interface:
 
-```env
-KIMI_API_KEY=your_encrypted_api_key_here
-KIMI_BASE_URL=https://api.moonshot.cn/anthropic/
-```
+- **Supported Providers**: OpenAI, Anthropic, Custom APIs, and more
+- **Secure Storage**: All API tokens encrypted before storage
+- **Validation**: Real-time validation of URLs, tokens, and models
+- **Usage Tracking**: Monitor API usage statistics
+
+### Configuration Import/Export
+
+With password protection enabled:
 
-**Note**: The `KIMI_API_KEY` is automatically encrypted when entered through the launcher. Do not manually edit encrypted values.
+- **Export**: Secure backup of all configurations
+- **Import**: Restore configurations on new machines
+- **Password Protected**: All exports encrypted with your password
+- **Automatic Validation**: Import validation ensures data integrity
 
-### Security Features
+### Enhanced Security Features
 
-- **AES-256-CBC Encryption**: API keys are encrypted using industry-standard encryption
-- **Machine-specific Keys**: Encryption keys are derived from machine-specific data
-- **Local Storage Only**: Encrypted keys cannot be decrypted on other machines
-- **Secure Input**: API key input supports copy/paste and validation
+- **AES-256-CBC Encryption**: All sensitive data encrypted with industry-standard algorithms
+- **Machine-specific Keys**: Encryption keys derived from unique machine characteristics
+- **Password Protection**: Optional password layer for configuration import/export
+- **Secure Token Display**: API tokens masked in all interface displays
+- **Strong Password Requirements**: Enforced password complexity for maximum security
+- **Local Storage Only**: All data remains on your machine, cannot be decrypted elsewhere
 
 ## 📋 Requirements
 
@@ -174,4 +233,4 @@ If you encounter any issues or have questions:
 
 ---
 
-**Note**: This launcher is designed to work with Claude Code and Kimi K2 API. Make sure you have Claude Code installed before using this tool.
+**Note**: This launcher is designed to work with Claude Code and various third-party APIs. Make sure you have Claude Code installed before using this tool. For third-party API usage, ensure you have valid API credentials from your preferred provider.