@cloudcli-ai/cloudcli 1.29.2 → 1.29.4

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 (140) hide show
  1. package/dist/assets/{index-ByHZ8-LL.css → index-BBAE1OJ_.css} +1 -1
  2. package/dist/assets/{index-Ile1bTCU.js → index-Cyya3LhN.js} +229 -229
  3. package/dist/index.html +2 -2
  4. package/dist-server/server/claude-sdk.js +702 -0
  5. package/dist-server/server/claude-sdk.js.map +1 -0
  6. package/dist-server/server/cli.js +642 -0
  7. package/dist-server/server/cli.js.map +1 -0
  8. package/dist-server/server/constants/config.js +6 -0
  9. package/dist-server/server/constants/config.js.map +1 -0
  10. package/dist-server/server/cursor-cli.js +277 -0
  11. package/dist-server/server/cursor-cli.js.map +1 -0
  12. package/dist-server/server/database/db.js +535 -0
  13. package/dist-server/server/database/db.js.map +1 -0
  14. package/dist-server/server/database/schema.js +97 -0
  15. package/dist-server/server/database/schema.js.map +1 -0
  16. package/dist-server/server/gemini-cli.js +408 -0
  17. package/dist-server/server/gemini-cli.js.map +1 -0
  18. package/dist-server/server/gemini-response-handler.js +72 -0
  19. package/dist-server/server/gemini-response-handler.js.map +1 -0
  20. package/dist-server/server/index.js +2175 -0
  21. package/dist-server/server/index.js.map +1 -0
  22. package/dist-server/server/load-env.js +32 -0
  23. package/dist-server/server/load-env.js.map +1 -0
  24. package/dist-server/server/middleware/auth.js +111 -0
  25. package/dist-server/server/middleware/auth.js.map +1 -0
  26. package/dist-server/server/openai-codex.js +373 -0
  27. package/dist-server/server/openai-codex.js.map +1 -0
  28. package/dist-server/server/projects.js +2325 -0
  29. package/dist-server/server/projects.js.map +1 -0
  30. package/dist-server/server/providers/claude/adapter.js +266 -0
  31. package/dist-server/server/providers/claude/adapter.js.map +1 -0
  32. package/dist-server/server/providers/claude/status.js +121 -0
  33. package/dist-server/server/providers/claude/status.js.map +1 -0
  34. package/dist-server/server/providers/codex/adapter.js +232 -0
  35. package/dist-server/server/providers/codex/adapter.js.map +1 -0
  36. package/dist-server/server/providers/codex/status.js +70 -0
  37. package/dist-server/server/providers/codex/status.js.map +1 -0
  38. package/dist-server/server/providers/cursor/adapter.js +342 -0
  39. package/dist-server/server/providers/cursor/adapter.js.map +1 -0
  40. package/dist-server/server/providers/cursor/status.js +118 -0
  41. package/dist-server/server/providers/cursor/status.js.map +1 -0
  42. package/dist-server/server/providers/gemini/adapter.js +174 -0
  43. package/dist-server/server/providers/gemini/adapter.js.map +1 -0
  44. package/dist-server/server/providers/gemini/status.js +104 -0
  45. package/dist-server/server/providers/gemini/status.js.map +1 -0
  46. package/dist-server/server/providers/registry.js +58 -0
  47. package/dist-server/server/providers/registry.js.map +1 -0
  48. package/dist-server/server/providers/types.js +117 -0
  49. package/dist-server/server/providers/types.js.map +1 -0
  50. package/dist-server/server/providers/utils.js +28 -0
  51. package/dist-server/server/providers/utils.js.map +1 -0
  52. package/dist-server/server/routes/agent.js +1147 -0
  53. package/dist-server/server/routes/agent.js.map +1 -0
  54. package/dist-server/server/routes/auth.js +117 -0
  55. package/dist-server/server/routes/auth.js.map +1 -0
  56. package/dist-server/server/routes/cli-auth.js +25 -0
  57. package/dist-server/server/routes/cli-auth.js.map +1 -0
  58. package/dist-server/server/routes/codex.js +294 -0
  59. package/dist-server/server/routes/codex.js.map +1 -0
  60. package/dist-server/server/routes/commands.js +531 -0
  61. package/dist-server/server/routes/commands.js.map +1 -0
  62. package/dist-server/server/routes/cursor.js +529 -0
  63. package/dist-server/server/routes/cursor.js.map +1 -0
  64. package/dist-server/server/routes/gemini.js +21 -0
  65. package/dist-server/server/routes/gemini.js.map +1 -0
  66. package/dist-server/server/routes/git.js +1259 -0
  67. package/dist-server/server/routes/git.js.map +1 -0
  68. package/dist-server/server/routes/mcp-utils.js +46 -0
  69. package/dist-server/server/routes/mcp-utils.js.map +1 -0
  70. package/dist-server/server/routes/mcp.js +480 -0
  71. package/dist-server/server/routes/mcp.js.map +1 -0
  72. package/dist-server/server/routes/messages.js +56 -0
  73. package/dist-server/server/routes/messages.js.map +1 -0
  74. package/dist-server/server/routes/plugins.js +266 -0
  75. package/dist-server/server/routes/plugins.js.map +1 -0
  76. package/dist-server/server/routes/projects.js +505 -0
  77. package/dist-server/server/routes/projects.js.map +1 -0
  78. package/dist-server/server/routes/settings.js +249 -0
  79. package/dist-server/server/routes/settings.js.map +1 -0
  80. package/dist-server/server/routes/taskmaster.js +1832 -0
  81. package/dist-server/server/routes/taskmaster.js.map +1 -0
  82. package/dist-server/server/routes/user.js +115 -0
  83. package/dist-server/server/routes/user.js.map +1 -0
  84. package/dist-server/server/services/notification-orchestrator.js +177 -0
  85. package/dist-server/server/services/notification-orchestrator.js.map +1 -0
  86. package/dist-server/server/services/vapid-keys.js +26 -0
  87. package/dist-server/server/services/vapid-keys.js.map +1 -0
  88. package/dist-server/server/sessionManager.js +194 -0
  89. package/dist-server/server/sessionManager.js.map +1 -0
  90. package/dist-server/server/utils/colors.js +20 -0
  91. package/dist-server/server/utils/colors.js.map +1 -0
  92. package/dist-server/server/utils/commandParser.js +255 -0
  93. package/dist-server/server/utils/commandParser.js.map +1 -0
  94. package/dist-server/server/utils/frontmatter.js +16 -0
  95. package/dist-server/server/utils/frontmatter.js.map +1 -0
  96. package/dist-server/server/utils/gitConfig.js +36 -0
  97. package/dist-server/server/utils/gitConfig.js.map +1 -0
  98. package/dist-server/server/utils/mcp-detector.js +183 -0
  99. package/dist-server/server/utils/mcp-detector.js.map +1 -0
  100. package/dist-server/server/utils/plugin-loader.js +413 -0
  101. package/dist-server/server/utils/plugin-loader.js.map +1 -0
  102. package/dist-server/server/utils/plugin-process-manager.js +163 -0
  103. package/dist-server/server/utils/plugin-process-manager.js.map +1 -0
  104. package/dist-server/server/utils/runtime-paths.js +30 -0
  105. package/dist-server/server/utils/runtime-paths.js.map +1 -0
  106. package/dist-server/server/utils/taskmaster-websocket.js +118 -0
  107. package/dist-server/server/utils/taskmaster-websocket.js.map +1 -0
  108. package/dist-server/server/utils/url-detection.js +58 -0
  109. package/dist-server/server/utils/url-detection.js.map +1 -0
  110. package/dist-server/shared/modelConstants.js +87 -0
  111. package/dist-server/shared/modelConstants.js.map +1 -0
  112. package/dist-server/shared/networkHosts.js +20 -0
  113. package/dist-server/shared/networkHosts.js.map +1 -0
  114. package/package.json +23 -14
  115. package/server/claude-sdk.js +13 -4
  116. package/server/cli.js +13 -9
  117. package/server/cursor-cli.js +8 -1
  118. package/server/database/db.js +24 -61
  119. package/server/database/schema.js +102 -0
  120. package/server/gemini-cli.js +17 -1
  121. package/server/index.js +20 -96
  122. package/server/load-env.js +11 -6
  123. package/server/openai-codex.js +9 -1
  124. package/server/projects.js +38 -44
  125. package/server/providers/claude/status.js +136 -0
  126. package/server/providers/codex/status.js +78 -0
  127. package/server/providers/cursor/adapter.js +5 -10
  128. package/server/providers/cursor/status.js +128 -0
  129. package/server/providers/gemini/status.js +111 -0
  130. package/server/providers/registry.js +25 -2
  131. package/server/providers/types.js +13 -0
  132. package/server/routes/cli-auth.js +14 -421
  133. package/server/routes/commands.js +6 -4
  134. package/server/routes/cursor.js +6 -240
  135. package/server/tsconfig.json +33 -0
  136. package/server/utils/colors.js +21 -0
  137. package/server/utils/runtime-paths.js +37 -0
  138. package/server/utils/url-detection.js +71 -0
  139. package/shared/modelConstants.js +4 -2
  140. package/server/database/init.sql +0 -99
@@ -0,0 +1,642 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * CloudCLI CLI
4
+ *
5
+ * Provides command-line utilities for managing CloudCLI
6
+ *
7
+ * Commands:
8
+ * (no args) - Start the server (default)
9
+ * start - Start the server
10
+ * sandbox - Manage Docker sandbox environments
11
+ * status - Show configuration and data locations
12
+ * help - Show help information
13
+ * version - Show version information
14
+ */
15
+ import fs from 'fs';
16
+ import path from 'path';
17
+ import os from 'os';
18
+ import { findAppRoot, getModuleDir } from './utils/runtime-paths.js';
19
+ const __dirname = getModuleDir(import.meta.url);
20
+ // The CLI is compiled into dist-server/server, but it still needs to read the top-level
21
+ // package.json and .env file. Resolving the app root once keeps those lookups stable.
22
+ const APP_ROOT = findAppRoot(__dirname);
23
+ // ANSI color codes for terminal output
24
+ const colors = {
25
+ reset: '\x1b[0m',
26
+ bright: '\x1b[1m',
27
+ dim: '\x1b[2m',
28
+ // Foreground colors
29
+ cyan: '\x1b[36m',
30
+ green: '\x1b[32m',
31
+ yellow: '\x1b[33m',
32
+ blue: '\x1b[34m',
33
+ magenta: '\x1b[35m',
34
+ white: '\x1b[37m',
35
+ gray: '\x1b[90m',
36
+ };
37
+ // Helper to colorize text
38
+ const c = {
39
+ info: (text) => `${colors.cyan}${text}${colors.reset}`,
40
+ ok: (text) => `${colors.green}${text}${colors.reset}`,
41
+ warn: (text) => `${colors.yellow}${text}${colors.reset}`,
42
+ error: (text) => `${colors.yellow}${text}${colors.reset}`,
43
+ tip: (text) => `${colors.blue}${text}${colors.reset}`,
44
+ bright: (text) => `${colors.bright}${text}${colors.reset}`,
45
+ dim: (text) => `${colors.dim}${text}${colors.reset}`,
46
+ };
47
+ // Load package.json for version info
48
+ const packageJsonPath = path.join(APP_ROOT, 'package.json');
49
+ const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
50
+ // Match the runtime fallback in load-env.js so "cloudcli status" reports the same default
51
+ // database location that the backend will actually use when no DATABASE_PATH is configured.
52
+ const DEFAULT_DATABASE_PATH = path.join(os.homedir(), '.cloudcli', 'auth.db');
53
+ // Load environment variables from .env file if it exists
54
+ function loadEnvFile() {
55
+ try {
56
+ const envPath = path.join(APP_ROOT, '.env');
57
+ const envFile = fs.readFileSync(envPath, 'utf8');
58
+ envFile.split('\n').forEach(line => {
59
+ const trimmedLine = line.trim();
60
+ if (trimmedLine && !trimmedLine.startsWith('#')) {
61
+ const [key, ...valueParts] = trimmedLine.split('=');
62
+ if (key && valueParts.length > 0 && !process.env[key]) {
63
+ process.env[key] = valueParts.join('=').trim();
64
+ }
65
+ }
66
+ });
67
+ }
68
+ catch (e) {
69
+ // .env file is optional
70
+ }
71
+ }
72
+ // Get the database path (same logic as db.js)
73
+ function getDatabasePath() {
74
+ loadEnvFile();
75
+ return process.env.DATABASE_PATH || DEFAULT_DATABASE_PATH;
76
+ }
77
+ // Get the installation directory
78
+ function getInstallDir() {
79
+ return APP_ROOT;
80
+ }
81
+ // Show status command
82
+ function showStatus() {
83
+ console.log(`\n${c.bright('CloudCLI UI - Status')}\n`);
84
+ console.log(c.dim('═'.repeat(60)));
85
+ // Version info
86
+ console.log(`\n${c.info('[INFO]')} Version: ${c.bright(packageJson.version)}`);
87
+ // Installation location
88
+ const installDir = getInstallDir();
89
+ console.log(`\n${c.info('[INFO]')} Installation Directory:`);
90
+ console.log(` ${c.dim(installDir)}`);
91
+ // Database location
92
+ const dbPath = getDatabasePath();
93
+ const dbExists = fs.existsSync(dbPath);
94
+ console.log(`\n${c.info('[INFO]')} Database Location:`);
95
+ console.log(` ${c.dim(dbPath)}`);
96
+ console.log(` Status: ${dbExists ? c.ok('[OK] Exists') : c.warn('[WARN] Not created yet (will be created on first run)')}`);
97
+ if (dbExists) {
98
+ const stats = fs.statSync(dbPath);
99
+ console.log(` Size: ${c.dim((stats.size / 1024).toFixed(2) + ' KB')}`);
100
+ console.log(` Modified: ${c.dim(stats.mtime.toLocaleString())}`);
101
+ }
102
+ // Environment variables
103
+ console.log(`\n${c.info('[INFO]')} Configuration:`);
104
+ console.log(` SERVER_PORT: ${c.bright(process.env.SERVER_PORT || process.env.PORT || '3001')} ${c.dim(process.env.SERVER_PORT || process.env.PORT ? '' : '(default)')}`);
105
+ console.log(` DATABASE_PATH: ${c.dim(process.env.DATABASE_PATH || '(using default location)')}`);
106
+ console.log(` CLAUDE_CLI_PATH: ${c.dim(process.env.CLAUDE_CLI_PATH || 'claude (default)')}`);
107
+ console.log(` CONTEXT_WINDOW: ${c.dim(process.env.CONTEXT_WINDOW || '160000 (default)')}`);
108
+ // Claude projects folder
109
+ const claudeProjectsPath = path.join(os.homedir(), '.claude', 'projects');
110
+ const projectsExists = fs.existsSync(claudeProjectsPath);
111
+ console.log(`\n${c.info('[INFO]')} Claude Projects Folder:`);
112
+ console.log(` ${c.dim(claudeProjectsPath)}`);
113
+ console.log(` Status: ${projectsExists ? c.ok('[OK] Exists') : c.warn('[WARN] Not found')}`);
114
+ // Config file location
115
+ const envFilePath = path.join(APP_ROOT, '.env');
116
+ const envExists = fs.existsSync(envFilePath);
117
+ console.log(`\n${c.info('[INFO]')} Configuration File:`);
118
+ console.log(` ${c.dim(envFilePath)}`);
119
+ console.log(` Status: ${envExists ? c.ok('[OK] Exists') : c.warn('[WARN] Not found (using defaults)')}`);
120
+ console.log('\n' + c.dim('═'.repeat(60)));
121
+ console.log(`\n${c.tip('[TIP]')} Hints:`);
122
+ console.log(` ${c.dim('>')} Use ${c.bright('cloudcli --port 8080')} to run on a custom port`);
123
+ console.log(` ${c.dim('>')} Use ${c.bright('cloudcli --database-path /path/to/db')} for custom database`);
124
+ console.log(` ${c.dim('>')} Run ${c.bright('cloudcli help')} for all options`);
125
+ console.log(` ${c.dim('>')} Access the UI at http://localhost:${process.env.SERVER_PORT || process.env.PORT || '3001'}\n`);
126
+ }
127
+ // Show help
128
+ function showHelp() {
129
+ console.log(`
130
+ ╔═══════════════════════════════════════════════════════════════╗
131
+ ║ CloudCLI - Command Line Tool ║
132
+ ╚═══════════════════════════════════════════════════════════════╝
133
+
134
+ Usage:
135
+ claude-code-ui [command] [options]
136
+ cloudcli [command] [options]
137
+
138
+ Commands:
139
+ start Start the CloudCLI server (default)
140
+ sandbox Manage Docker sandbox environments
141
+ status Show configuration and data locations
142
+ update Update to the latest version
143
+ help Show this help information
144
+ version Show version information
145
+
146
+ Options:
147
+ -p, --port <port> Set server port (default: 3001)
148
+ --database-path <path> Set custom database location
149
+ -h, --help Show this help information
150
+ -v, --version Show version information
151
+
152
+ Examples:
153
+ $ cloudcli # Start with defaults
154
+ $ cloudcli --port 8080 # Start on port 8080
155
+ $ cloudcli sandbox ~/my-project # Run in a Docker sandbox
156
+ $ cloudcli status # Show configuration
157
+
158
+ Environment Variables:
159
+ SERVER_PORT Set server port (default: 3001)
160
+ PORT Set server port (default: 3001) (LEGACY)
161
+ DATABASE_PATH Set custom database location
162
+ CLAUDE_CLI_PATH Set custom Claude CLI path
163
+ CONTEXT_WINDOW Set context window size (default: 160000)
164
+
165
+ Documentation:
166
+ ${packageJson.homepage || 'https://github.com/siteboon/claudecodeui'}
167
+
168
+ Report Issues:
169
+ ${packageJson.bugs?.url || 'https://github.com/siteboon/claudecodeui/issues'}
170
+ `);
171
+ }
172
+ // Show version
173
+ function showVersion() {
174
+ console.log(`${packageJson.version}`);
175
+ }
176
+ // Compare semver versions, returns true if v1 > v2
177
+ function isNewerVersion(v1, v2) {
178
+ const parts1 = v1.split('.').map(Number);
179
+ const parts2 = v2.split('.').map(Number);
180
+ for (let i = 0; i < 3; i++) {
181
+ if (parts1[i] > parts2[i])
182
+ return true;
183
+ if (parts1[i] < parts2[i])
184
+ return false;
185
+ }
186
+ return false;
187
+ }
188
+ // Check for updates
189
+ async function checkForUpdates(silent = false) {
190
+ try {
191
+ const { execSync } = await import('child_process');
192
+ const latestVersion = execSync('npm show @cloudcli-ai/cloudcli version', { encoding: 'utf8' }).trim();
193
+ const currentVersion = packageJson.version;
194
+ if (isNewerVersion(latestVersion, currentVersion)) {
195
+ console.log(`\n${c.warn('[UPDATE]')} New version available: ${c.bright(latestVersion)} (current: ${currentVersion})`);
196
+ console.log(` Run ${c.bright('cloudcli update')} to update\n`);
197
+ return { hasUpdate: true, latestVersion, currentVersion };
198
+ }
199
+ else if (!silent) {
200
+ console.log(`${c.ok('[OK]')} You are on the latest version (${currentVersion})`);
201
+ }
202
+ return { hasUpdate: false, latestVersion, currentVersion };
203
+ }
204
+ catch (e) {
205
+ if (!silent) {
206
+ console.log(`${c.warn('[WARN]')} Could not check for updates`);
207
+ }
208
+ return { hasUpdate: false, error: e.message };
209
+ }
210
+ }
211
+ // Update the package
212
+ async function updatePackage() {
213
+ try {
214
+ const { execSync } = await import('child_process');
215
+ console.log(`${c.info('[INFO]')} Checking for updates...`);
216
+ const { hasUpdate, latestVersion, currentVersion } = await checkForUpdates(true);
217
+ if (!hasUpdate) {
218
+ console.log(`${c.ok('[OK]')} Already on the latest version (${currentVersion})`);
219
+ return;
220
+ }
221
+ console.log(`${c.info('[INFO]')} Updating from ${currentVersion} to ${latestVersion}...`);
222
+ execSync('npm update -g @cloudcli-ai/cloudcli', { stdio: 'inherit' });
223
+ console.log(`${c.ok('[OK]')} Update complete! Restart cloudcli to use the new version.`);
224
+ }
225
+ catch (e) {
226
+ console.error(`${c.error('[ERROR]')} Update failed: ${e.message}`);
227
+ console.log(`${c.tip('[TIP]')} Try running manually: npm update -g @cloudcli-ai/cloudcli`);
228
+ }
229
+ }
230
+ // ── Sandbox command ─────────────────────────────────────────
231
+ const SANDBOX_TEMPLATES = {
232
+ claude: 'docker.io/cloudcliai/sandbox:claude-code',
233
+ codex: 'docker.io/cloudcliai/sandbox:codex',
234
+ gemini: 'docker.io/cloudcliai/sandbox:gemini',
235
+ };
236
+ const SANDBOX_SECRETS = {
237
+ claude: 'anthropic',
238
+ codex: 'openai',
239
+ gemini: 'google',
240
+ };
241
+ function parseSandboxArgs(args) {
242
+ const result = {
243
+ subcommand: null,
244
+ workspace: null,
245
+ agent: 'claude',
246
+ name: null,
247
+ port: 3001,
248
+ template: null,
249
+ env: [],
250
+ };
251
+ const subcommands = ['ls', 'stop', 'start', 'rm', 'logs', 'help'];
252
+ for (let i = 0; i < args.length; i++) {
253
+ const arg = args[i];
254
+ if (i === 0 && subcommands.includes(arg)) {
255
+ result.subcommand = arg;
256
+ }
257
+ else if (arg === '--agent' || arg === '-a') {
258
+ result.agent = args[++i];
259
+ }
260
+ else if (arg === '--name' || arg === '-n') {
261
+ result.name = args[++i];
262
+ }
263
+ else if (arg === '--port') {
264
+ result.port = parseInt(args[++i], 10);
265
+ }
266
+ else if (arg === '--template' || arg === '-t') {
267
+ result.template = args[++i];
268
+ }
269
+ else if (arg === '--env' || arg === '-e') {
270
+ result.env.push(args[++i]);
271
+ }
272
+ else if (!arg.startsWith('-')) {
273
+ if (!result.subcommand) {
274
+ result.workspace = arg;
275
+ }
276
+ else {
277
+ result.name = arg; // for stop/start/rm/logs <name>
278
+ }
279
+ }
280
+ }
281
+ // Default subcommand based on what we got
282
+ if (!result.subcommand) {
283
+ result.subcommand = 'create';
284
+ }
285
+ // Derive name from workspace path if not set
286
+ if (!result.name && result.workspace) {
287
+ result.name = path.basename(path.resolve(result.workspace.replace(/^~/, os.homedir())));
288
+ }
289
+ // Default template from agent
290
+ if (!result.template) {
291
+ result.template = SANDBOX_TEMPLATES[result.agent] || SANDBOX_TEMPLATES.claude;
292
+ }
293
+ return result;
294
+ }
295
+ function showSandboxHelp() {
296
+ console.log(`
297
+ ${c.bright('CloudCLI Sandbox')} — Run CloudCLI inside Docker Sandboxes
298
+
299
+ Usage:
300
+ cloudcli sandbox <workspace> Create and start a sandbox
301
+ cloudcli sandbox <subcommand> [name] Manage sandboxes
302
+
303
+ Subcommands:
304
+ ${c.bright('(default)')} Create a sandbox and start the web UI
305
+ ${c.bright('ls')} List all sandboxes
306
+ ${c.bright('start')} Restart a stopped sandbox and re-launch the web UI
307
+ ${c.bright('stop')} Stop a sandbox (preserves state)
308
+ ${c.bright('rm')} Remove a sandbox
309
+ ${c.bright('logs')} Show CloudCLI server logs
310
+ ${c.bright('help')} Show this help
311
+
312
+ Options:
313
+ -a, --agent <agent> Agent to use: claude, codex, gemini (default: claude)
314
+ -n, --name <name> Sandbox name (default: derived from workspace folder)
315
+ -t, --template <image> Custom template image
316
+ -e, --env <KEY=VALUE> Set environment variable (repeatable)
317
+ --port <port> Host port for the web UI (default: 3001)
318
+
319
+ Examples:
320
+ $ cloudcli sandbox ~/my-project
321
+ $ cloudcli sandbox ~/my-project --agent codex --port 8080
322
+ $ cloudcli sandbox ~/my-project --env SERVER_PORT=8080 --env HOST=0.0.0.0
323
+ $ cloudcli sandbox ls
324
+ $ cloudcli sandbox stop my-project
325
+ $ cloudcli sandbox start my-project
326
+ $ cloudcli sandbox rm my-project
327
+
328
+ Prerequisites:
329
+ 1. Install sbx CLI: https://docs.docker.com/ai/sandboxes/get-started/
330
+ 2. Authenticate and store your API key:
331
+ sbx login
332
+ sbx secret set -g anthropic # for Claude
333
+ sbx secret set -g openai # for Codex
334
+ sbx secret set -g google # for Gemini
335
+
336
+ Advanced usage:
337
+ For branch mode, multiple workspaces, memory limits, network policies,
338
+ or passing prompts to the agent, use sbx directly with the template:
339
+
340
+ sbx run --template docker.io/cloudcliai/sandbox:claude-code claude ~/my-project --branch my-feature
341
+ sbx run --template docker.io/cloudcliai/sandbox:claude-code claude ~/project ~/libs:ro --memory 8g
342
+
343
+ Full Docker Sandboxes docs: https://docs.docker.com/ai/sandboxes/usage/
344
+ `);
345
+ }
346
+ async function sandboxCommand(args) {
347
+ const { execFileSync, spawn: spawnProcess } = await import('child_process');
348
+ // Safe execution — uses execFileSync (no shell) to prevent injection
349
+ const sbx = (subcmd, opts = {}) => {
350
+ const result = execFileSync('sbx', subcmd, {
351
+ encoding: 'utf8',
352
+ stdio: opts.inherit ? 'inherit' : 'pipe',
353
+ });
354
+ return result || '';
355
+ };
356
+ const opts = parseSandboxArgs(args);
357
+ if (opts.subcommand === 'help') {
358
+ showSandboxHelp();
359
+ return;
360
+ }
361
+ // Validate name (alphanumeric, hyphens, underscores only)
362
+ if (opts.name && !/^[\w-]+$/.test(opts.name)) {
363
+ console.error(`\n${c.error('❌')} Invalid sandbox name: ${opts.name}`);
364
+ console.log(` Names may only contain letters, numbers, hyphens, and underscores.\n`);
365
+ process.exit(1);
366
+ }
367
+ // Check sbx is installed
368
+ try {
369
+ sbx(['version']);
370
+ }
371
+ catch {
372
+ console.error(`\n${c.error('❌')} ${c.bright('sbx')} CLI not found.\n`);
373
+ console.log(` Install it from: ${c.info('https://docs.docker.com/ai/sandboxes/get-started/')}`);
374
+ console.log(` Then run: ${c.bright('sbx login')}`);
375
+ console.log(` And store your API key: ${c.bright('sbx secret set -g anthropic')}\n`);
376
+ process.exit(1);
377
+ }
378
+ switch (opts.subcommand) {
379
+ case 'ls':
380
+ sbx(['ls'], { inherit: true });
381
+ break;
382
+ case 'stop':
383
+ if (!opts.name) {
384
+ console.error(`\n${c.error('❌')} Sandbox name required: cloudcli sandbox stop <name>\n`);
385
+ process.exit(1);
386
+ }
387
+ sbx(['stop', opts.name], { inherit: true });
388
+ break;
389
+ case 'rm':
390
+ if (!opts.name) {
391
+ console.error(`\n${c.error('❌')} Sandbox name required: cloudcli sandbox rm <name>\n`);
392
+ process.exit(1);
393
+ }
394
+ sbx(['rm', opts.name], { inherit: true });
395
+ break;
396
+ case 'logs':
397
+ if (!opts.name) {
398
+ console.error(`\n${c.error('❌')} Sandbox name required: cloudcli sandbox logs <name>\n`);
399
+ process.exit(1);
400
+ }
401
+ try {
402
+ sbx(['exec', opts.name, 'bash', '-c', 'cat /tmp/cloudcli-ui.log'], { inherit: true });
403
+ }
404
+ catch (e) {
405
+ console.error(`\n${c.error('❌')} Could not read logs: ${e.message || 'Is the sandbox running?'}\n`);
406
+ }
407
+ break;
408
+ case 'start': {
409
+ if (!opts.name) {
410
+ console.error(`\n${c.error('❌')} Sandbox name required: cloudcli sandbox start <name>\n`);
411
+ process.exit(1);
412
+ }
413
+ console.log(`\n${c.info('▶')} Starting sandbox ${c.bright(opts.name)}...`);
414
+ const restartRun = spawnProcess('sbx', ['run', opts.name], {
415
+ detached: true,
416
+ stdio: ['ignore', 'ignore', 'ignore'],
417
+ });
418
+ restartRun.unref();
419
+ await new Promise(resolve => setTimeout(resolve, 5000));
420
+ console.log(`${c.info('▶')} Launching CloudCLI web server...`);
421
+ sbx(['exec', opts.name, 'bash', '-c', 'cloudcli start --port 3001 &']);
422
+ console.log(`${c.info('▶')} Forwarding port ${opts.port} → 3001...`);
423
+ try {
424
+ sbx(['ports', opts.name, '--publish', `${opts.port}:3001`]);
425
+ }
426
+ catch (e) {
427
+ const msg = e.stdout || e.stderr || e.message || '';
428
+ if (msg.includes('address already in use')) {
429
+ const altPort = opts.port + 1;
430
+ console.log(`${c.warn('⚠')} Port ${opts.port} in use, trying ${altPort}...`);
431
+ try {
432
+ sbx(['ports', opts.name, '--publish', `${altPort}:3001`]);
433
+ opts.port = altPort;
434
+ }
435
+ catch {
436
+ console.error(`${c.error('❌')} Ports ${opts.port} and ${altPort} both in use. Use --port to specify a free port.`);
437
+ process.exit(1);
438
+ }
439
+ }
440
+ else {
441
+ throw e;
442
+ }
443
+ }
444
+ console.log(`\n${c.ok('✔')} ${c.bright('CloudCLI is ready!')}`);
445
+ console.log(` ${c.info('→')} ${c.bright(`http://localhost:${opts.port}`)}\n`);
446
+ break;
447
+ }
448
+ case 'create': {
449
+ if (!opts.workspace) {
450
+ console.error(`\n${c.error('❌')} Workspace path required: cloudcli sandbox <path>\n`);
451
+ console.log(` Example: ${c.bright('cloudcli sandbox ~/my-project')}\n`);
452
+ process.exit(1);
453
+ }
454
+ const workspace = opts.workspace.startsWith('~')
455
+ ? opts.workspace.replace(/^~/, os.homedir())
456
+ : path.resolve(opts.workspace);
457
+ if (!fs.existsSync(workspace)) {
458
+ console.error(`\n${c.error('❌')} Workspace path not found: ${c.dim(workspace)}\n`);
459
+ process.exit(1);
460
+ }
461
+ const secret = SANDBOX_SECRETS[opts.agent] || 'anthropic';
462
+ // Check if the required secret is stored
463
+ try {
464
+ const secretList = sbx(['secret', 'ls']);
465
+ if (!secretList.includes(secret)) {
466
+ console.error(`\n${c.error('❌')} No ${c.bright(secret)} API key found.\n`);
467
+ console.log(` Run: ${c.bright(`sbx secret set -g ${secret}`)}\n`);
468
+ process.exit(1);
469
+ }
470
+ }
471
+ catch { /* sbx secret ls not available, skip check */ }
472
+ console.log(`\n${c.bright('CloudCLI Sandbox')}`);
473
+ console.log(c.dim('─'.repeat(50)));
474
+ console.log(` Agent: ${c.info(opts.agent)} ${c.dim(`(${secret} credentials)`)}`);
475
+ console.log(` Workspace: ${c.dim(workspace)}`);
476
+ console.log(` Name: ${c.dim(opts.name)}`);
477
+ console.log(` Template: ${c.dim(opts.template)}`);
478
+ console.log(` Port: ${c.dim(String(opts.port))}`);
479
+ if (opts.env.length > 0) {
480
+ console.log(` Env: ${c.dim(opts.env.join(', '))}`);
481
+ }
482
+ console.log(c.dim('─'.repeat(50)));
483
+ // Step 1: Launch sandbox with sbx run in background.
484
+ // sbx run creates the sandbox (or reconnects) AND holds an active session,
485
+ // which prevents the sandbox from auto-stopping.
486
+ console.log(`\n${c.info('▶')} Creating sandbox ${c.bright(opts.name)}...`);
487
+ const bgRun = spawnProcess('sbx', [
488
+ 'run', '--template', opts.template, '--name', opts.name, opts.agent, workspace,
489
+ ], {
490
+ detached: true,
491
+ stdio: ['ignore', 'ignore', 'ignore'],
492
+ });
493
+ bgRun.unref();
494
+ // Wait for sandbox to be ready
495
+ await new Promise(resolve => setTimeout(resolve, 5000));
496
+ // Step 2: Inject environment variables
497
+ if (opts.env.length > 0) {
498
+ console.log(`${c.info('▶')} Setting environment variables...`);
499
+ const exports = opts.env
500
+ .filter(e => /^\w+=.+$/.test(e))
501
+ .map(e => `export ${e}`)
502
+ .join('\n');
503
+ if (exports) {
504
+ sbx(['exec', opts.name, 'bash', '-c', `echo '${exports}' >> /etc/sandbox-persistent.sh`]);
505
+ }
506
+ const invalid = opts.env.filter(e => !/^\w+=.+$/.test(e));
507
+ if (invalid.length > 0) {
508
+ console.log(`${c.warn('⚠')} Skipped invalid env vars: ${invalid.join(', ')} (expected KEY=VALUE)`);
509
+ }
510
+ }
511
+ // Step 3: Start CloudCLI inside the sandbox
512
+ console.log(`${c.info('▶')} Launching CloudCLI web server...`);
513
+ sbx(['exec', opts.name, 'bash', '-c', 'cloudcli start --port 3001 &']);
514
+ // Step 4: Forward port
515
+ console.log(`${c.info('▶')} Forwarding port ${opts.port} → 3001...`);
516
+ try {
517
+ sbx(['ports', opts.name, '--publish', `${opts.port}:3001`]);
518
+ }
519
+ catch (e) {
520
+ const msg = e.stdout || e.stderr || e.message || '';
521
+ if (msg.includes('address already in use')) {
522
+ const altPort = opts.port + 1;
523
+ console.log(`${c.warn('⚠')} Port ${opts.port} in use, trying ${altPort}...`);
524
+ try {
525
+ sbx(['ports', opts.name, '--publish', `${altPort}:3001`]);
526
+ opts.port = altPort;
527
+ }
528
+ catch {
529
+ console.error(`${c.error('❌')} Ports ${opts.port} and ${altPort} both in use. Use --port to specify a free port.`);
530
+ process.exit(1);
531
+ }
532
+ }
533
+ else {
534
+ throw e;
535
+ }
536
+ }
537
+ // Done
538
+ console.log(`\n${c.ok('✔')} ${c.bright('CloudCLI is ready!')}`);
539
+ console.log(` ${c.info('→')} Open ${c.bright(`http://localhost:${opts.port}`)}`);
540
+ console.log(`\n${c.dim(' Manage with:')}`);
541
+ console.log(` ${c.dim('$')} sbx ls`);
542
+ console.log(` ${c.dim('$')} sbx stop ${opts.name}`);
543
+ console.log(` ${c.dim('$')} sbx start ${opts.name}`);
544
+ console.log(` ${c.dim('$')} sbx rm ${opts.name}`);
545
+ console.log(`\n${c.dim(' Or install globally:')} npm install -g @cloudcli-ai/cloudcli\n`);
546
+ break;
547
+ }
548
+ default:
549
+ showSandboxHelp();
550
+ }
551
+ }
552
+ // ── Server ──────────────────────────────────────────────────
553
+ // Start the server
554
+ async function startServer() {
555
+ // Check for updates silently on startup
556
+ checkForUpdates(true);
557
+ // Import and run the server
558
+ await import('./index.js');
559
+ }
560
+ // Parse CLI arguments
561
+ function parseArgs(args) {
562
+ const parsed = { command: 'start', options: {} };
563
+ for (let i = 0; i < args.length; i++) {
564
+ const arg = args[i];
565
+ if (arg === '--port' || arg === '-p') {
566
+ parsed.options.serverPort = args[++i];
567
+ }
568
+ else if (arg.startsWith('--port=')) {
569
+ parsed.options.serverPort = arg.split('=')[1];
570
+ }
571
+ else if (arg === '--database-path') {
572
+ parsed.options.databasePath = args[++i];
573
+ }
574
+ else if (arg.startsWith('--database-path=')) {
575
+ parsed.options.databasePath = arg.split('=')[1];
576
+ }
577
+ else if (arg === '--help' || arg === '-h') {
578
+ parsed.command = 'help';
579
+ }
580
+ else if (arg === '--version' || arg === '-v') {
581
+ parsed.command = 'version';
582
+ }
583
+ else if (!arg.startsWith('-')) {
584
+ parsed.command = arg;
585
+ if (arg === 'sandbox') {
586
+ parsed.remainingArgs = args.slice(i + 1);
587
+ break;
588
+ }
589
+ }
590
+ }
591
+ return parsed;
592
+ }
593
+ // Main CLI handler
594
+ async function main() {
595
+ const args = process.argv.slice(2);
596
+ const { command, options, remainingArgs } = parseArgs(args);
597
+ // Apply CLI options to environment variables
598
+ if (options.serverPort) {
599
+ process.env.SERVER_PORT = options.serverPort;
600
+ }
601
+ else if (!process.env.SERVER_PORT && process.env.PORT) {
602
+ process.env.SERVER_PORT = process.env.PORT;
603
+ }
604
+ if (options.databasePath) {
605
+ process.env.DATABASE_PATH = options.databasePath;
606
+ }
607
+ switch (command) {
608
+ case 'start':
609
+ await startServer();
610
+ break;
611
+ case 'sandbox':
612
+ await sandboxCommand(remainingArgs || []);
613
+ break;
614
+ case 'status':
615
+ case 'info':
616
+ showStatus();
617
+ break;
618
+ case 'help':
619
+ case '-h':
620
+ case '--help':
621
+ showHelp();
622
+ break;
623
+ case 'version':
624
+ case '-v':
625
+ case '--version':
626
+ showVersion();
627
+ break;
628
+ case 'update':
629
+ await updatePackage();
630
+ break;
631
+ default:
632
+ console.error(`\n❌ Unknown command: ${command}`);
633
+ console.log(' Run "cloudcli help" for usage information.\n');
634
+ process.exit(1);
635
+ }
636
+ }
637
+ // Run the CLI
638
+ main().catch(error => {
639
+ console.error('\n❌ Error:', error.message);
640
+ process.exit(1);
641
+ });
642
+ //# sourceMappingURL=cli.js.map