@pixelbyte-software/pixcode 1.35.2 → 1.35.3

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 (173) hide show
  1. package/LICENSE +718 -718
  2. package/README.de.md +248 -248
  3. package/README.ja.md +240 -240
  4. package/README.ko.md +240 -240
  5. package/README.md +303 -303
  6. package/README.ru.md +248 -248
  7. package/README.tr.md +250 -250
  8. package/README.zh-CN.md +240 -240
  9. package/dist/api-docs.html +548 -548
  10. package/dist/assets/{index-D1-AIL_5.js → index-D8z78r_D.js} +57 -57
  11. package/dist/assets/{index-B8w57E1r.css → index-DmchzORZ.css} +1 -1
  12. package/dist/clear-cache.html +85 -85
  13. package/dist/convert-icons.md +52 -52
  14. package/dist/favicon.svg +8 -8
  15. package/dist/generate-icons.js +48 -48
  16. package/dist/icons/codex-white.svg +3 -3
  17. package/dist/icons/codex.svg +3 -3
  18. package/dist/icons/cursor-white.svg +11 -11
  19. package/dist/icons/icon-128x128.svg +9 -9
  20. package/dist/icons/icon-144x144.svg +9 -9
  21. package/dist/icons/icon-152x152.svg +9 -9
  22. package/dist/icons/icon-192x192.svg +9 -9
  23. package/dist/icons/icon-384x384.svg +9 -9
  24. package/dist/icons/icon-512x512.svg +9 -9
  25. package/dist/icons/icon-72x72.svg +9 -9
  26. package/dist/icons/icon-96x96.svg +9 -9
  27. package/dist/icons/icon-template.svg +9 -9
  28. package/dist/icons/qwen-logo.svg +14 -14
  29. package/dist/index.html +59 -59
  30. package/dist/logo.svg +12 -12
  31. package/dist/manifest.json +60 -60
  32. package/dist/openapi.yaml +1693 -1693
  33. package/dist/sw.js +124 -124
  34. package/dist-server/server/cli.js +96 -96
  35. package/dist-server/server/daemon/manager.js +33 -33
  36. package/dist-server/server/daemon-manager.js +64 -64
  37. package/dist-server/server/routes/commands.js +25 -25
  38. package/dist-server/server/routes/git.js +17 -17
  39. package/dist-server/server/routes/taskmaster.js +419 -419
  40. package/package.json +180 -180
  41. package/scripts/fix-node-pty.js +67 -67
  42. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  43. package/scripts/smoke/orchestration-api.mjs +172 -172
  44. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  45. package/server/claude-sdk.js +898 -898
  46. package/server/cli.js +935 -935
  47. package/server/constants/config.js +4 -4
  48. package/server/cursor-cli.js +342 -342
  49. package/server/daemon/manager.js +564 -564
  50. package/server/daemon-manager.js +959 -959
  51. package/server/database/db.js +794 -794
  52. package/server/database/json-store.js +197 -197
  53. package/server/gemini-cli.js +535 -535
  54. package/server/gemini-response-handler.js +79 -79
  55. package/server/index.js +3135 -3135
  56. package/server/load-env.js +34 -34
  57. package/server/middleware/auth.js +173 -173
  58. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  59. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  60. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  61. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  62. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  63. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  64. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  65. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  66. package/server/modules/orchestration/a2a/routes.ts +577 -577
  67. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  68. package/server/modules/orchestration/a2a/types.ts +125 -125
  69. package/server/modules/orchestration/a2a/validator.ts +113 -113
  70. package/server/modules/orchestration/index.ts +66 -66
  71. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  72. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  73. package/server/modules/orchestration/preview/types.ts +19 -19
  74. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  75. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  76. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  77. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  78. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  79. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  80. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  81. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  82. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  83. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  84. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  85. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  86. package/server/modules/orchestration/workspace/types.ts +52 -52
  87. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  88. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  89. package/server/modules/providers/index.ts +2 -2
  90. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  91. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  92. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  93. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  94. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  95. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  96. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  97. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  98. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  99. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  100. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  101. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  102. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  103. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  104. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  105. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  106. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +130 -130
  107. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  108. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  109. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  110. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +145 -145
  111. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  112. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  113. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  114. package/server/modules/providers/provider.registry.ts +40 -40
  115. package/server/modules/providers/provider.routes.ts +819 -819
  116. package/server/modules/providers/services/mcp.service.ts +86 -86
  117. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  118. package/server/modules/providers/services/sessions.service.ts +45 -45
  119. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  120. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  121. package/server/modules/providers/shared/provider-configs.ts +142 -142
  122. package/server/modules/providers/tests/mcp.test.ts +293 -293
  123. package/server/openai-codex.js +462 -462
  124. package/server/opencode-cli.js +459 -459
  125. package/server/opencode-response-handler.js +107 -107
  126. package/server/projects.js +3105 -3105
  127. package/server/qwen-code-cli.js +395 -395
  128. package/server/qwen-response-handler.js +73 -73
  129. package/server/routes/agent.js +1365 -1365
  130. package/server/routes/auth.js +138 -138
  131. package/server/routes/codex.js +19 -19
  132. package/server/routes/commands.js +554 -554
  133. package/server/routes/cursor.js +52 -52
  134. package/server/routes/gemini.js +24 -24
  135. package/server/routes/git.js +1488 -1488
  136. package/server/routes/mcp-utils.js +31 -31
  137. package/server/routes/messages.js +61 -61
  138. package/server/routes/network.js +120 -120
  139. package/server/routes/plugins.js +318 -318
  140. package/server/routes/projects.js +915 -915
  141. package/server/routes/qwen.js +27 -27
  142. package/server/routes/settings.js +286 -286
  143. package/server/routes/taskmaster.js +1496 -1496
  144. package/server/routes/telegram.js +125 -125
  145. package/server/routes/user.js +123 -123
  146. package/server/services/external-access.js +171 -171
  147. package/server/services/install-jobs.js +571 -571
  148. package/server/services/notification-orchestrator.js +242 -242
  149. package/server/services/provider-credentials.js +189 -189
  150. package/server/services/provider-models.js +381 -381
  151. package/server/services/telegram/bot.js +279 -279
  152. package/server/services/telegram/telegram-http-client.js +130 -130
  153. package/server/services/telegram/translations.js +170 -170
  154. package/server/services/vapid-keys.js +36 -36
  155. package/server/sessionManager.js +225 -225
  156. package/server/shared/interfaces.ts +54 -54
  157. package/server/shared/types.ts +172 -172
  158. package/server/shared/utils.ts +193 -193
  159. package/server/tsconfig.json +36 -36
  160. package/server/utils/colors.js +21 -21
  161. package/server/utils/commandParser.js +303 -303
  162. package/server/utils/frontmatter.js +18 -18
  163. package/server/utils/gitConfig.js +34 -34
  164. package/server/utils/mcp-detector.js +147 -147
  165. package/server/utils/plugin-loader.js +457 -457
  166. package/server/utils/plugin-process-manager.js +184 -184
  167. package/server/utils/port-access.js +209 -209
  168. package/server/utils/runtime-paths.js +37 -37
  169. package/server/utils/taskmaster-websocket.js +128 -128
  170. package/server/utils/url-detection.js +71 -71
  171. package/server/vite-daemon.js +78 -78
  172. package/shared/modelConstants.js +162 -162
  173. package/shared/networkHosts.js +22 -22
package/dist/sw.js CHANGED
@@ -1,124 +1,124 @@
1
- // Service Worker for Pixcode PWA
2
- // Cache only manifest (needed for PWA install). HTML and JS are never pre-cached
3
- // so a rebuild + refresh always picks up the latest assets.
4
- const CACHE_NAME = 'pixcode-v3';
5
- const urlsToCache = [
6
- '/manifest.json'
7
- ];
8
-
9
- // Install event
10
- self.addEventListener('install', event => {
11
- event.waitUntil(
12
- caches.open(CACHE_NAME)
13
- .then(cache => cache.addAll(urlsToCache))
14
- );
15
- self.skipWaiting();
16
- });
17
-
18
- // Fetch event — network-first for everything except hashed assets
19
- self.addEventListener('fetch', event => {
20
- const url = event.request.url;
21
-
22
- // Never intercept API requests or WebSocket upgrades
23
- if (url.includes('/api/') || url.includes('/ws')) {
24
- return;
25
- }
26
-
27
- // Navigation requests (HTML) — always go to network, no caching
28
- if (event.request.mode === 'navigate') {
29
- event.respondWith(
30
- fetch(event.request).catch(() => caches.match('/manifest.json').then(() =>
31
- new Response('<h1>Offline</h1><p>Please check your connection.</p>', {
32
- headers: { 'Content-Type': 'text/html' }
33
- })
34
- ))
35
- );
36
- return;
37
- }
38
-
39
- // Hashed assets (JS/CSS in /assets/) — cache-first since filenames change per build
40
- if (url.includes('/assets/')) {
41
- event.respondWith(
42
- caches.match(event.request).then(cached => {
43
- if (cached) return cached;
44
- return fetch(event.request).then(response => {
45
- const clone = response.clone();
46
- caches.open(CACHE_NAME).then(cache => cache.put(event.request, clone));
47
- return response;
48
- });
49
- })
50
- );
51
- return;
52
- }
53
-
54
- // Everything else — network-first
55
- event.respondWith(
56
- fetch(event.request).catch(() => caches.match(event.request))
57
- );
58
- });
59
-
60
- // Activate event — purge old caches
61
- self.addEventListener('activate', event => {
62
- event.waitUntil(
63
- caches.keys().then(cacheNames =>
64
- Promise.all(
65
- cacheNames
66
- .filter(name => name !== CACHE_NAME)
67
- .map(name => caches.delete(name))
68
- )
69
- )
70
- );
71
- self.clients.claim();
72
- });
73
-
74
- // Push notification event
75
- self.addEventListener('push', event => {
76
- if (!event.data) return;
77
-
78
- let payload;
79
- try {
80
- payload = event.data.json();
81
- } catch {
82
- payload = { title: 'Pixcode', body: event.data.text() };
83
- }
84
-
85
- const options = {
86
- body: payload.body || '',
87
- icon: '/logo-256.png',
88
- badge: '/logo-128.png',
89
- data: payload.data || {},
90
- tag: payload.data?.tag || `${payload.data?.sessionId || 'global'}:${payload.data?.code || 'default'}`,
91
- renotify: true
92
- };
93
-
94
- event.waitUntil(
95
- self.registration.showNotification(payload.title || 'Pixcode', options)
96
- );
97
- });
98
-
99
- // Notification click event
100
- self.addEventListener('notificationclick', event => {
101
- event.notification.close();
102
-
103
- const sessionId = event.notification.data?.sessionId;
104
- const provider = event.notification.data?.provider || null;
105
- const urlPath = sessionId ? `/session/${sessionId}` : '/';
106
-
107
- event.waitUntil(
108
- self.clients.matchAll({ type: 'window', includeUncontrolled: true }).then(async clientList => {
109
- for (const client of clientList) {
110
- if (client.url.includes(self.location.origin)) {
111
- await client.focus();
112
- client.postMessage({
113
- type: 'notification:navigate',
114
- sessionId: sessionId || null,
115
- provider,
116
- urlPath
117
- });
118
- return;
119
- }
120
- }
121
- return self.clients.openWindow(urlPath);
122
- })
123
- );
124
- });
1
+ // Service Worker for Pixcode PWA
2
+ // Cache only manifest (needed for PWA install). HTML and JS are never pre-cached
3
+ // so a rebuild + refresh always picks up the latest assets.
4
+ const CACHE_NAME = 'pixcode-v3';
5
+ const urlsToCache = [
6
+ '/manifest.json'
7
+ ];
8
+
9
+ // Install event
10
+ self.addEventListener('install', event => {
11
+ event.waitUntil(
12
+ caches.open(CACHE_NAME)
13
+ .then(cache => cache.addAll(urlsToCache))
14
+ );
15
+ self.skipWaiting();
16
+ });
17
+
18
+ // Fetch event — network-first for everything except hashed assets
19
+ self.addEventListener('fetch', event => {
20
+ const url = event.request.url;
21
+
22
+ // Never intercept API requests or WebSocket upgrades
23
+ if (url.includes('/api/') || url.includes('/ws')) {
24
+ return;
25
+ }
26
+
27
+ // Navigation requests (HTML) — always go to network, no caching
28
+ if (event.request.mode === 'navigate') {
29
+ event.respondWith(
30
+ fetch(event.request).catch(() => caches.match('/manifest.json').then(() =>
31
+ new Response('<h1>Offline</h1><p>Please check your connection.</p>', {
32
+ headers: { 'Content-Type': 'text/html' }
33
+ })
34
+ ))
35
+ );
36
+ return;
37
+ }
38
+
39
+ // Hashed assets (JS/CSS in /assets/) — cache-first since filenames change per build
40
+ if (url.includes('/assets/')) {
41
+ event.respondWith(
42
+ caches.match(event.request).then(cached => {
43
+ if (cached) return cached;
44
+ return fetch(event.request).then(response => {
45
+ const clone = response.clone();
46
+ caches.open(CACHE_NAME).then(cache => cache.put(event.request, clone));
47
+ return response;
48
+ });
49
+ })
50
+ );
51
+ return;
52
+ }
53
+
54
+ // Everything else — network-first
55
+ event.respondWith(
56
+ fetch(event.request).catch(() => caches.match(event.request))
57
+ );
58
+ });
59
+
60
+ // Activate event — purge old caches
61
+ self.addEventListener('activate', event => {
62
+ event.waitUntil(
63
+ caches.keys().then(cacheNames =>
64
+ Promise.all(
65
+ cacheNames
66
+ .filter(name => name !== CACHE_NAME)
67
+ .map(name => caches.delete(name))
68
+ )
69
+ )
70
+ );
71
+ self.clients.claim();
72
+ });
73
+
74
+ // Push notification event
75
+ self.addEventListener('push', event => {
76
+ if (!event.data) return;
77
+
78
+ let payload;
79
+ try {
80
+ payload = event.data.json();
81
+ } catch {
82
+ payload = { title: 'Pixcode', body: event.data.text() };
83
+ }
84
+
85
+ const options = {
86
+ body: payload.body || '',
87
+ icon: '/logo-256.png',
88
+ badge: '/logo-128.png',
89
+ data: payload.data || {},
90
+ tag: payload.data?.tag || `${payload.data?.sessionId || 'global'}:${payload.data?.code || 'default'}`,
91
+ renotify: true
92
+ };
93
+
94
+ event.waitUntil(
95
+ self.registration.showNotification(payload.title || 'Pixcode', options)
96
+ );
97
+ });
98
+
99
+ // Notification click event
100
+ self.addEventListener('notificationclick', event => {
101
+ event.notification.close();
102
+
103
+ const sessionId = event.notification.data?.sessionId;
104
+ const provider = event.notification.data?.provider || null;
105
+ const urlPath = sessionId ? `/session/${sessionId}` : '/';
106
+
107
+ event.waitUntil(
108
+ self.clients.matchAll({ type: 'window', includeUncontrolled: true }).then(async clientList => {
109
+ for (const client of clientList) {
110
+ if (client.url.includes(self.location.origin)) {
111
+ await client.focus();
112
+ client.postMessage({
113
+ type: 'notification:navigate',
114
+ sessionId: sessionId || null,
115
+ provider,
116
+ urlPath
117
+ });
118
+ return;
119
+ }
120
+ }
121
+ return self.clients.openWindow(urlPath);
122
+ })
123
+ );
124
+ });
@@ -137,54 +137,54 @@ function showStatus() {
137
137
  }
138
138
  // Show help
139
139
  function showHelp() {
140
- console.log(`
141
- ╔═══════════════════════════════════════════════════════════════╗
142
- ║ Pixcode - Command Line Tool ║
143
- ╚═══════════════════════════════════════════════════════════════╝
144
-
145
- Usage:
146
- pixcode [command] [options]
147
-
148
- Commands:
149
- start Start the Pixcode server (default)
150
- daemon Manage persistent Linux service (system-first)
151
- sandbox Manage Docker sandbox environments
152
- status Show configuration and data locations
153
- update Update to the latest version
154
- help Show this help information
155
- version Show version information
156
-
157
- Options:
158
- -p, --port <port> Set server port (default: 3001)
159
- --database-path <path> Set custom database location
160
- --no-daemon Disable automatic daemon startup on Linux
161
- --restart-daemon Restart daemon automatically after update
162
- -h, --help Show this help information
163
- -v, --version Show version information
164
-
165
- Examples:
166
- $ pixcode # Start with defaults
167
- $ pixcode --port 8080 # Start on port 8080
168
- $ pixcode --no-daemon # Force foreground mode
169
- $ sudo pixcode daemon install --mode system --port 3001
170
- $ pixcode daemon install --mode user --port 3001 --single-port
171
- $ pixcode daemon doctor --mode system
172
- $ pixcode update --restart-daemon
173
- $ pixcode sandbox ~/my-project # Run in a Docker sandbox
174
- $ pixcode status # Show configuration
175
-
176
- Environment Variables:
177
- SERVER_PORT Set server port (default: 3001)
178
- PORT Set server port (default: 3001) (LEGACY)
179
- DATABASE_PATH Set custom database location
180
- CLAUDE_CLI_PATH Set custom Claude CLI path
181
- CONTEXT_WINDOW Set context window size (default: 160000)
182
-
183
- Documentation:
184
- ${packageJson.homepage || 'https://github.com/alicomert/pixcode'}
185
-
186
- Report Issues:
187
- ${packageJson.bugs?.url || 'https://github.com/alicomert/pixcode/issues'}
140
+ console.log(`
141
+ ╔═══════════════════════════════════════════════════════════════╗
142
+ ║ Pixcode - Command Line Tool ║
143
+ ╚═══════════════════════════════════════════════════════════════╝
144
+
145
+ Usage:
146
+ pixcode [command] [options]
147
+
148
+ Commands:
149
+ start Start the Pixcode server (default)
150
+ daemon Manage persistent Linux service (system-first)
151
+ sandbox Manage Docker sandbox environments
152
+ status Show configuration and data locations
153
+ update Update to the latest version
154
+ help Show this help information
155
+ version Show version information
156
+
157
+ Options:
158
+ -p, --port <port> Set server port (default: 3001)
159
+ --database-path <path> Set custom database location
160
+ --no-daemon Disable automatic daemon startup on Linux
161
+ --restart-daemon Restart daemon automatically after update
162
+ -h, --help Show this help information
163
+ -v, --version Show version information
164
+
165
+ Examples:
166
+ $ pixcode # Start with defaults
167
+ $ pixcode --port 8080 # Start on port 8080
168
+ $ pixcode --no-daemon # Force foreground mode
169
+ $ sudo pixcode daemon install --mode system --port 3001
170
+ $ pixcode daemon install --mode user --port 3001 --single-port
171
+ $ pixcode daemon doctor --mode system
172
+ $ pixcode update --restart-daemon
173
+ $ pixcode sandbox ~/my-project # Run in a Docker sandbox
174
+ $ pixcode status # Show configuration
175
+
176
+ Environment Variables:
177
+ SERVER_PORT Set server port (default: 3001)
178
+ PORT Set server port (default: 3001) (LEGACY)
179
+ DATABASE_PATH Set custom database location
180
+ CLAUDE_CLI_PATH Set custom Claude CLI path
181
+ CONTEXT_WINDOW Set context window size (default: 160000)
182
+
183
+ Documentation:
184
+ ${packageJson.homepage || 'https://github.com/alicomert/pixcode'}
185
+
186
+ Report Issues:
187
+ ${packageJson.bugs?.url || 'https://github.com/alicomert/pixcode/issues'}
188
188
  `);
189
189
  }
190
190
  // Show version
@@ -332,54 +332,54 @@ function parseSandboxArgs(args) {
332
332
  return result;
333
333
  }
334
334
  function showSandboxHelp() {
335
- console.log(`
336
- ${c.bright('Pixcode Sandbox')} — Run Pixcode inside Docker Sandboxes
337
-
338
- Usage:
339
- pixcode sandbox <workspace> Create and start a sandbox
340
- pixcode sandbox <subcommand> [name] Manage sandboxes
341
-
342
- Subcommands:
343
- ${c.bright('(default)')} Create a sandbox and start the web UI
344
- ${c.bright('ls')} List all sandboxes
345
- ${c.bright('start')} Restart a stopped sandbox and re-launch the web UI
346
- ${c.bright('stop')} Stop a sandbox (preserves state)
347
- ${c.bright('rm')} Remove a sandbox
348
- ${c.bright('logs')} Show Pixcode server logs
349
- ${c.bright('help')} Show this help
350
-
351
- Options:
352
- -a, --agent <agent> Agent to use: claude, codex, gemini (default: claude)
353
- -n, --name <name> Sandbox name (default: derived from workspace folder)
354
- -t, --template <image> Custom template image
355
- -e, --env <KEY=VALUE> Set environment variable (repeatable)
356
- --port <port> Host port for the web UI (default: 3001)
357
-
358
- Examples:
359
- $ pixcode sandbox ~/my-project
360
- $ pixcode sandbox ~/my-project --agent codex --port 8080
361
- $ pixcode sandbox ~/my-project --env SERVER_PORT=8080 --env HOST=0.0.0.0
362
- $ pixcode sandbox ls
363
- $ pixcode sandbox stop my-project
364
- $ pixcode sandbox start my-project
365
- $ pixcode sandbox rm my-project
366
-
367
- Prerequisites:
368
- 1. Install sbx CLI: https://docs.docker.com/ai/sandboxes/get-started/
369
- 2. Authenticate and store your API key:
370
- sbx login
371
- sbx secret set -g anthropic # for Claude
372
- sbx secret set -g openai # for Codex
373
- sbx secret set -g google # for Gemini
374
-
375
- Advanced usage:
376
- For branch mode, multiple workspaces, memory limits, network policies,
377
- or passing prompts to the agent, use sbx directly with the template:
378
-
379
- sbx run --template ghcr.io/alicomert/pixcode-sandbox:claude-code claude ~/my-project --branch my-feature
380
- sbx run --template ghcr.io/alicomert/pixcode-sandbox:claude-code claude ~/project ~/libs:ro --memory 8g
381
-
382
- Full Docker Sandboxes docs: https://docs.docker.com/ai/sandboxes/usage/
335
+ console.log(`
336
+ ${c.bright('Pixcode Sandbox')} — Run Pixcode inside Docker Sandboxes
337
+
338
+ Usage:
339
+ pixcode sandbox <workspace> Create and start a sandbox
340
+ pixcode sandbox <subcommand> [name] Manage sandboxes
341
+
342
+ Subcommands:
343
+ ${c.bright('(default)')} Create a sandbox and start the web UI
344
+ ${c.bright('ls')} List all sandboxes
345
+ ${c.bright('start')} Restart a stopped sandbox and re-launch the web UI
346
+ ${c.bright('stop')} Stop a sandbox (preserves state)
347
+ ${c.bright('rm')} Remove a sandbox
348
+ ${c.bright('logs')} Show Pixcode server logs
349
+ ${c.bright('help')} Show this help
350
+
351
+ Options:
352
+ -a, --agent <agent> Agent to use: claude, codex, gemini (default: claude)
353
+ -n, --name <name> Sandbox name (default: derived from workspace folder)
354
+ -t, --template <image> Custom template image
355
+ -e, --env <KEY=VALUE> Set environment variable (repeatable)
356
+ --port <port> Host port for the web UI (default: 3001)
357
+
358
+ Examples:
359
+ $ pixcode sandbox ~/my-project
360
+ $ pixcode sandbox ~/my-project --agent codex --port 8080
361
+ $ pixcode sandbox ~/my-project --env SERVER_PORT=8080 --env HOST=0.0.0.0
362
+ $ pixcode sandbox ls
363
+ $ pixcode sandbox stop my-project
364
+ $ pixcode sandbox start my-project
365
+ $ pixcode sandbox rm my-project
366
+
367
+ Prerequisites:
368
+ 1. Install sbx CLI: https://docs.docker.com/ai/sandboxes/get-started/
369
+ 2. Authenticate and store your API key:
370
+ sbx login
371
+ sbx secret set -g anthropic # for Claude
372
+ sbx secret set -g openai # for Codex
373
+ sbx secret set -g google # for Gemini
374
+
375
+ Advanced usage:
376
+ For branch mode, multiple workspaces, memory limits, network policies,
377
+ or passing prompts to the agent, use sbx directly with the template:
378
+
379
+ sbx run --template ghcr.io/alicomert/pixcode-sandbox:claude-code claude ~/my-project --branch my-feature
380
+ sbx run --template ghcr.io/alicomert/pixcode-sandbox:claude-code claude ~/project ~/libs:ro --memory 8g
381
+
382
+ Full Docker Sandboxes docs: https://docs.docker.com/ai/sandboxes/usage/
383
383
  `);
384
384
  }
385
385
  async function sandboxCommand(args) {
@@ -149,19 +149,19 @@ function buildLinuxSystemdUnit({ nodePath, cliEntryPath, serverPort, databasePat
149
149
  const startArgs = buildDaemonStartArgs({ serverPort, databasePath });
150
150
  const execStart = [quoteSystemdArg(nodePath), quoteSystemdArg(cliEntryPath), ...startArgs.map(quoteSystemdArg)].join(' ');
151
151
  const execStop = [quoteSystemdArg(nodePath), quoteSystemdArg(cliEntryPath), quoteSystemdArg('daemon'), quoteSystemdArg('stop')].join(' ');
152
- return `[Unit]
153
- Description=Pixcode daemon bootstrap
154
- After=network-online.target
155
- Wants=network-online.target
156
-
157
- [Service]
158
- Type=oneshot
159
- RemainAfterExit=yes
160
- ExecStart=${execStart}
161
- ExecStop=${execStop}
162
-
163
- [Install]
164
- WantedBy=default.target
152
+ return `[Unit]
153
+ Description=Pixcode daemon bootstrap
154
+ After=network-online.target
155
+ Wants=network-online.target
156
+
157
+ [Service]
158
+ Type=oneshot
159
+ RemainAfterExit=yes
160
+ ExecStart=${execStart}
161
+ ExecStop=${execStop}
162
+
163
+ [Install]
164
+ WantedBy=default.target
165
165
  `;
166
166
  }
167
167
  function enableLinuxAutostart(options) {
@@ -211,26 +211,26 @@ function getLinuxAutostartStatus() {
211
211
  function buildMacLaunchAgent({ nodePath, cliEntryPath, serverPort, databasePath }) {
212
212
  const args = [nodePath, cliEntryPath, ...buildDaemonStartArgs({ serverPort, databasePath })];
213
213
  const xmlArgs = args.map((arg) => ` <string>${xmlEscape(arg)}</string>`).join('\n');
214
- return `<?xml version="1.0" encoding="UTF-8"?>
215
- <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
216
- <plist version="1.0">
217
- <dict>
218
- <key>Label</key>
219
- <string>${MACOS_LAUNCH_AGENT_LABEL}</string>
220
- <key>ProgramArguments</key>
221
- <array>
222
- ${xmlArgs}
223
- </array>
224
- <key>RunAtLoad</key>
225
- <true/>
226
- <key>KeepAlive</key>
227
- <false/>
228
- <key>StandardOutPath</key>
229
- <string>${xmlEscape(LOG_FILE)}</string>
230
- <key>StandardErrorPath</key>
231
- <string>${xmlEscape(LOG_FILE)}</string>
232
- </dict>
233
- </plist>
214
+ return `<?xml version="1.0" encoding="UTF-8"?>
215
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
216
+ <plist version="1.0">
217
+ <dict>
218
+ <key>Label</key>
219
+ <string>${MACOS_LAUNCH_AGENT_LABEL}</string>
220
+ <key>ProgramArguments</key>
221
+ <array>
222
+ ${xmlArgs}
223
+ </array>
224
+ <key>RunAtLoad</key>
225
+ <true/>
226
+ <key>KeepAlive</key>
227
+ <false/>
228
+ <key>StandardOutPath</key>
229
+ <string>${xmlEscape(LOG_FILE)}</string>
230
+ <key>StandardErrorPath</key>
231
+ <string>${xmlEscape(LOG_FILE)}</string>
232
+ </dict>
233
+ </plist>
234
234
  `;
235
235
  }
236
236
  function enableMacAutostart(options) {