@naarang/ccc 3.1.0-beta.13 → 3.1.0-beta.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +301 -301
  2. package/bin/ccc.cjs +82 -82
  3. package/dist/index.js +110 -110
  4. package/dist/scripts/build-binaries.ts +539 -539
  5. package/dist/scripts/build-dist.ts +36 -36
  6. package/dist/scripts/install.ps1 +208 -208
  7. package/dist/scripts/postinstall.cjs +84 -84
  8. package/package.json +94 -89
  9. package/scripts/build-binaries.ts +539 -539
  10. package/scripts/build-dist.ts +36 -36
  11. package/scripts/install.ps1 +208 -208
  12. package/scripts/postinstall.cjs +84 -84
package/README.md CHANGED
@@ -1,302 +1,302 @@
1
- # C3 - A Complete Mobile IDE for Coding Agents
2
-
3
- **Control Claude Code, OpenCode, and Codex from your mobile device**
4
-
5
- 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.
6
-
7
- [![npm version](https://img.shields.io/npm/v/@naarang/ccc.svg?style=flat-square)](https://www.npmjs.com/package/@naarang/ccc)
8
-
9
- ![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)
10
-
11
- <p align="center">
12
- <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;" />
13
- <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;" />
14
- <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;" />
15
- <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;" />
16
- <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;" />
17
- <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;" />
18
- </p>
19
- </p>
20
-
21
- <p align="center">
22
- <a href="https://play.google.com/store/apps/details?id=com.naarang.ccc">
23
- <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">
24
- </a>
25
- <br/>
26
- <a href="https://play.google.com/apps/testing/com.naarang.ccc">
27
- <sub>Join Android Beta Testing</sub>
28
- </a>
29
- </p>
30
-
31
- <p align="center">
32
- <a href="https://apps.apple.com/in/app/ccc-ui-for-coding-agents/id6753870766">
33
- <img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="80">
34
- </a>
35
- <br/>
36
- <a href="https://testflight.apple.com/join/bEVNMrNH">
37
- <sub>Join iOS Beta Testing (TestFlight)</sub>
38
- </a>
39
- </p>
40
-
41
- <p align="center">
42
- <a href="https://discord.gg/9EjE8t4YCF">
43
- <img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord">
44
- </a>
45
- </p>
46
-
47
- <p align="center">
48
- <a href="https://getc3.app">
49
- <img src="https://img.shields.io/badge/Website-getc3.app-green?style=for-the-badge" alt="Visit Website">
50
- </a>
51
- &nbsp;
52
- <a href="https://getc3.app/docs">
53
- <img src="https://img.shields.io/badge/Docs-Documentation-blue?style=for-the-badge" alt="Documentation">
54
- </a>
55
- </p>
56
-
57
- ## Features
58
-
59
- ### Core
60
- - **Multi-Provider Support** - Switch between Claude Code, OpenCode, and Codex within the same app
61
- - **Mobile Control** - Chat with any coding agent from your phone or tablet
62
- - **Real-time Sync** - See responses instantly with streaming support
63
- - **Smart Permission System** - Fine-grained control over code modifications
64
- - **Web Terminal Access** - Full terminal access with auto-generated secure credentials
65
- - **Checkpoints & Rewind** - Rewind changes to any checkpoint
66
- - **Git Integration** - View diffs, commit, push, and create PRs from mobile
67
- - **File Explorer & Editor** - Browse and edit project files with syntax highlighting
68
- - **Session Resume** - Resume sessions and seamlessly switch between devices
69
- - **Context Window Monitor** - Track token usage and context breakdown
70
- - **Model Switcher** - Switch between models during conversations
71
- - **Push Notifications** - Get notified when the agent needs attention
72
- - **Remote Access** - Optional ngrok integration for access from anywhere
73
- - **End-to-End Encryption** - All communication between app and backend is encrypted
74
-
75
- ### Codex-Specific
76
- - **Collaboration Modes** - Plan, Pair, and Execute modes with dynamic discovery from Codex app-server
77
- - **Plugin Marketplace** - Browse, install, and manage Codex plugins (Skills, Apps, MCP Servers)
78
- - **App Connectors** - Manage ChatGPT Apps/connectors (GitHub, Slack, Notion, etc.)
79
- - **Reasoning Variants** - Configure reasoning effort per model (low/medium/high)
80
-
81
- ### Claude Code-Specific
82
- - **Plan Mode** - Design-only mode for code review without execution
83
- - **Extended Thinking** - Opus thinking with configurable effort levels
84
- - **Skills & Plugins** - Manage skills, plugins, and marketplace extensions
85
- - **Hooks** - Configure event-driven automation hooks
86
- - **Output Styles** - Customize Claude's communication style
87
-
88
- ## Requirements
89
-
90
- **Bun runtime is required.** This package will not work with Node.js.
91
-
92
- Install Bun:
93
- ```bash
94
- # Windows (PowerShell)
95
- powershell -c "irm bun.sh/install.ps1|iex"
96
-
97
- # macOS / Linux
98
- curl -fsSL https://bun.sh/install | bash
99
- ```
100
-
101
- Learn more at [bun.sh](https://bun.sh)
102
-
103
- ## Installation
104
-
105
- ### Option 1: npm Install (Recommended)
106
-
107
- ```bash
108
- npm install -g @naarang/ccc
109
- ```
110
-
111
- Then run:
112
- ```bash
113
- ccc
114
- ```
115
-
116
- ### Option 2: Standalone Binary (Beta)
117
-
118
- For users who prefer not to install npm/Bun, standalone binaries are available:
119
-
120
- **macOS / Linux:**
121
- ```bash
122
- curl -fsSL https://getc3.app/install.sh | bash
123
- ```
124
-
125
- **Windows (PowerShell as Administrator):**
126
- ```powershell
127
- irm https://getc3.app/install.ps1 | iex
128
- ```
129
-
130
- The binary will be installed to `~/.ccc/bin` and added to your PATH.
131
-
132
- ## Quick Start
133
-
134
- ### 1. Start the Backend Server
135
-
136
- ```bash
137
- ccc
138
- ```
139
-
140
- The server will start and display a QR code for easy mobile setup.
141
-
142
- ### 2. Configure the Mobile App
143
-
144
- Download the C3 mobile app and scan the QR code, or manually add the server:
145
-
146
- **For Local Network:**
147
- ```
148
- Server URL: 192.168.x.xxx:8883
149
- ```
150
-
151
- **For Remote Access:**
152
- ```bash
153
- ccc --ngrok-token YOUR_TOKEN --username admin --password yourpassword
154
- ```
155
-
156
- ### 3. Start Chatting
157
-
158
- 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.
159
-
160
- ## CLI Options
161
-
162
- ```bash
163
- ccc [options]
164
-
165
- Options:
166
- -d, --debug Enable debug logging
167
- --mqtt-port <port> Internal broker port (default: 8884)
168
- --router-port <port> Main server port - app connects here (default: 8883)
169
- --terminal-port <port> Terminal server port (default: 3001)
170
- -u, --username <user> Authentication username (required for ngrok)
171
- -p, --password <pass> Authentication password (required for ngrok)
172
- -t, --ngrok-token <token> ngrok auth token for remote access
173
- --ngrok-domain <domain> ngrok static domain (paid plan)
174
- --no-auto-update Disable automatic updates
175
- -v, --version Show version number
176
- -h, --help Show help message
177
- ```
178
-
179
- ### Examples
180
-
181
- ```bash
182
- # Basic usage (local network)
183
- ccc
184
-
185
- # With authentication
186
- ccc -u admin -p secret
187
-
188
- # With ngrok for remote access
189
- ccc --ngrok-token YOUR_TOKEN -u admin -p secret
190
-
191
- # Debug mode with custom ports
192
- ccc --debug --router-port 9000
193
- ```
194
-
195
- ## Permission Modes
196
-
197
- C3 offers permission modes that map to each provider's native controls:
198
-
199
- ### Claude Code
200
- | Mode | Description | Use Case |
201
- |------|-------------|----------|
202
- | **Default** | Prompts for approval on first use | Balanced security |
203
- | **Accept Edits** | Auto-approves file modifications | Active development |
204
- | **Plan Mode** | Analysis only, no code changes | Code review |
205
- | **Bypass All** | Skips all prompts (use with caution!) | Controlled environments |
206
-
207
- ### Codex
208
- | Mode | Description | Sandbox |
209
- |------|-------------|---------|
210
- | **Read Only** | Can read files, approval needed for edits | read-only |
211
- | **Default** | Read, edit, and run commands in workspace | workspace-write |
212
- | **Full Access** | No sandbox, no approvals | danger-full-access |
213
-
214
- ### Codex Collaboration Modes
215
- | Mode | Description |
216
- |------|-------------|
217
- | **Plan** | Design only — reads files, makes no changes |
218
- | **Pair** | Interactive — reads and writes with your approval |
219
- | **Execute** | Autonomous — executes changes independently |
220
-
221
- ## Terminal Access
222
-
223
- C3 includes a built-in terminal accessible from the mobile app:
224
-
225
- - Full terminal emulation with color support
226
- - Auto-generated secure credentials
227
- - Project-aware (opens in your project directory)
228
- - Multiple concurrent sessions (max 5)
229
- - Automatic resize on orientation change
230
-
231
- ## Security
232
-
233
- - Terminal credentials are auto-generated and never logged
234
- - Authentication required for remote access (ngrok)
235
- - All internal services bind to localhost only
236
- - Rate limiting on failed authentication attempts
237
-
238
- ## System Requirements
239
-
240
- - **Bun**: v1.0.0 or higher
241
- - **Operating Systems**: Linux, macOS, Windows
242
- - **At least one coding agent installed**:
243
- - [Claude Code](https://claude.com/product/claude-code) (requires Claude Pro/Max subscription or API key)
244
- - [OpenCode](https://opencode.ai) (supports multiple LLM providers)
245
- - [Codex CLI](https://developers.openai.com/codex/cli) (requires OpenAI API key or ChatGPT subscription)
246
-
247
- ## Troubleshooting
248
-
249
- ### Server Won't Start
250
-
251
- ```bash
252
- # Check if ports are in use
253
- lsof -i :8883
254
- lsof -i :8884
255
-
256
- # Use different ports
257
- ccc --router-port 9000 --mqtt-port 9001
258
- ```
259
-
260
- ### Connection Issues
261
-
262
- 1. Ensure you're on the same WiFi network (for local connections)
263
- 2. Check firewall allows port 8883
264
- 3. Use correct format: `hostname:8883` (no `http://`)
265
- 4. Enable debug mode: `ccc --debug`
266
-
267
- ### Agent Not Responding
268
-
269
- **Claude Code:**
270
- 1. Verify installed: `claude --version`
271
- 2. Check authentication: `claude auth status`
272
-
273
- **Codex:**
274
- 1. Verify installed: `codex --version`
275
- 2. Check authentication: `codex auth login`
276
-
277
- **OpenCode:**
278
- 1. Verify installed: `opencode --version`
279
-
280
- For all providers, verify the project path exists and is accessible.
281
-
282
- ## Support & Community
283
-
284
- - **Documentation**: [getc3.app/docs](https://getc3.app/docs)
285
- - **Discord**: [Join our community](https://discord.gg/9EjE8t4YCF)
286
- - **Email**: cccuiapp@gmail.com
287
-
288
- ## Support the Project
289
-
290
- If you find C3 useful, consider supporting its development:
291
-
292
- <p align="center">
293
- <a href="https://getc3.app/support">
294
- <img src="https://img.shields.io/badge/Support-C3-blue?style=for-the-badge" alt="Support C3">
295
- </a>
296
- </p>
297
-
298
- ---
299
-
300
- **Made with ❤️ by naarang**
301
-
1
+ # C3 - A Complete Mobile IDE for Coding Agents
2
+
3
+ **Control Claude Code, OpenCode, and Codex from your mobile device**
4
+
5
+ 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.
6
+
7
+ [![npm version](https://img.shields.io/npm/v/@naarang/ccc.svg?style=flat-square)](https://www.npmjs.com/package/@naarang/ccc)
8
+
9
+ ![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)
10
+
11
+ <p align="center">
12
+ <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;" />
13
+ <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;" />
14
+ <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;" />
15
+ <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;" />
16
+ <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;" />
17
+ <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;" />
18
+ </p>
19
+ </p>
20
+
21
+ <p align="center">
22
+ <a href="https://play.google.com/store/apps/details?id=com.naarang.ccc">
23
+ <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">
24
+ </a>
25
+ <br/>
26
+ <a href="https://play.google.com/apps/testing/com.naarang.ccc">
27
+ <sub>Join Android Beta Testing</sub>
28
+ </a>
29
+ </p>
30
+
31
+ <p align="center">
32
+ <a href="https://apps.apple.com/in/app/ccc-ui-for-coding-agents/id6753870766">
33
+ <img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="80">
34
+ </a>
35
+ <br/>
36
+ <a href="https://testflight.apple.com/join/bEVNMrNH">
37
+ <sub>Join iOS Beta Testing (TestFlight)</sub>
38
+ </a>
39
+ </p>
40
+
41
+ <p align="center">
42
+ <a href="https://discord.gg/9EjE8t4YCF">
43
+ <img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord">
44
+ </a>
45
+ </p>
46
+
47
+ <p align="center">
48
+ <a href="https://getc3.app">
49
+ <img src="https://img.shields.io/badge/Website-getc3.app-green?style=for-the-badge" alt="Visit Website">
50
+ </a>
51
+ &nbsp;
52
+ <a href="https://getc3.app/docs">
53
+ <img src="https://img.shields.io/badge/Docs-Documentation-blue?style=for-the-badge" alt="Documentation">
54
+ </a>
55
+ </p>
56
+
57
+ ## Features
58
+
59
+ ### Core
60
+ - **Multi-Provider Support** - Switch between Claude Code, OpenCode, and Codex within the same app
61
+ - **Mobile Control** - Chat with any coding agent from your phone or tablet
62
+ - **Real-time Sync** - See responses instantly with streaming support
63
+ - **Smart Permission System** - Fine-grained control over code modifications
64
+ - **Web Terminal Access** - Full terminal access with auto-generated secure credentials
65
+ - **Checkpoints & Rewind** - Rewind changes to any checkpoint
66
+ - **Git Integration** - View diffs, commit, push, and create PRs from mobile
67
+ - **File Explorer & Editor** - Browse and edit project files with syntax highlighting
68
+ - **Session Resume** - Resume sessions and seamlessly switch between devices
69
+ - **Context Window Monitor** - Track token usage and context breakdown
70
+ - **Model Switcher** - Switch between models during conversations
71
+ - **Push Notifications** - Get notified when the agent needs attention
72
+ - **Remote Access** - Optional ngrok integration for access from anywhere
73
+ - **End-to-End Encryption** - All communication between app and backend is encrypted
74
+
75
+ ### Codex-Specific
76
+ - **Collaboration Modes** - Plan, Pair, and Execute modes with dynamic discovery from Codex app-server
77
+ - **Plugin Marketplace** - Browse, install, and manage Codex plugins (Skills, Apps, MCP Servers)
78
+ - **App Connectors** - Manage ChatGPT Apps/connectors (GitHub, Slack, Notion, etc.)
79
+ - **Reasoning Variants** - Configure reasoning effort per model (low/medium/high)
80
+
81
+ ### Claude Code-Specific
82
+ - **Plan Mode** - Design-only mode for code review without execution
83
+ - **Extended Thinking** - Opus thinking with configurable effort levels
84
+ - **Skills & Plugins** - Manage skills, plugins, and marketplace extensions
85
+ - **Hooks** - Configure event-driven automation hooks
86
+ - **Output Styles** - Customize Claude's communication style
87
+
88
+ ## Requirements
89
+
90
+ **Bun runtime is required.** This package will not work with Node.js.
91
+
92
+ Install Bun:
93
+ ```bash
94
+ # Windows (PowerShell)
95
+ powershell -c "irm bun.sh/install.ps1|iex"
96
+
97
+ # macOS / Linux
98
+ curl -fsSL https://bun.sh/install | bash
99
+ ```
100
+
101
+ Learn more at [bun.sh](https://bun.sh)
102
+
103
+ ## Installation
104
+
105
+ ### Option 1: npm Install (Recommended)
106
+
107
+ ```bash
108
+ npm install -g @naarang/ccc
109
+ ```
110
+
111
+ Then run:
112
+ ```bash
113
+ ccc
114
+ ```
115
+
116
+ ### Option 2: Standalone Binary (Beta)
117
+
118
+ For users who prefer not to install npm/Bun, standalone binaries are available:
119
+
120
+ **macOS / Linux:**
121
+ ```bash
122
+ curl -fsSL https://getc3.app/install.sh | bash
123
+ ```
124
+
125
+ **Windows (PowerShell as Administrator):**
126
+ ```powershell
127
+ irm https://getc3.app/install.ps1 | iex
128
+ ```
129
+
130
+ The binary will be installed to `~/.ccc/bin` and added to your PATH.
131
+
132
+ ## Quick Start
133
+
134
+ ### 1. Start the Backend Server
135
+
136
+ ```bash
137
+ ccc
138
+ ```
139
+
140
+ The server will start and display a QR code for easy mobile setup.
141
+
142
+ ### 2. Configure the Mobile App
143
+
144
+ Download the C3 mobile app and scan the QR code, or manually add the server:
145
+
146
+ **For Local Network:**
147
+ ```
148
+ Server URL: 192.168.x.xxx:8883
149
+ ```
150
+
151
+ **For Remote Access:**
152
+ ```bash
153
+ ccc --ngrok-token YOUR_TOKEN --username admin --password yourpassword
154
+ ```
155
+
156
+ ### 3. Start Chatting
157
+
158
+ 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.
159
+
160
+ ## CLI Options
161
+
162
+ ```bash
163
+ ccc [options]
164
+
165
+ Options:
166
+ -d, --debug Enable debug logging
167
+ --mqtt-port <port> Internal broker port (default: 8884)
168
+ --router-port <port> Main server port - app connects here (default: 8883)
169
+ --terminal-port <port> Terminal server port (default: 3001)
170
+ -u, --username <user> Authentication username (required for ngrok)
171
+ -p, --password <pass> Authentication password (required for ngrok)
172
+ -t, --ngrok-token <token> ngrok auth token for remote access
173
+ --ngrok-domain <domain> ngrok static domain (paid plan)
174
+ --no-auto-update Disable automatic updates
175
+ -v, --version Show version number
176
+ -h, --help Show help message
177
+ ```
178
+
179
+ ### Examples
180
+
181
+ ```bash
182
+ # Basic usage (local network)
183
+ ccc
184
+
185
+ # With authentication
186
+ ccc -u admin -p secret
187
+
188
+ # With ngrok for remote access
189
+ ccc --ngrok-token YOUR_TOKEN -u admin -p secret
190
+
191
+ # Debug mode with custom ports
192
+ ccc --debug --router-port 9000
193
+ ```
194
+
195
+ ## Permission Modes
196
+
197
+ C3 offers permission modes that map to each provider's native controls:
198
+
199
+ ### Claude Code
200
+ | Mode | Description | Use Case |
201
+ |------|-------------|----------|
202
+ | **Default** | Prompts for approval on first use | Balanced security |
203
+ | **Accept Edits** | Auto-approves file modifications | Active development |
204
+ | **Plan Mode** | Analysis only, no code changes | Code review |
205
+ | **Bypass All** | Skips all prompts (use with caution!) | Controlled environments |
206
+
207
+ ### Codex
208
+ | Mode | Description | Sandbox |
209
+ |------|-------------|---------|
210
+ | **Read Only** | Can read files, approval needed for edits | read-only |
211
+ | **Default** | Read, edit, and run commands in workspace | workspace-write |
212
+ | **Full Access** | No sandbox, no approvals | danger-full-access |
213
+
214
+ ### Codex Collaboration Modes
215
+ | Mode | Description |
216
+ |------|-------------|
217
+ | **Plan** | Design only — reads files, makes no changes |
218
+ | **Pair** | Interactive — reads and writes with your approval |
219
+ | **Execute** | Autonomous — executes changes independently |
220
+
221
+ ## Terminal Access
222
+
223
+ C3 includes a built-in terminal accessible from the mobile app:
224
+
225
+ - Full terminal emulation with color support
226
+ - Auto-generated secure credentials
227
+ - Project-aware (opens in your project directory)
228
+ - Multiple concurrent sessions (max 5)
229
+ - Automatic resize on orientation change
230
+
231
+ ## Security
232
+
233
+ - Terminal credentials are auto-generated and never logged
234
+ - Authentication required for remote access (ngrok)
235
+ - All internal services bind to localhost only
236
+ - Rate limiting on failed authentication attempts
237
+
238
+ ## System Requirements
239
+
240
+ - **Bun**: v1.0.0 or higher
241
+ - **Operating Systems**: Linux, macOS, Windows
242
+ - **At least one coding agent installed**:
243
+ - [Claude Code](https://claude.com/product/claude-code) (requires Claude Pro/Max subscription or API key)
244
+ - [OpenCode](https://opencode.ai) (supports multiple LLM providers)
245
+ - [Codex CLI](https://developers.openai.com/codex/cli) (requires OpenAI API key or ChatGPT subscription)
246
+
247
+ ## Troubleshooting
248
+
249
+ ### Server Won't Start
250
+
251
+ ```bash
252
+ # Check if ports are in use
253
+ lsof -i :8883
254
+ lsof -i :8884
255
+
256
+ # Use different ports
257
+ ccc --router-port 9000 --mqtt-port 9001
258
+ ```
259
+
260
+ ### Connection Issues
261
+
262
+ 1. Ensure you're on the same WiFi network (for local connections)
263
+ 2. Check firewall allows port 8883
264
+ 3. Use correct format: `hostname:8883` (no `http://`)
265
+ 4. Enable debug mode: `ccc --debug`
266
+
267
+ ### Agent Not Responding
268
+
269
+ **Claude Code:**
270
+ 1. Verify installed: `claude --version`
271
+ 2. Check authentication: `claude auth status`
272
+
273
+ **Codex:**
274
+ 1. Verify installed: `codex --version`
275
+ 2. Check authentication: `codex auth login`
276
+
277
+ **OpenCode:**
278
+ 1. Verify installed: `opencode --version`
279
+
280
+ For all providers, verify the project path exists and is accessible.
281
+
282
+ ## Support & Community
283
+
284
+ - **Documentation**: [getc3.app/docs](https://getc3.app/docs)
285
+ - **Discord**: [Join our community](https://discord.gg/9EjE8t4YCF)
286
+ - **Email**: cccuiapp@gmail.com
287
+
288
+ ## Support the Project
289
+
290
+ If you find C3 useful, consider supporting its development:
291
+
292
+ <p align="center">
293
+ <a href="https://getc3.app/support">
294
+ <img src="https://img.shields.io/badge/Support-C3-blue?style=for-the-badge" alt="Support C3">
295
+ </a>
296
+ </p>
297
+
298
+ ---
299
+
300
+ **Made with ❤️ by naarang**
301
+
302
302
  > **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.