@naarang/ccc 3.1.0 → 3.2.0-beta.2

package/README.md

@@ -1,302 +1,327 @@
-# C3 - A Complete Mobile IDE for Coding Agents
-
-**Control Claude Code, OpenCode, and Codex from your mobile device**
-
-C3 is a complete mobile IDE that bridges coding agents — [Claude Code](https://claude.com/product/claude-code), [OpenCode](https://opencode.ai), and [OpenAI Codex](https://developers.openai.com/codex/cli) — to your mobile device, allowing you to chat, execute code operations, and manage your development environment remotely.
-
-[![npm version](https://img.shields.io/npm/v/@naarang/ccc.svg?style=flat-square)](https://www.npmjs.com/package/@naarang/ccc)
-
-![CCC Terminal Screenshot](https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/carbon.png?alt=media&token=ffa799d5-37dd-48be-8e96-748af5a9e030)
-
-<p align="center">
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170302.png?alt=media&token=fdc54646-0fbf-4b0d-9d7a-7ff2a45ae516" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170328.png?alt=media&token=b1af5ee7-1a55-4bd5-9fdf-1596278bfaa7" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170429.png?alt=media&token=4f7d05bc-2b41-4f88-96d5-8836165dea38" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170454.png?alt=media&token=b4ce9795-8cae-4049-8d31-e83be6fb1f7f" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170514.png?alt=media&token=2b3c8416-8ff8-4348-b871-c4cabd880b4f" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170551.png?alt=media&token=5e30d9cb-8441-44af-ba5a-3fb01cee8e98" width="150" style="margin-right: 8px;" />
-</p>
-</p>
-
-<p align="center">
-  <a href="https://play.google.com/store/apps/details?id=com.naarang.ccc">
-    <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/GetItOnGooglePlay_Badge_Web_color_English.png?alt=media&token=d2f34558-ce96-4882-9225-8ded76f759ba" alt="Get it on Google Play" height="80">
-  </a>
-  <br/>
-  <a href="https://play.google.com/apps/testing/com.naarang.ccc">
-    <sub>Join Android Beta Testing</sub>
-  </a>
-</p>
-
-<p align="center">
-  <a href="https://apps.apple.com/in/app/ccc-ui-for-coding-agents/id6753870766">
-    <img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="80">
-  </a>
-  <br/>
-  <a href="https://testflight.apple.com/join/bEVNMrNH">
-    <sub>Join iOS Beta Testing (TestFlight)</sub>
-  </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>
-
-<p align="center">
-  <a href="https://getc3.app">
-    <img src="https://img.shields.io/badge/Website-getc3.app-green?style=for-the-badge" alt="Visit Website">
-  </a>
-  &nbsp;
-  <a href="https://getc3.app/docs">
-    <img src="https://img.shields.io/badge/Docs-Documentation-blue?style=for-the-badge" alt="Documentation">
-  </a>
-</p>
-
-## Features
-
-### Core
-- **Multi-Provider Support** - Switch between Claude Code, OpenCode, and Codex within the same app
-- **Mobile Control** - Chat with any coding agent from your phone or tablet
-- **Real-time Sync** - See responses instantly with streaming support
-- **Smart Permission System** - Fine-grained control over code modifications
-- **Web Terminal Access** - Full terminal access with auto-generated secure credentials
-- **Checkpoints & Rewind** - Rewind changes to any checkpoint
-- **Git Integration** - View diffs, commit, push, and create PRs from mobile
-- **File Explorer & Editor** - Browse and edit project files with syntax highlighting
-- **Session Resume** - Resume sessions and seamlessly switch between devices
-- **Context Window Monitor** - Track token usage and context breakdown
-- **Model Switcher** - Switch between models during conversations
-- **Push Notifications** - Get notified when the agent needs attention
-- **Remote Access** - Optional ngrok integration for access from anywhere
-- **End-to-End Encryption** - All communication between app and backend is encrypted
-
-### Codex-Specific
-- **Collaboration Modes** - Plan, Pair, and Execute modes with dynamic discovery from Codex app-server
-- **Plugin Marketplace** - Browse, install, and manage Codex plugins (Skills, Apps, MCP Servers)
-- **App Connectors** - Manage ChatGPT Apps/connectors (GitHub, Slack, Notion, etc.)
-- **Reasoning Variants** - Configure reasoning effort per model (low/medium/high)
-
-### Claude Code-Specific
-- **Plan Mode** - Design-only mode for code review without execution
-- **Extended Thinking** - Opus thinking with configurable effort levels
-- **Skills & Plugins** - Manage skills, plugins, and marketplace extensions
-- **Hooks** - Configure event-driven automation hooks
-- **Output Styles** - Customize Claude's communication style
-
-## Requirements
-
-**Bun runtime is required.** This package will not work with Node.js.
-
-Install Bun:
-```bash
-# Windows (PowerShell)
-powershell -c "irm bun.sh/install.ps1|iex"
-
-# macOS / Linux
-curl -fsSL https://bun.sh/install | bash
-```
-
-Learn more at [bun.sh](https://bun.sh)
-
-## Installation
-
-### Option 1: npm Install (Recommended)
-
-```bash
-npm install -g @naarang/ccc
-```
-
-Then run:
-```bash
-ccc
-```
-
-### Option 2: Standalone Binary (Beta)
-
-For users who prefer not to install npm/Bun, standalone binaries are available:
-
-**macOS / Linux:**
-```bash
-curl -fsSL https://getc3.app/install.sh | bash
-```
-
-**Windows (PowerShell as Administrator):**
-```powershell
-irm https://getc3.app/install.ps1 | iex
-```
-
-The binary will be installed to `~/.ccc/bin` and added to your PATH.
-
-## Quick Start
-
-### 1. Start the Backend Server
-
-```bash
-ccc
-```
-
-The server will start and display a QR code for easy mobile setup.
-
-### 2. Configure the Mobile App
-
-Download the C3 mobile app and scan the QR code, or manually add the server:
-
-**For Local Network:**
-```
-Server URL: 192.168.x.xxx:8883
-```
-
-**For Remote Access:**
-```bash
-ccc --ngrok-token YOUR_TOKEN --username admin --password yourpassword
-```
-
-### 3. Start Chatting
-
-Open the app, create a project pointing to your local directory, and start chatting! You can switch between Claude Code, OpenCode, and Codex providers from within any chat session.
-
-## CLI Options
-
-```bash
-ccc [options]
-
-Options:
-  -d, --debug                Enable debug logging
-  --mqtt-port <port>         Internal broker port (default: 8884)
-  --router-port <port>       Main server port - app connects here (default: 8883)
-  --terminal-port <port>     Terminal server port (default: 3001)
-  -u, --username <user>      Authentication username (required for ngrok)
-  -p, --password <pass>      Authentication password (required for ngrok)
-  -t, --ngrok-token <token>  ngrok auth token for remote access
-  --ngrok-domain <domain>    ngrok static domain (paid plan)
-  --no-auto-update           Disable automatic updates
-  -v, --version              Show version number
-  -h, --help                 Show help message
-```
-
-### Examples
-
-```bash
-# Basic usage (local network)
-ccc
-
-# With authentication
-ccc -u admin -p secret
-
-# With ngrok for remote access
-ccc --ngrok-token YOUR_TOKEN -u admin -p secret
-
-# Debug mode with custom ports
-ccc --debug --router-port 9000
-```
-
-## Permission Modes
-
-C3 offers permission modes that map to each provider's native controls:
-
-### Claude Code
-| Mode | Description | Use Case |
-|------|-------------|----------|
-| **Default** | Prompts for approval on first use | Balanced security |
-| **Accept Edits** | Auto-approves file modifications | Active development |
-| **Plan Mode** | Analysis only, no code changes | Code review |
-| **Bypass All** | Skips all prompts (use with caution!) | Controlled environments |
-
-### Codex
-| Mode | Description | Sandbox |
-|------|-------------|---------|
-| **Read Only** | Can read files, approval needed for edits | read-only |
-| **Default** | Read, edit, and run commands in workspace | workspace-write |
-| **Full Access** | No sandbox, no approvals | danger-full-access |
-
-### Codex Collaboration Modes
-| Mode | Description |
-|------|-------------|
-| **Plan** | Design only — reads files, makes no changes |
-| **Pair** | Interactive — reads and writes with your approval |
-| **Execute** | Autonomous — executes changes independently |
-
-## Terminal Access
-
-C3 includes a built-in terminal accessible from the mobile app:
-
-- Full terminal emulation with color support
-- Auto-generated secure credentials
-- Project-aware (opens in your project directory)
-- Multiple concurrent sessions (max 5)
-- Automatic resize on orientation change
-
-## Security
-
-- Terminal credentials are auto-generated and never logged
-- Authentication required for remote access (ngrok)
-- All internal services bind to localhost only
-- Rate limiting on failed authentication attempts
-
-## System Requirements
-
-- **Bun**: v1.0.0 or higher
-- **Operating Systems**: Linux, macOS, Windows
-- **At least one coding agent installed**:
-  - [Claude Code](https://claude.com/product/claude-code) (requires Claude Pro/Max subscription or API key)
-  - [OpenCode](https://opencode.ai) (supports multiple LLM providers)
-  - [Codex CLI](https://developers.openai.com/codex/cli) (requires OpenAI API key or ChatGPT subscription)
-
-## Troubleshooting
-
-### Server Won't Start
-
-```bash
-# Check if ports are in use
-lsof -i :8883
-lsof -i :8884
-
-# Use different ports
-ccc --router-port 9000 --mqtt-port 9001
-```
-
-### Connection Issues
-
-1. Ensure you're on the same WiFi network (for local connections)
-2. Check firewall allows port 8883
-3. Use correct format: `hostname:8883` (no `http://`)
-4. Enable debug mode: `ccc --debug`
-
-### Agent Not Responding
-
-**Claude Code:**
-1. Verify installed: `claude --version`
-2. Check authentication: `claude auth status`
-
-**Codex:**
-1. Verify installed: `codex --version`
-2. Check authentication: `codex auth login`
-
-**OpenCode:**
-1. Verify installed: `opencode --version`
-
-For all providers, verify the project path exists and is accessible.
-
-## Support & Community
-
-- **Documentation**: [getc3.app/docs](https://getc3.app/docs)
-- **Discord**: [Join our community](https://discord.gg/9EjE8t4YCF)
-- **Email**: cccuiapp@gmail.com
-
-## Support the Project
-
-If you find C3 useful, consider supporting its development:
-
-<p align="center">
-  <a href="https://getc3.app/support">
-    <img src="https://img.shields.io/badge/Support-C3-blue?style=for-the-badge" alt="Support C3">
-  </a>
-</p>
-
----
-
-**Made with ❤️ by naarang**
-
-> **Note**: This tool requires at least one supported coding agent (Claude Code, OpenCode, or Codex) installed and authenticated. This project is not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, or any agent provider. Claude, Claude Code, Codex, and OpenCode are trademarks of their respective owners. This is an independent project built to provide a mobile interface for coding agents.
+# C3 - A Complete Mobile IDE for Coding Agents
+
+**Control Claude Code, OpenCode, Codex, and Pi from your mobile device**
+
+C3 is a complete mobile IDE that bridges coding agents — [Claude Code](https://claude.com/product/claude-code), [OpenCode](https://opencode.ai), [OpenAI Codex](https://developers.openai.com/codex/cli), and [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) — to your mobile device, allowing you to chat, execute code operations, and manage your development environment remotely.
+
+[![npm version](https://img.shields.io/npm/v/@naarang/ccc.svg?style=flat-square)](https://www.npmjs.com/package/@naarang/ccc)
+
+![CCC Terminal Screenshot](https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/carbon.png?alt=media&token=ffa799d5-37dd-48be-8e96-748af5a9e030)
+
+<p align="center">
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170302.png?alt=media&token=fdc54646-0fbf-4b0d-9d7a-7ff2a45ae516" width="150" style="margin-right: 8px;" />
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170328.png?alt=media&token=b1af5ee7-1a55-4bd5-9fdf-1596278bfaa7" width="150" style="margin-right: 8px;" />
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170429.png?alt=media&token=4f7d05bc-2b41-4f88-96d5-8836165dea38" width="150" style="margin-right: 8px;" />
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170454.png?alt=media&token=b4ce9795-8cae-4049-8d31-e83be6fb1f7f" width="150" style="margin-right: 8px;" />
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170514.png?alt=media&token=2b3c8416-8ff8-4348-b871-c4cabd880b4f" width="150" style="margin-right: 8px;" />
+  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v3%2FScreenshot_20260403-170551.png?alt=media&token=5e30d9cb-8441-44af-ba5a-3fb01cee8e98" width="150" style="margin-right: 8px;" />
+</p>
+</p>
+
+<p align="center">
+  <a href="https://play.google.com/store/apps/details?id=com.naarang.ccc">
+    <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/GetItOnGooglePlay_Badge_Web_color_English.png?alt=media&token=d2f34558-ce96-4882-9225-8ded76f759ba" alt="Get it on Google Play" height="80">
+  </a>
+  <br/>
+  <a href="https://play.google.com/apps/testing/com.naarang.ccc">
+    <sub>Join Android Beta Testing</sub>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://apps.apple.com/in/app/ccc-ui-for-coding-agents/id6753870766">
+    <img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="80">
+  </a>
+  <br/>
+  <a href="https://testflight.apple.com/join/bEVNMrNH">
+    <sub>Join iOS Beta Testing (TestFlight)</sub>
+  </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>
+
+<p align="center">
+  <a href="https://getc3.app">
+    <img src="https://img.shields.io/badge/Website-getc3.app-green?style=for-the-badge" alt="Visit Website">
+  </a>
+  &nbsp;
+  <a href="https://getc3.app/docs">
+    <img src="https://img.shields.io/badge/Docs-Documentation-blue?style=for-the-badge" alt="Documentation">
+  </a>
+</p>
+
+## Features
+
+### Core
+- **Multi-Provider Support** - Switch between Claude Code, OpenCode, Codex, and Pi within the same app
+- **Mobile Control** - Chat with any coding agent from your phone or tablet
+- **Real-time Sync** - See responses instantly with streaming support
+- **Smart Permission System** - Fine-grained control over code modifications
+- **Web Terminal Access** - Full terminal access with auto-generated secure credentials
+- **Checkpoints & Rewind** - Rewind changes to any checkpoint
+- **Git Integration** - View diffs, commit, push, and create PRs from mobile
+- **File Explorer & Editor** - Browse and edit project files with syntax highlighting
+- **Session Resume** - Resume sessions and seamlessly switch between devices
+- **Context Window Monitor** - Track token usage and context breakdown
+- **Model Switcher** - Switch between models during conversations
+- **Push Notifications** - Get notified when the agent needs attention
+- **Remote Access** - Optional ngrok integration for access from anywhere
+- **End-to-End Encryption** - All communication between app and backend is encrypted
+
+### Codex-Specific
+- **Collaboration Modes** - Plan, Pair, and Execute modes with dynamic discovery from Codex app-server
+- **Plugin Marketplace** - Browse, install, and manage Codex plugins (Skills, Apps, MCP Servers)
+- **App Connectors** - Manage ChatGPT Apps/connectors (GitHub, Slack, Notion, etc.)
+- **Reasoning Variants** - Configure reasoning effort per model (low/medium/high)
+
+### Claude Code-Specific
+- **Plan Mode** - Design-only mode for code review without execution
+- **Extended Thinking** - Opus thinking with configurable effort levels
+- **Skills & Plugins** - Manage skills, plugins, and marketplace extensions
+- **Hooks** - Configure event-driven automation hooks
+- **Output Styles** - Customize Claude's communication style
+
+### Pi-Specific
+- **Multi-Provider Models** - Anthropic, OpenAI, Groq, OpenRouter, and local models, all from the same session
+- **Thinking Levels** - Per-turn reasoning effort: minimal, low, medium, high, xhigh
+- **Session Tree Navigation** - Every prompt is a branch — rewind, fork, label, and revisit any node
+- **Bash Execution** - Run shell commands inline with the `!command` prefix; output is recorded into session context
+- **Extension UI Protocol** - Pi extensions can pop dialogs, status chips, widgets, and toasts directly on mobile
+- **Skills, Slash Commands & Prompts** - Full support for `~/.pi/agent/` and project-scoped resources
+- **Steering & Follow-Up** - Interrupt or queue messages mid-stream with `all` or `one-at-a-time` modes
+- **Mobile Settings Panel** - Tune compaction, retry, queueing, and default thinking level from the app
+- **Session Rename & Labels** - Set custom session names and label tree nodes for quick navigation
+
+## Requirements
+
+**Bun runtime is required.** This package will not work with Node.js.
+
+Install Bun:
+```bash
+# Windows (PowerShell)
+powershell -c "irm bun.sh/install.ps1|iex"
+
+# macOS / Linux
+curl -fsSL https://bun.sh/install | bash
+```
+
+Learn more at [bun.sh](https://bun.sh)
+
+## Installation
+
+### Option 1: npm Install (Recommended)
+
+```bash
+npm install -g @naarang/ccc
+```
+
+Then run:
+```bash
+ccc
+```
+
+### Option 2: Standalone Binary (Beta)
+
+For users who prefer not to install npm/Bun, standalone binaries are available:
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://getc3.app/install.sh | bash
+```
+
+**Windows (PowerShell as Administrator):**
+```powershell
+irm https://getc3.app/install.ps1 | iex
+```
+
+The binary will be installed to `~/.ccc/bin` and added to your PATH.
+
+## Quick Start
+
+### 1. Start the Backend Server
+
+```bash
+ccc
+```
+
+The server will start and display a QR code for easy mobile setup.
+
+### 2. Configure the Mobile App
+
+Download the C3 mobile app and scan the QR code, or manually add the server:
+
+**For Local Network:**
+```
+Server URL: 192.168.x.xxx:8883
+```
+
+**For Remote Access:**
+```bash
+ccc --ngrok-token YOUR_TOKEN --username admin --password yourpassword
+```
+
+### 3. Start Chatting
+
+Open the app, create a project pointing to your local directory, and start chatting! You can switch between Claude Code, OpenCode, Codex, and Pi providers from within any chat session.
+
+## CLI Options
+
+```bash
+ccc [options]
+
+Options:
+  -d, --debug                Enable debug logging
+  --mqtt-port <port>         Internal broker port (default: 8884)
+  --router-port <port>       Main server port - app connects here (default: 8883)
+  --terminal-port <port>     Terminal server port (default: 3001)
+  -u, --username <user>      Authentication username (required for ngrok)
+  -p, --password <pass>      Authentication password (required for ngrok)
+  -t, --ngrok-token <token>  ngrok auth token for remote access
+  --ngrok-domain <domain>    ngrok static domain (paid plan)
+  --no-auto-update           Disable automatic updates
+  -v, --version              Show version number
+  -h, --help                 Show help message
+```
+
+### Examples
+
+```bash
+# Basic usage (local network)
+ccc
+
+# With authentication
+ccc -u admin -p secret
+
+# With ngrok for remote access
+ccc --ngrok-token YOUR_TOKEN -u admin -p secret
+
+# Debug mode with custom ports
+ccc --debug --router-port 9000
+```
+
+## Permission Modes
+
+C3 offers permission modes that map to each provider's native controls:
+
+### Claude Code
+| Mode | Description | Use Case |
+|------|-------------|----------|
+| **Default** | Prompts for approval on first use | Balanced security |
+| **Accept Edits** | Auto-approves file modifications | Active development |
+| **Plan Mode** | Analysis only, no code changes | Code review |
+| **Bypass All** | Skips all prompts (use with caution!) | Controlled environments |
+
+### Codex
+| Mode | Description | Sandbox |
+|------|-------------|---------|
+| **Read Only** | Can read files, approval needed for edits | read-only |
+| **Default** | Read, edit, and run commands in workspace | workspace-write |
+| **Full Access** | No sandbox, no approvals | danger-full-access |
+
+### Codex Collaboration Modes
+| Mode | Description |
+|------|-------------|
+| **Plan** | Design only — reads files, makes no changes |
+| **Pair** | Interactive — reads and writes with your approval |
+| **Execute** | Autonomous — executes changes independently |
+
+### Pi
+| Mode | Description | Use Case |
+|------|-------------|----------|
+| **Default** | Approval required for every tool call | Balanced security |
+| **Plan Mode** | Approval required for every tool call | Code review |
+| **Accept Edits** | File reads/writes auto-approved; bash & shell still need approval | Active development |
+| **Bypass All** | Skips all prompts (use with caution!) | Controlled environments |
+
+## Terminal Access
+
+C3 includes a built-in terminal accessible from the mobile app:
+
+- Full terminal emulation with color support
+- Auto-generated secure credentials
+- Project-aware (opens in your project directory)
+- Multiple concurrent sessions (max 5)
+- Automatic resize on orientation change
+
+## Security
+
+- Terminal credentials are auto-generated and never logged
+- Authentication required for remote access (ngrok)
+- All internal services bind to localhost only
+- Rate limiting on failed authentication attempts
+
+## System Requirements
+
+- **Bun**: v1.0.0 or higher
+- **Operating Systems**: Linux, macOS, Windows
+- **At least one coding agent installed**:
+  - [Claude Code](https://claude.com/product/claude-code) (requires Claude Pro/Max subscription or API key)
+  - [OpenCode](https://opencode.ai) (supports multiple LLM providers)
+  - [Codex CLI](https://developers.openai.com/codex/cli) (requires OpenAI API key or ChatGPT subscription)
+  - [Pi Coding Agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) (`npm i -g @mariozechner/pi-coding-agent` — supports Anthropic, OpenAI, Groq, OpenRouter, and local models)
+
+## Troubleshooting
+
+### Server Won't Start
+
+```bash
+# Check if ports are in use
+lsof -i :8883
+lsof -i :8884
+
+# Use different ports
+ccc --router-port 9000 --mqtt-port 9001
+```
+
+### Connection Issues
+
+1. Ensure you're on the same WiFi network (for local connections)
+2. Check firewall allows port 8883
+3. Use correct format: `hostname:8883` (no `http://`)
+4. Enable debug mode: `ccc --debug`
+
+### Agent Not Responding
+
+**Claude Code:**
+1. Verify installed: `claude --version`
+2. Check authentication: `claude auth status`
+
+**Codex:**
+1. Verify installed: `codex --version`
+2. Check authentication: `codex auth login`
+
+**OpenCode:**
+1. Verify installed: `opencode --version`
+
+**Pi:**
+1. Verify installed: `pi --version`
+2. Configure a provider: `pi auth` (Anthropic, OpenAI, Groq, OpenRouter, or local)
+3. Pi must be installed globally (`npm i -g @mariozechner/pi-coding-agent`) — C3 resolves the user-installed SDK at runtime to track the latest models and fixes
+
+For all providers, verify the project path exists and is accessible.
+
+## Support & Community
+
+- **Documentation**: [getc3.app/docs](https://getc3.app/docs)
+- **Discord**: [Join our community](https://discord.gg/9EjE8t4YCF)
+- **Email**: cccuiapp@gmail.com
+
+## Support the Project
+
+If you find C3 useful, consider supporting its development:
+
+<p align="center">
+  <a href="https://getc3.app/support">
+    <img src="https://img.shields.io/badge/Support-C3-blue?style=for-the-badge" alt="Support C3">
+  </a>
+</p>
+
+---
+
+**Made with ❤️ by naarang**
+
+> **Note**: This tool requires at least one supported coding agent (Claude Code, OpenCode, Codex, or Pi) installed and authenticated. This project is not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, or any agent provider. Claude, Claude Code, Codex, OpenCode, and Pi are trademarks of their respective owners. This is an independent project built to provide a mobile interface for coding agents.