v2.5.0

🚀 What's New

Added

• ngrok tunnel integration with --ngrok-auth-token and --ngrok-domain CLI options
• Public tunnel support for remote access to Claude Code Web interface
• Enhanced shutdown handling to properly close ngrok tunnels
• Input validation to ensure both ngrok flags are provided together

Changed

• Improved auto-open behavior to use ngrok public URL when tunnel is active
• Enhanced error handling for ngrok tunnel establishment

Dependencies

• Added @ngrok/ngrok package for tunnel functionality

📦 Installation

npm install -g claude-code-web@2.5.0

🔗 Using ngrok Tunnels

# Start with ngrok tunnel (requires ngrok auth token and reserved domain)
cc-web --ngrok-auth-token YOUR_TOKEN --ngrok-domain your-domain.ngrok.io

Full Changelog: v2.4.0...v2.5.0

v2.4.0

New Features

• Custom command modal: Added multi-line message input via "Custom..." option in commands dropdown
• Keyboard shortcut: Ctrl/Cmd + Enter to run custom commands from the modal
• Enhanced commands dropdown: Improved user experience and interface

Improvements

• Commands menu positioning: Repositioned from floating to anchored within terminal container
• Better integration: Improved positioning and z-index handling for seamless terminal experience

Full changelog available at: https://github.com/vultuk/claude-code-web/blob/main/CHANGELOG.md

v2.3.0: Commands Menu Feature

What's New

Added

• Commands Menu: New floating "/" button in top-right corner provides quick access to custom commands
• Commands API: Backend endpoints for serving markdown files from ~/.claude-code-web/commands directory
• Interactive Interface: Browse and execute commands through an intuitive dropdown menu
• Nested Directory Support: Organize commands in subdirectories with automatic label generation
• Direct Integration: Execute command content directly to active Claude/Codex session

Technical Details

• Commands are stored as markdown files in ~/.claude-code-web/commands
• API endpoints: /api/commands/list and /api/commands/content
• Responsive UI design with dark theme styling
• File system security with path validation

This release enhances user productivity by providing a centralized way to manage and execute frequently used commands and prompts.

v2.2.2

Changes

• Updated Claude Code CLI flag from --dangerously-skip-permissions to --dangerously-bypass-approvals-and-sandbox
• Updated UI text and tooltips to reflect new flag name
• Updated loading messages to match new CLI flag terminology

This patch release ensures compatibility with the latest Claude Code CLI flag naming conventions.

v2.2.1

UI & UX Improvements

Changed

• Improved start button layout and responsive design
• Simplified button styling for better mobile experience
• Increased dialog max-width from 400px to 520px for better button layout

Fixed

• Mobile responsiveness issues with assistant selection buttons

This patch release focuses on improving the user interface and mobile experience, making the assistant selection dialog more user-friendly across all device sizes.

v2.2.0

What's Changed

Added

• Basic test infrastructure with Mocha and unit tests

Fixed

• Command injection vulnerability in commandExists method
• Documentation discrepancy - added missing auth.js file to README structure

Security

• Fixed command injection vulnerability that could potentially allow malicious command execution

Full Changelog: v2.1.3...v2.2.0

v1.12.0 - Advanced Session & Token Analytics

🚀 Major Features

Advanced Analytics System

• 5-hour rolling session windows - Accurate tracking matching Claude's session model
• Sophisticated burn rate calculation - Multi-window analysis with velocity trends
• Token depletion predictions - Confidence-based estimates with trend adjustments
• Plan-specific limits - Support for Claude Pro (19K), Max5 (88K), Max20 (220K), and Custom plans
• P90 analysis - Machine learning-based limit detection for custom plans

Visual Enhancements

• 📊 Progress bar - Color-coded token usage visualization
• 🔥 Burn rate indicators - Visual emojis showing consumption velocity
• 📈 Confidence scoring - Accuracy indicators for predictions
• 📱 Mobile optimization - Responsive analytics display

Technical Improvements

• New UsageAnalytics module for comprehensive tracking
• Enhanced UsageReader with session boundary detection
• Overlapping session detection
• Real-time WebSocket updates every 10 seconds
• Environment variable configuration for plans

📖 Documentation

See Advanced Analytics Guide for complete details.

🔧 Configuration

# Set your plan
export CLAUDE_PLAN=claude-pro

# Custom cost limit
export CLAUDE_COST_LIMIT=50.00

📦 Installation

npm install -g claude-code-web@1.12.0

v1.5.0 - Major Mobile Improvements

🎉 Claude Code Web v1.5.0

This release brings major mobile experience enhancements to Claude Code Web Interface, making it fully responsive and touch-friendly across all mobile devices.

✨ New Features

• Mobile Mode Switcher: Floating action button for switching between chat/code/plan modes on mobile devices
• Responsive Design: Complete mobile-first redesign ensuring content fits perfectly on all screen sizes
• Touch-Optimized Modals: All modals now work seamlessly on mobile with proper touch targets
• Mobile Navigation: Reorganized header with hamburger menu on left, status indicators on right

🐛 Bug Fixes

• Fixed #4: Added mobile-friendly alternative to Shift+Tab for mode switching
• Fixed #3: Resolved horizontal scrolling issues - content now fits within viewport
• Fixed #2: Fixed all modal display issues on mobile devices
• Fixed #5: Corrected mobile navigation bar layout and positioning

📱 Mobile Improvements

• All touch targets meet 44x44px accessibility guidelines
• Smooth scrolling with -webkit-overflow-scrolling: touch
• Body scroll prevention when modals are open
• Backdrop blur effects for better visual separation
• Dynamic terminal resizing based on viewport
• Responsive breakpoints for phones (320px+) and tablets
• Proper overflow handling throughout the application

🔧 Technical Enhancements

• Improved mobile device detection
• Smart terminal column calculation
• Enhanced CSS with calc() for viewport-relative sizing
• Optimized flex layouts for mobile screens
• Better animation performance on touch devices

📦 Installation

npm install -g claude-code-web@1.5.0

🚀 Usage

cc-web
# or
cc-web --port 3000 --folder ~/my-project

🙏 Acknowledgments

Thanks to all contributors and users who reported mobile issues. This release makes Claude Code Web truly mobile-ready!

---

Full Changelog: v1.4.6...v1.5.0