@naarang/ccc 3.1.0-beta.1 → 3.1.0-beta.11

package/README.md

@@ -1,19 +1,20 @@
-# CCC - A Complete Mobile IDE for Coding Agents like Claude Code
+# C3 - A Complete Mobile IDE for Coding Agents
 
-**Control Claude Code and other coding agents from your mobile device**
+**Control Claude Code, OpenCode, and Codex from your mobile device**
 
-CCC is a complete mobile IDE and more that creates a bridge between [Claude Code](https://claude.com/product/claude-code) and your mobile device, allowing you to chat with Claude and execute code operations remotely through the CCC mobile app.
+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/v2%2Fnpm_readme%2Fcarbon.png?alt=media&token=0ae87eba-4cfd-4d58-ab4a-b7330cbb62be)
+![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/v2%2Fnpm_readme%2FWhatsApp%20Image%202026-01-16%20at%2010.55.20%20PM%20(2).jpeg?alt=media&token=9f71a100-c9ed-4e4e-ae60-f04b86c2b3e7" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v2%2Fnpm_readme%2FWhatsApp%20Image%202026-01-16%20at%2010.55.20%20PM%20(1).jpeg?alt=media&token=6fbb3693-17e1-439e-92f0-f634f79ad51f" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v2%2Fnpm_readme%2FWhatsApp%20Image%202026-01-16%20at%2010.55.20%20PM.jpeg?alt=media&token=3c74c222-7ea5-4e2c-961a-66bcc476a6d7" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v2%2Fnpm_readme%2FWhatsApp%20Image%202026-01-16%20at%2010.55.19%20PM%20(1).jpeg?alt=media&token=e4faec8b-4ad4-400e-9af8-2d0187157f97" width="150" style="margin-right: 8px;" />
-  <img src="https://firebasestorage.googleapis.com/v0/b/cc-chat-ui.firebasestorage.app/o/v2%2Fnpm_readme%2FWhatsApp%20Image%202026-01-16%20at%2010.55.19%20PM.jpeg?alt=media&token=b87ce7ad-dc6e-42d4-a6ac-2d1787f206bd" width="150" style="margin-right: 8px;" />
+  <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>
 
@@ -55,19 +56,34 @@ CCC is a complete mobile IDE and more that creates a bridge between [Claude Code
 
 ## Features
 
-- **Mobile Control** - Chat with Claude from your phone or tablet
-- **Real-time Sync** - See Claude's responses instantly on your device
+### 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 Claude's changes to any checkpoint
+- **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 Claude models during conversations
-- **Push Notifications** - Get notified when Claude needs attention
+- **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
-- **Auto-Update System** - Automatic version checks and updates
+- **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
 
@@ -125,7 +141,7 @@ The server will start and display a QR code for easy mobile setup.
 
 ### 2. Configure the Mobile App
 
-Download the CCC mobile app and scan the QR code, or manually add the server:
+Download the C3 mobile app and scan the QR code, or manually add the server:
 
 **For Local Network:**
 ```
@@ -139,7 +155,7 @@ 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 with Claude!
+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
 
@@ -178,8 +194,9 @@ ccc --debug --router-port 9000
 
 ## Permission Modes
 
-CCC offers four permission modes to balance convenience and security:
+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 |
@@ -187,9 +204,23 @@ CCC offers four permission modes to balance convenience and security:
 | **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
 
-CCC includes a built-in terminal accessible from the mobile app:
+C3 includes a built-in terminal accessible from the mobile app:
 
 - Full terminal emulation with color support
 - Auto-generated secure credentials
@@ -207,9 +238,11 @@ CCC includes a built-in terminal accessible from the mobile app:
 ## System Requirements
 
 - **Bun**: v1.0.0 or higher
-- **Claude Code**: Latest version ([Download](https://claude.com/product/claude-code))
-- **Claude Subscription**: Active Pro / Max account or API KEY
 - **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
 
@@ -231,11 +264,20 @@ ccc --router-port 9000 --mqtt-port 9001
 3. Use correct format: `hostname:8883` (no `http://`)
 4. Enable debug mode: `ccc --debug`
 
-### Claude Not Responding
+### Agent Not Responding
 
-1. Verify Claude Code is installed: `claude --version`
+**Claude Code:**
+1. Verify installed: `claude --version`
 2. Check authentication: `claude auth status`
-3. Verify project path exists and is accessible
+
+**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
 
@@ -245,11 +287,11 @@ ccc --router-port 9000 --mqtt-port 9001
 
 ## Support the Project
 
-If you find CCC useful, consider supporting its development:
+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-CCC-blue?style=for-the-badge" alt="Support CCC">
+    <img src="https://img.shields.io/badge/Support-C3-blue?style=for-the-badge" alt="Support C3">
   </a>
 </p>
 
@@ -257,6 +299,4 @@ If you find CCC useful, consider supporting its development:
 
 **Made with ❤️ by naarang**
 
-> **Note**: This tool requires an active Claude subscription and Claude Code to function properly. This project is not affiliated with, endorsed by, or sponsored in any form by Anthropic, Claude or Claude Code.
-            Claude & Claude Code are/may be a trademark and product of Anthropic, PBC.
-            This is an independent project built to use Claude Code in a convenient way.
+> **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.