@naarang/ccc 1.1.0-beta.7 → 1.1.0

package/README.md

@@ -7,7 +7,7 @@ CCC is a powerful CLI tool that creates a bridge between [Claude Code](https://c
 [![npm version](https://img.shields.io/npm/v/@naarang/ccc.svg?style=flat-square)](https://www.npmjs.com/package/@naarang/ccc)
 [![Node Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen?style=flat-square)](https://nodejs.org)
 
-![CCC Terminal Screenshot](https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/carbon.png?alt=media&token=1b554dc4-c1b4-42dd-babc-cfdf81b63d48)
+![CCC Terminal Screenshot](https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/carbon%20(1).png?alt=media&token=1541cc51-0a24-4055-b73f-81e181217f53)
 
 <p align="center">
   <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/Projects.jpg?alt=media&token=098ed213-ed4a-4e22-9447-4cd097e9f485" width="150" />
@@ -36,17 +36,26 @@ CCC is a powerful CLI tool that creates a bridge between [Claude Code](https://c
   </a>
 </p>
 
+<p align="center">
+  <a href="https://discord.gg/9EjE8t4YCF">
+    <img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord">
+  </a>
+</p>
+
 ## ✨ Features
 
 - **Mobile Control** - Chat with Claude from your phone or tablet
 - **Real-time Sync** - See Claude's responses instantly on your device
 - **Smart Permission System** - Fine-grained control over code modifications
-- **Web Terminal Access** 🆕 (Beta) - Full terminal access in mobile app with authentication
+- **Web Terminal Access** 🆕 (Beta) - Full terminal access with auto-generated secure credentials
+- **Request Cancellation** 🆕 - Abort ongoing Claude requests from mobile app
+- **Dynamic Project Switching** 🆕 - Terminal automatically changes directory when switching projects
 - **Remote Access** - Optional ngrok integration for access from anywhere
-- **Secure MQTT** - Built-in MQTT broker with authentication support
+- **Secure MQTT** - Built-in MQTT broker with authentication support (required for ngrok)
 - **Session Management** - Persistent sessions across reconnections
 - **Context Awareness** - Full project context and file system access
 - **Auto Hook Setup** - Automatic project configuration for permission handling
+- **Auto-Update System** 🆕 - Automatic version checks and updates (can be disabled)
 
 ## Installation
 
@@ -75,14 +84,19 @@ ccc
 
 The server will start and display:
 ```
-✓ Claude Chat Backend v1.1.0 started successfully
-
+✓ Terminal server started on localhost:3001
+✓ Path router started on port 8883
+✓ Claude Chat Backend v1.1.x started successfully
+ 
 Server URLs (Add one of these in the app settings):
-  Localhost: localhost:8883
-  Network:   192.168.1.100:8883
-
+    Localhost: localhost:8883
+    Network:   192.168.1.135:8883
+ 
 Services:
-  MQTT:      Port 8884 (via /mqtt)
+    MQTT:      Port 8884 (via /mqtt)
+    Terminal:  Port 3001 (via /terminal) - Auto-secured
+ 
+MQTT Auth: Enabled
 ```
 
 ### 2. Configure the Mobile App
@@ -91,7 +105,7 @@ Download the CCC mobile app and add the server connection:
 
 **For Local Network:**
 ```
-Server URL: 192.168.1.100:8883
+Server URL: 192.168.x.xxx:8883
 ```
 
 **For Remote Access:**
@@ -113,19 +127,19 @@ ccc [options]
 
 Options:
   --debug                           Enable debug logging
-  -u, --username <user>             MQTT broker username
-  -p, --password <pass>             MQTT broker password
+  -u, --username <user>             MQTT broker username (required for ngrok)
+  -p, --password <pass>             MQTT broker password (required for ngrok)
   --mqtt-port <port>                Internal MQTT broker port (default: 8884)
   --port <port>                     [DEPRECATED] Use --mqtt-port instead
   --router-port <port>              Internal Request Router port. This is what the app connects to (default: 8883)
   --terminal-port <port>            Internal terminal server port (default: 3001)
-  --terminal-username <user>        Terminal authentication username
-  --terminal-password <pass>        Terminal authentication password
-  -t, --ngrok-token <token>         ngrok auth token (enables public tunnel)
+  -t, --ngrok-token <token>         ngrok auth token (enables public tunnel, requires MQTT auth)
   --ngrok-domain <domain>           ngrok static domain
   --no-auto-update                  Disable automatic updates (enabled by default)
   -v, --version                     Show version number
   -h, --help                        Show help message
+
+Note: Terminal credentials are automatically generated and cannot be configured manually.
 ```
 
 > **Auto-Update**: By default, CCC checks for updates on startup and automatically downloads the latest version. After a successful update, you'll be prompted to manually restart the server. Use `--no-auto-update` to disable this behavior.
@@ -144,11 +158,12 @@ ccc -u admin -p secret
 
 **With terminal access (Beta):**
 ```bash
-# Using separate terminal credentials
-ccc --terminal-username admin --terminal-password secret
+# Terminal credentials are automatically generated
+# No configuration needed - just start the server
+ccc
 
-# Or reuse MQTT credentials for terminal (if -u and -p are provided)
-ccc -u admin -p secret  # Terminal will also use these credentials
+# Terminal credentials are broadcast to authorized clients via MQTT
+# App receives credentials automatically on connection
 ```
 
 **With ngrok for remote access:**
@@ -156,11 +171,13 @@ ccc -u admin -p secret  # Terminal will also use these credentials
 ccc --ngrok-token YOUR_NGROK_TOKEN
 ```
 
-**Full example with ngrok, authentication, and terminal:**
+**Full example with ngrok and authentication:**
 ```bash
+# Terminal credentials auto-generated
+# MQTT authentication required for ngrok
 ccc --ngrok-token YOUR_TOKEN \
-    --terminal-username admin \
-    --terminal-password secret
+    -u admin \
+    -p secret
 ```
 
 **Custom ports with debug logging:**
@@ -168,29 +185,6 @@ ccc --ngrok-token YOUR_TOKEN \
 ccc --mqtt-port 9000 --terminal-port 3002 --debug
 ```
 
-### Environment Variables
-
-Create a `.env` file in your working directory:
-
-```env
-# MQTT Configuration
-MQTT_BROKER_PORT=8884
-MQTT_USERNAME=your-username
-MQTT_PASSWORD=your-password
-
-# Router Configuration
-ROUTER_PORT=8883
-
-# Terminal Configuration (Beta)
-TERMINAL_PORT=3001
-
-# Ngrok Configuration (requires MQTT authentication)
-NGROK_AUTH_TOKEN=your-ngrok-token
-NGROK_DOMAIN=your-custom-domain.ngrok.app
-```
-
-> **Note:** CLI arguments override environment variables
-
 ## 🖥️ Terminal Access (Beta)
 
 CCC now includes a built-in web terminal that can be accessed directly from the mobile app. This feature is currently in **beta** and provides full terminal access to your development environment.
@@ -198,14 +192,15 @@ CCC now includes a built-in web terminal that can be accessed directly from the
 ### Security Model
 
 **Terminal credentials are automatically generated** for maximum security. The terminal server:
-- ✅ **Auto-generates strong credentials** on startup (32-char username + 480-char password)
+- ✅ **Auto-generates strong credentials** on startup
 - ✅ **Always enabled** - no configuration needed
 - ✅ **Credentials shared securely** via MQTT to authorized clients only
 - ❌ **Not user-configurable** - prevents weak passwords
+- 🔄 **Auto-broadcast on connection** - clients receive credentials automatically
 
 **MQTT Authentication** is separate and optional:
 - ✅ **Optional for localhost** - no auth needed for local development
-- ⚠️ **Required for ngrok tunnels** - protects public endpoints
+- ⚠️ **Required for ngrok tunnels** - protects public endpoints (enforced at startup)
 
 ### How It Works
 
@@ -225,7 +220,7 @@ CCC now includes a built-in web terminal that can be accessed directly from the
    - Terminal embedded in mobile app
    - Auto-configures when credentials are provided
    - **Automatic authentication** - App automatically authenticates with terminal (no manual login needed)
-   - Project path updates automatically when switching projects
+   - **Dynamic path updates** - Terminal working directory changes automatically when switching projects via MQTT
    - Starts in your project directory by default
 
 ### Terminal Features
@@ -233,17 +228,19 @@ CCC now includes a built-in web terminal that can be accessed directly from the
 - ✅ Full terminal emulation
 - ✅ Color support and ANSI escape sequences
 - ✅ Responsive design (works on mobile)
-- ✅ Multiple concurrent sessions
+- ✅ Multiple concurrent sessions (max 5)
 - ✅ Automatic resize on orientation change
 - ✅ Custom theme matching app design
 - ✅ Scrollback history
+- ✅ Auto-generated secure credentials (no manual configuration)
+- ✅ Project-aware (changes directory when you switch projects)
 
 ### Usage from Mobile App
 
 Once enabled on the backend:
 1. Open CCC mobile app
-2. Navigate to project settings
-3. Terminal tab will appear automatically
+2. Navigate to the project
+3. Terminal icon will appear in the toolbar automatically
 4. Tap to open full-screen terminal
 5. Terminal opens directly in your project directory
 6. Use on-screen keyboard or external keyboard
@@ -252,17 +249,16 @@ Once enabled on the backend:
 
 ⚠️ **Important Security Notes:**
 
-1. **Use Strong Passwords:** Terminal gives full shell access
-   ```bash
-   # Generate a secure password
-   openssl rand -base64 32
-   ```
+1. **Terminal Credentials are Auto-Generated:** No weak passwords possible
+   - System generates 32-char username + 480-char password on startup
+   - Credentials automatically broadcast to authorized clients via MQTT
+   - Cannot be manually configured (prevents security mistakes)
 
-2. **Combine with ngrok Authentication:** For remote access
+2. **Use MQTT Authentication for ngrok:** Required for remote access
    ```bash
    ccc --ngrok-token YOUR_TOKEN \
-       --terminal-username admin \
-       --terminal-password $(openssl rand -base64 32)
+       -u admin \
+       -p $(openssl rand -base64 32)
    ```
 
 3. **Monitor Active Sessions:** Check logs for suspicious activity
@@ -271,23 +267,27 @@ Once enabled on the backend:
    ```
 
 4. **Restrict Network Access:** Only use on trusted networks or via ngrok
+   - Terminal bound to localhost only
+   - All access must go through authenticated router
 
 ### Troubleshooting Terminal
 
 **Terminal won't connect:**
-- Verify credentials are correct
-- Check logs with `--debug` flag
+- Check logs with `--debug` flag to see credential generation
 - Ensure port 3001 is not in use
+- Verify MQTT connection is established (terminal credentials sent via MQTT)
+- Check that app received terminal configuration (should happen automatically)
 
 **Authentication failures:**
 - Check for IP blocking (max 5 failed attempts)
 - Wait 15 minutes if blocked
-- Restart server to clear blocks
+- Restart server to clear blocks and regenerate credentials
 
 **Terminal not showing in app:**
-- Ensure terminal credentials are set on backend
-- Restart the mobile app
-- Check app settings for terminal configuration
+- Ensure server is running (credentials auto-generated on startup)
+- Verify MQTT connection is active
+- Check that app received system config via MQTT
+- Restart the mobile app to force credential refresh
 
 ## Permission Modes
 
@@ -314,19 +314,6 @@ CCC offers four permission modes to balance convenience and security:
 - **Use with extreme caution!**
 - **Use case:** Controlled environments only
 
-## How It Works
-
-When you start CCC, it:
-
-1. **Starts MQTT Broker** - Embedded broker on port 8884 (localhost)
-2. **Starts Path Router** - HTTP router on port 8883 proxying MQTT and terminal
-3. **Starts Terminal Server** (Optional) - Web terminal on port 3001 if credentials provided (falls back to MQTT credentials)
-4. **Sets Up ngrok Tunnel** (Optional) - Public URL pointing to router
-5. **Sets Up Projects** - Auto-configures permission hooks
-6. **Manages Sessions** - Persistent sessions across disconnects
-7. **Streams Responses** - Real-time Claude responses to mobile
-8. **Handles Permissions** - Smart permission checks based on mode
-
 ### Project Structure
 
 CCC creates the following in your project:
@@ -372,7 +359,10 @@ The CCC mobile app is required to interact with the backend.
 - Multiple project management
 - Real-time chat interface
 - Permission request handling
-- Integrated web terminal (Beta) - when enabled on backend
+- Integrated web terminal (Beta) - auto-configured with secure credentials
+- Request cancellation - abort ongoing Claude operations
+- Dynamic project switching - terminal follows your active project
+- Image attachments support (PNG, JPEG, GIF, WebP - max 5MB each)
 - Server profile management
 - Connection health monitoring
 - Theme support (light/dark)
@@ -381,10 +371,9 @@ The CCC mobile app is required to interact with the backend.
 
 1. Open the mobile app
 2. Go to Settings → Add Server Profile
-3. Enter server URL (e.g., `192.168.1.100:8883`)
+3. Enter server URL
 4. Add credentials if authentication is enabled
-5. Test connection
-6. Create a project pointing to your code directory
+5. Create a project pointing to your code directory
 
 ## Troubleshooting
 
@@ -462,7 +451,7 @@ ccc --router-port 9000 --mqtt-port 9001
 
 ## System Requirements
 
-- **Node.js**: v18.0.0 or higher
+- **Node.js**: v20.0.0 or higher
 - **Claude Code**: Latest version
 - **Claude Subscription**: Active Pro or Max account
 - **Operating Systems**:
@@ -488,19 +477,6 @@ Learn coding concepts by chatting with Claude from mobile.
 ### Pair Programming
 Collaborate with Claude on coding tasks remotely.
 
-## Comparison
-
-### vs Claude Web
-- ✅ Mobile access
-- ✅ Offline project access
-- ✅ Real-time streaming
-- ✅ Local file system access
-
-### vs Claude Desktop
-- ✅ Mobile control
-- ✅ Remote access
-- ✅ Multi-device support
-- ✅ Session persistence
 
 ## Performance
 
@@ -511,6 +487,7 @@ Collaborate with Claude on coding tasks remotely.
 
 ## Support & Community
 
+- **Discord**: Join our community at https://discord.gg/9EjE8t4YCF
 - **Issues**: Report bugs and request features
 - **Discussions**: Ask questions and share ideas
 - **Updates**: Check npm for latest version