@pixelbyte-software/pixcode 1.35.2 → 1.35.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 (228) 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-BwmhA_le.css +32 -0
  11. package/dist/assets/{index-D1-AIL_5.js → index-CyxRiNt0.js} +182 -182
  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/cli.js.map +1 -1
  36. package/dist-server/server/cursor-cli.js.map +1 -1
  37. package/dist-server/server/daemon/manager.js +33 -33
  38. package/dist-server/server/daemon-manager.js +64 -64
  39. package/dist-server/server/gemini-cli.js +4 -4
  40. package/dist-server/server/gemini-cli.js.map +1 -1
  41. package/dist-server/server/index.js +11 -11
  42. package/dist-server/server/index.js.map +1 -1
  43. package/dist-server/server/load-env.js.map +1 -1
  44. package/dist-server/server/middleware/auth.js.map +1 -1
  45. package/dist-server/server/modules/orchestration/tasks/orchestration-task.routes.js.map +1 -1
  46. package/dist-server/server/modules/providers/list/claude/claude-auth.provider.js +1 -1
  47. package/dist-server/server/modules/providers/list/claude/claude-auth.provider.js.map +1 -1
  48. package/dist-server/server/modules/providers/list/codex/codex-auth.provider.js +1 -1
  49. package/dist-server/server/modules/providers/list/codex/codex-auth.provider.js.map +1 -1
  50. package/dist-server/server/modules/providers/list/gemini/gemini-auth.provider.js +1 -1
  51. package/dist-server/server/modules/providers/list/gemini/gemini-auth.provider.js.map +1 -1
  52. package/dist-server/server/modules/providers/list/opencode/opencode-auth.provider.js +1 -1
  53. package/dist-server/server/modules/providers/list/opencode/opencode-auth.provider.js.map +1 -1
  54. package/dist-server/server/modules/providers/list/qwen/qwen-auth.provider.js +1 -1
  55. package/dist-server/server/modules/providers/list/qwen/qwen-auth.provider.js.map +1 -1
  56. package/dist-server/server/modules/providers/provider.routes.js +3 -6
  57. package/dist-server/server/modules/providers/provider.routes.js.map +1 -1
  58. package/dist-server/server/opencode-cli.js +1 -1
  59. package/dist-server/server/opencode-cli.js.map +1 -1
  60. package/dist-server/server/projects.js +2 -3
  61. package/dist-server/server/projects.js.map +1 -1
  62. package/dist-server/server/qwen-code-cli.js +1 -1
  63. package/dist-server/server/qwen-code-cli.js.map +1 -1
  64. package/dist-server/server/routes/agent.js +3 -3
  65. package/dist-server/server/routes/agent.js.map +1 -1
  66. package/dist-server/server/routes/auth.js.map +1 -1
  67. package/dist-server/server/routes/codex.js.map +1 -1
  68. package/dist-server/server/routes/commands.js +26 -26
  69. package/dist-server/server/routes/commands.js.map +1 -1
  70. package/dist-server/server/routes/cursor.js +1 -1
  71. package/dist-server/server/routes/cursor.js.map +1 -1
  72. package/dist-server/server/routes/gemini.js.map +1 -1
  73. package/dist-server/server/routes/git.js +18 -18
  74. package/dist-server/server/routes/git.js.map +1 -1
  75. package/dist-server/server/routes/mcp-utils.js.map +1 -1
  76. package/dist-server/server/routes/messages.js.map +1 -1
  77. package/dist-server/server/routes/network.js +1 -1
  78. package/dist-server/server/routes/network.js.map +1 -1
  79. package/dist-server/server/routes/plugins.js +2 -2
  80. package/dist-server/server/routes/plugins.js.map +1 -1
  81. package/dist-server/server/routes/projects.js +1 -1
  82. package/dist-server/server/routes/projects.js.map +1 -1
  83. package/dist-server/server/routes/settings.js.map +1 -1
  84. package/dist-server/server/routes/taskmaster.js +423 -424
  85. package/dist-server/server/routes/taskmaster.js.map +1 -1
  86. package/dist-server/server/routes/user.js +1 -1
  87. package/dist-server/server/routes/user.js.map +1 -1
  88. package/dist-server/server/services/external-access.js +0 -1
  89. package/dist-server/server/services/external-access.js.map +1 -1
  90. package/dist-server/server/services/notification-orchestrator.js.map +1 -1
  91. package/dist-server/server/utils/commandParser.js.map +1 -1
  92. package/dist-server/server/utils/plugin-process-manager.js.map +1 -1
  93. package/dist-server/server/vite-daemon.js.map +1 -1
  94. package/package.json +180 -180
  95. package/scripts/fix-node-pty.js +67 -67
  96. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  97. package/scripts/smoke/orchestration-api.mjs +172 -172
  98. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  99. package/server/claude-sdk.js +898 -898
  100. package/server/cli.js +936 -935
  101. package/server/constants/config.js +4 -4
  102. package/server/cursor-cli.js +344 -342
  103. package/server/daemon/manager.js +564 -564
  104. package/server/daemon-manager.js +959 -959
  105. package/server/database/db.js +794 -794
  106. package/server/database/json-store.js +197 -197
  107. package/server/gemini-cli.js +536 -535
  108. package/server/gemini-response-handler.js +79 -79
  109. package/server/index.js +3138 -3135
  110. package/server/load-env.js +35 -34
  111. package/server/middleware/auth.js +174 -173
  112. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  113. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  114. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  115. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  116. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  117. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  118. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  119. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  120. package/server/modules/orchestration/a2a/routes.ts +577 -577
  121. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  122. package/server/modules/orchestration/a2a/types.ts +125 -125
  123. package/server/modules/orchestration/a2a/validator.ts +113 -113
  124. package/server/modules/orchestration/index.ts +66 -66
  125. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  126. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  127. package/server/modules/orchestration/preview/types.ts +19 -19
  128. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  129. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +74 -73
  130. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  131. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  132. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  133. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  134. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  135. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  136. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  137. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  138. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  139. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  140. package/server/modules/orchestration/workspace/types.ts +52 -52
  141. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  142. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  143. package/server/modules/providers/index.ts +2 -2
  144. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -145
  145. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  146. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  147. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  148. package/server/modules/providers/list/codex/codex-auth.provider.ts +116 -115
  149. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  150. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  151. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  152. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  153. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  154. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  155. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  156. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +164 -163
  157. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  158. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  159. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  160. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -130
  161. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  162. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  163. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  164. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -145
  165. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  166. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  167. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  168. package/server/modules/providers/provider.registry.ts +40 -40
  169. package/server/modules/providers/provider.routes.ts +822 -819
  170. package/server/modules/providers/services/mcp.service.ts +86 -86
  171. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  172. package/server/modules/providers/services/sessions.service.ts +45 -45
  173. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  174. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  175. package/server/modules/providers/shared/provider-configs.ts +142 -142
  176. package/server/modules/providers/tests/mcp.test.ts +293 -293
  177. package/server/openai-codex.js +462 -462
  178. package/server/opencode-cli.js +460 -459
  179. package/server/opencode-response-handler.js +107 -107
  180. package/server/projects.js +3106 -3105
  181. package/server/qwen-code-cli.js +396 -395
  182. package/server/qwen-response-handler.js +73 -73
  183. package/server/routes/agent.js +1367 -1365
  184. package/server/routes/auth.js +139 -138
  185. package/server/routes/codex.js +20 -19
  186. package/server/routes/commands.js +556 -554
  187. package/server/routes/cursor.js +54 -52
  188. package/server/routes/gemini.js +25 -24
  189. package/server/routes/git.js +1490 -1488
  190. package/server/routes/mcp-utils.js +32 -31
  191. package/server/routes/messages.js +62 -61
  192. package/server/routes/network.js +121 -120
  193. package/server/routes/plugins.js +320 -318
  194. package/server/routes/projects.js +917 -915
  195. package/server/routes/qwen.js +27 -27
  196. package/server/routes/settings.js +287 -286
  197. package/server/routes/taskmaster.js +1498 -1496
  198. package/server/routes/telegram.js +125 -125
  199. package/server/routes/user.js +125 -123
  200. package/server/services/external-access.js +171 -171
  201. package/server/services/install-jobs.js +571 -571
  202. package/server/services/notification-orchestrator.js +244 -242
  203. package/server/services/provider-credentials.js +189 -189
  204. package/server/services/provider-models.js +381 -381
  205. package/server/services/telegram/bot.js +279 -279
  206. package/server/services/telegram/telegram-http-client.js +130 -130
  207. package/server/services/telegram/translations.js +170 -170
  208. package/server/services/vapid-keys.js +36 -36
  209. package/server/sessionManager.js +225 -225
  210. package/server/shared/interfaces.ts +54 -54
  211. package/server/shared/types.ts +172 -172
  212. package/server/shared/utils.ts +193 -193
  213. package/server/tsconfig.json +36 -36
  214. package/server/utils/colors.js +21 -21
  215. package/server/utils/commandParser.js +305 -303
  216. package/server/utils/frontmatter.js +18 -18
  217. package/server/utils/gitConfig.js +34 -34
  218. package/server/utils/mcp-detector.js +147 -147
  219. package/server/utils/plugin-loader.js +457 -457
  220. package/server/utils/plugin-process-manager.js +185 -184
  221. package/server/utils/port-access.js +209 -209
  222. package/server/utils/runtime-paths.js +37 -37
  223. package/server/utils/taskmaster-websocket.js +128 -128
  224. package/server/utils/url-detection.js +71 -71
  225. package/server/vite-daemon.js +79 -78
  226. package/shared/modelConstants.js +162 -162
  227. package/shared/networkHosts.js +22 -22
  228. package/dist/assets/index-B8w57E1r.css +0 -32
package/README.ko.md CHANGED
@@ -1,240 +1,240 @@
1
- <div align="center">
2
- <img src="public/logo.svg" alt="Pixcode" width="64" height="64">
3
- <h1>Cloud CLI (일명 Claude Code UI)</h1>
4
- <p><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>, <a href="https://docs.cursor.com/en/cli/overview">Cursor CLI</a>, <a href="https://developers.openai.com/codex">Codex</a>, <a href="https://geminicli.com/">Gemini-CLI</a> 용 데스크톱 및 모바일 UI입니다.<br>로컬 또는 원격에서 실행하여 어디서나 활성 프로젝트와 세션을 확인하세요.</p>
5
- </div>
6
-
7
- <p align="center">
8
- <a href="https://github.com/alicomert/pixcode">Pixcode</a> · <a href="https://github.com/alicomert/pixcode">문서</a> · <a href="https://discord.gg/buxwujPNRE">Discord</a> · <a href="https://github.com/alicomert/pixcode/issues">버그 신고</a> · <a href="CONTRIBUTING.md">기여 안내</a>
9
- </p>
10
-
11
- <p align="center">
12
- <a href="https://github.com/alicomert/pixcode"><img src="https://img.shields.io/badge/☁️_Pixcode_Cloud-Try_Now-0066FF?style=for-the-badge" alt="Pixcode"></a>
13
- <a href="https://discord.gg/buxwujPNRE"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord 커뮤니티"></a>
14
- </p>
15
-
16
- <div align="right"><i><a href="./README.md">English</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.de.md">Deutsch</a> · <b>한국어</b> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.tr.md">Türkçe</a> · <a href="./README.it.md">Italiano</a></i></div>
17
-
18
- ---
19
-
20
- ## 스크린샷
21
-
22
- <div align="center">
23
-
24
- <table>
25
- <tr>
26
- <td align="center">
27
- <h3>데스크톱 보기</h3>
28
- <img src="public/screenshots/desktop-main.png" alt="데스크톱 인터페이스" width="400">
29
- <br>
30
- <em>프로젝트 개요와 채팅을 보여주는 메인 인터페이스</em>
31
- </td>
32
- <td align="center">
33
- <h3>모바일 경험</h3>
34
- <img src="public/screenshots/mobile-chat.png" alt="모바일 인터페이스" width="250">
35
- <br>
36
- <em>터치 내비게이션이 포함된 반응형 모바일 디자인</em>
37
- </td>
38
- </tr>
39
- <tr>
40
- <td align="center" colspan="2">
41
- <h3>CLI 선택</h3>
42
- <img src="public/screenshots/cli-selection.png" alt="CLI 선택" width="400">
43
- <br>
44
- <em>Claude Code, Gemini, Cursor CLI 및 Codex 중 선택</em>
45
- </td>
46
- </tr>
47
- </table>
48
-
49
- </div>
50
-
51
- ## 기능
52
-
53
- - **반응형 디자인** - 데스크톱, 태블릿, 모바일을 아우르는 매끄러운 경험으로 어디서든 Agents를 사용할 수 있습니다
54
- - **대화형 채팅 인터페이스** - 내장된 채팅 UI를 통해 에이전트와 자연스럽게 소통
55
- - **통합 셸 터미널** - 셸 기능을 통해 Agents CLI에 직접 접근
56
- - **파일 탐색기** - 구문 강조 및 실시간 편집을 갖춘 인터랙티브 파일 트리
57
- - **Git 탐색기** - 변경 사항 보기, 스테이징 및 커밋. 브랜치 전환 기능 포함
58
- - **세션 관리** - 대화를 재개하고, 여러 세션을 관리하며 기록을 추적
59
- - **플러그인 시스템** - 커스텀 탭, 백엔드 서비스, 통합을 추가하여 Pixcode 확장. [직접 빌드 →](https://github.com/alicomert/pixcode)
60
- - **TaskMaster AI 통합** *(선택사항)* - AI 중심의 작업 계획, PRD 파싱, 워크플로 자동화를 통한 고급 프로젝트 관리
61
- - **모델 호환성** - Claude, GPT, Gemini 모델 계열에서 작동 (`shared/modelConstants.js`에서 전체 지원 모델 확인)
62
-
63
- ## 빠른 시작
64
-
65
- ### Pixcode (추천)
66
-
67
- 가장 빠르게 시작하는 방법 — 로컬 설정 없이도 가능합니다. 웹, 모바일 앱, API 또는 선호하는 IDE에서 이용할 수 있는 완전 관리형 컨테이너화된 개발 환경을 제공합니다.
68
-
69
- **[Pixcode 시작하기](https://github.com/alicomert/pixcode)**
70
-
71
- ### 셀프 호스트 (오픈 소스)
72
-
73
- #### npm
74
-
75
- **npx**로 즉시 Pixcode를 실행하세요 (Node.js v22+ 필요):
76
-
77
- ```bash
78
- npx @pixelbyte-software/pixcode
79
- ```
80
-
81
- **정기적으로 사용한다면 전역 설치:**
82
-
83
- ```bash
84
- npm install -g @pixelbyte-software/pixcode
85
- pixcode
86
- ```
87
-
88
- `http://localhost:3001`을 열면 기존 세션이 자동으로 발견됩니다.
89
-
90
- 자세한 구성 옵션, PM2, 원격 서버 설정 등은 **[문서 →](https://github.com/alicomert/pixcode)**를 참고하세요.
91
-
92
- #### Docker Sandboxes (실험적)
93
-
94
- 하이퍼바이저 수준 격리로 에이전트를 샌드박스에서 실행합니다. 기본 에이전트는 Claude Code입니다. [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/)가 필요합니다.
95
-
96
- ```
97
- npx @pixelbyte-software/pixcode@latest sandbox ~/my-project
98
- ```
99
-
100
- Claude Code, Codex, Gemini CLI를 지원합니다. 자세한 내용은 [샌드박스 문서](docker/)를 참고하세요.
101
-
102
- ---
103
-
104
- ## 어느 옵션이 적합한가요?
105
-
106
- Pixcode는 Pixcode를 구동하는 오픈 소스 UI 계층입니다. 로컬 머신에서 직접 셀프 호스트하거나, Pixcode(완전 관리형 클라우드 환경, 팀 기능, 심화 통합 제공)를 사용할 수 있습니다.
107
-
108
- | | Pixcode (셀프 호스트) | Pixcode |
109
- |---|---|---|
110
- | **적합한 대상** | 로컬 에이전트 세션을 위한 전체 UI가 필요한 개발자 | 어디서든 접근 가능한 클라우드에서 에이전트를 운영하고자 하는 팀 및 개발자 |
111
- | **접근 방법** | `[yourip]:port`를 통해 브라우저 접속 | 브라우저, IDE, REST API, n8n |
112
- | **설정** | `npx @pixelbyte-software/pixcode` | 설정 불필요 |
113
- | **기기 유지 필요 여부** | 예 (머신 켜둬야 함) | 아니오 |
114
- | **모바일 접근** | 네트워크 내 브라우저 | 모든 기기 (네이티브 앱 예정) |
115
- | **세션 접근** | `~/.claude`에서 자동 발견 | 클라우드 환경 내 세션 |
116
- | **지원 에이전트** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
117
- | **파일 탐색기 및 Git** | UI에 통합됨 | UI에 통합됨 |
118
- | **MCP 구성** | UI에서 관리, 로컬 `~/.claude` 설정과 동기화됨 | UI에서 관리 |
119
- | **IDE 접근** | 로컬 IDE | 클라우드 환경에 연결된 모든 IDE |
120
- | **REST API** | 예 | 예 |
121
- | **n8n 노드** | 아니오 | 예 |
122
- | **팀 공유** | 아니오 | 예 |
123
- | **플랫폼 비용** | 무료, 오픈 소스 | 월 $7부터 |
124
-
125
- > 둘 다 자체 AI 구독(Claude, Cursor 등)을 그대로 사용합니다 — Pixcode는 환경만 제공합니다.
126
-
127
- ---
128
-
129
- ## 보안 및 도구 구성
130
-
131
- **🔒 중요 공지**: 모든 Claude Code 도구는 **기본적으로 비활성화**되어 있습니다. 이는 잠재적인 유해 작업이 자동 실행되는 것을 방지하기 위한 조치입니다.
132
-
133
- ### 도구 활성화
134
-
135
- 1. **도구 설정 열기** - 사이드바의 톱니바퀴 아이콘 클릭
136
- 2. **선택적으로 활성화** - 필요한 도구만 켜기
137
- 3. **설정 적용** - 선호도는 로컬에 저장됨
138
-
139
- <div align="center">
140
-
141
- ![도구 설정 모달](public/screenshots/tools-modal.png)
142
- *도구 설정 인터페이스 - 필요한 것만 켜세요*
143
-
144
- </div>
145
-
146
- **권장 방법**: 기본 도구를 먼저 켜고 필요할 때 추가하세요. 언제든지 조정 가능합니다.
147
-
148
- ---
149
-
150
- ## 플러그인
151
-
152
- Pixcode는 커스텀 탭과 선택적 Node.js 백엔드가 포함된 플러그인 시스템을 제공합니다. Settings > Plugins에서 Git 저장소에서 플러그인을 설치하거나 직접 빌드할 수 있습니다.
153
-
154
- ### 이용 가능한 플러그인
155
-
156
- | 플러그인 | 설명 |
157
- |---|---|
158
- | **[Project Stats](https://github.com/alicomert/pixcode)** | 현재 프로젝트의 파일 수, 코드 줄 수, 파일 유형 분포, 가장 큰 파일, 최근 수정 파일을 표시 |
159
-
160
- ### 직접 만들기
161
-
162
- **[Plugin Starter Template →](https://github.com/alicomert/pixcode)** — 이 저장소를 포크하여 플러그인 구축. 프런트엔드 렌더링, 실시간 컨텍스트 업데이트, RPC 통신 예제 포함.
163
-
164
- **[플러그인 문서 →](https://github.com/alicomert/pixcode)** — 플러그인 API, 매니페스트 포맷, 보안 모델 등을 설명.
165
-
166
- ---
167
-
168
- ## FAQ
169
-
170
- <details>
171
- <summary>Claude Code Remote Control과 어떻게 다른가요?</summary>
172
-
173
- Claude Code Remote Control은 이미 로컬 터미널에서 실행 중인 세션으로 메시지를 전송합니다. 이 경우 기계가 켜져 있어야 하고 터미널을 열어 둬야 하며, 네트워크 연결 없이 약 10분 후 타임아웃됩니다.
174
-
175
- Pixcode와 Pixcode는 Claude Code를 확장하며 별도로 존재하지 않습니다 — MCP 서버, 권한, 설정, 세션은 Claude Code에서 그대로 사용됩니다.
176
-
177
- - **모든 세션을 다룬다** — Pixcode는 `~/.claude` 폴더에서 모든 세션을 자동 발견합니다. Remote Control은 단일 활성 세션만 노출합니다.
178
- - **설정은 그대로** — Pixcode에서 변경한 MCP, 도구 권한, 프로젝트 설정은 Claude Code에 즉시 반영됩니다.
179
- - **지원 에이전트가 더 많음** — Claude Code, Cursor CLI, Codex, Gemini CLI 지원.
180
- - **전체 UI 제공** — 단일 채팅 창이 아닌 파일 탐색기, Git 통합, MCP 관리 및 셸 터미널 포함.
181
- - **Pixcode는 클라우드에서 실행** — 노트북을 닫아도 에이전트가 실행됩니다. 터미널을 계속 확인할 필요 없음.
182
-
183
- </details>
184
-
185
- <details>
186
- <summary>AI 구독을 별도로 결제해야 하나요?</summary>
187
-
188
- 네. Pixcode는 환경만 제공합니다. Claude, Cursor, Codex, Gemini 구독 비용은 별도로 부과됩니다. Pixcode는 관리형 환경을 월 $7부터 제공합니다.
189
-
190
- </details>
191
-
192
- <details>
193
- <summary>Pixcode를 휴대폰에서 사용할 수 있나요?</summary>
194
-
195
- 네. 셀프 호스트인 경우 기계에서 서버를 실행하고 네트워크의 아무 브라우저에서 `[yourip]:port`를 열면 됩니다. Pixcode는 어떤 기기에서도 열 수 있으며, 네이티브 앱도 준비 중입니다.
196
-
197
- </details>
198
-
199
- <details>
200
- <summary>UI에서 변경하면 로컬 Claude Code 설정에 영향을 주나요?</summary>
201
-
202
- 네, 셀프 호스트에서는 그렇습니다. Pixcode는 Claude Code가 사용하는 동일한 `~/.claude` 설정을 읽고 씁니다. UI에서 추가한 MCP 서버가 Claude Code에 즉시 나타납니다.
203
-
204
- </details>
205
-
206
- ---
207
-
208
- ## 커뮤니티 및 지원
209
-
210
- - **[문서](https://github.com/alicomert/pixcode)** — 설치, 구성, 기능, 문제 해결 안내
211
- - **[Discord](https://discord.gg/buxwujPNRE)** — 도움 및 커뮤니티 참여
212
- - **[GitHub Issues](https://github.com/alicomert/pixcode/issues)** — 버그 보고 및 기능 요청
213
- - **[기여 안내](CONTRIBUTING.md)** — 프로젝트 참여 방법
214
-
215
- ## 라이선스
216
-
217
- GNU General Public License v3.0 - 자세한 내용은 [LICENSE](LICENSE) 파일 참조.
218
-
219
- 이 프로젝트는 GPL v3 라이선스 하에 오픈 소스로 공개되어 있으며 자유롭게 사용, 수정, 배포할 수 있습니다.
220
-
221
- ## 감사의 말
222
-
223
- ### 사용 기술
224
- - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 공식 CLI
225
- - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 공식 CLI
226
- - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
227
- - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
228
- - **[React](https://react.dev/)** - 사용자 인터페이스 라이브러리
229
- - **[Vite](https://vitejs.dev/)** - 빠른 빌드 도구 및 개발 서버
230
- - **[Tailwind CSS](https://tailwindcss.com/)** - 유틸리티 우선 CSS 프레임워크
231
- - **[CodeMirror](https://codemirror.net/)** - 고급 코드 에디터
232
- - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(선택사항)* - AI 기반 프로젝트 관리 및 작업 계획
233
-
234
- ### 스폰서
235
- - [Siteboon - AI powered website builder](https://siteboon.ai)
236
- ---
237
-
238
- <div align="center">
239
- <strong>Claude Code, Cursor, Codex 커뮤니티를 위해 정성껏 제작되었습니다.</strong>
240
- </div>
1
+ <div align="center">
2
+ <img src="public/logo.svg" alt="Pixcode" width="64" height="64">
3
+ <h1>Cloud CLI (일명 Claude Code UI)</h1>
4
+ <p><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>, <a href="https://docs.cursor.com/en/cli/overview">Cursor CLI</a>, <a href="https://developers.openai.com/codex">Codex</a>, <a href="https://geminicli.com/">Gemini-CLI</a> 용 데스크톱 및 모바일 UI입니다.<br>로컬 또는 원격에서 실행하여 어디서나 활성 프로젝트와 세션을 확인하세요.</p>
5
+ </div>
6
+
7
+ <p align="center">
8
+ <a href="https://github.com/alicomert/pixcode">Pixcode</a> · <a href="https://github.com/alicomert/pixcode">문서</a> · <a href="https://discord.gg/buxwujPNRE">Discord</a> · <a href="https://github.com/alicomert/pixcode/issues">버그 신고</a> · <a href="CONTRIBUTING.md">기여 안내</a>
9
+ </p>
10
+
11
+ <p align="center">
12
+ <a href="https://github.com/alicomert/pixcode"><img src="https://img.shields.io/badge/☁️_Pixcode_Cloud-Try_Now-0066FF?style=for-the-badge" alt="Pixcode"></a>
13
+ <a href="https://discord.gg/buxwujPNRE"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord 커뮤니티"></a>
14
+ </p>
15
+
16
+ <div align="right"><i><a href="./README.md">English</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.de.md">Deutsch</a> · <b>한국어</b> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.tr.md">Türkçe</a> · <a href="./README.it.md">Italiano</a></i></div>
17
+
18
+ ---
19
+
20
+ ## 스크린샷
21
+
22
+ <div align="center">
23
+
24
+ <table>
25
+ <tr>
26
+ <td align="center">
27
+ <h3>데스크톱 보기</h3>
28
+ <img src="public/screenshots/desktop-main.png" alt="데스크톱 인터페이스" width="400">
29
+ <br>
30
+ <em>프로젝트 개요와 채팅을 보여주는 메인 인터페이스</em>
31
+ </td>
32
+ <td align="center">
33
+ <h3>모바일 경험</h3>
34
+ <img src="public/screenshots/mobile-chat.png" alt="모바일 인터페이스" width="250">
35
+ <br>
36
+ <em>터치 내비게이션이 포함된 반응형 모바일 디자인</em>
37
+ </td>
38
+ </tr>
39
+ <tr>
40
+ <td align="center" colspan="2">
41
+ <h3>CLI 선택</h3>
42
+ <img src="public/screenshots/cli-selection.png" alt="CLI 선택" width="400">
43
+ <br>
44
+ <em>Claude Code, Gemini, Cursor CLI 및 Codex 중 선택</em>
45
+ </td>
46
+ </tr>
47
+ </table>
48
+
49
+ </div>
50
+
51
+ ## 기능
52
+
53
+ - **반응형 디자인** - 데스크톱, 태블릿, 모바일을 아우르는 매끄러운 경험으로 어디서든 Agents를 사용할 수 있습니다
54
+ - **대화형 채팅 인터페이스** - 내장된 채팅 UI를 통해 에이전트와 자연스럽게 소통
55
+ - **통합 셸 터미널** - 셸 기능을 통해 Agents CLI에 직접 접근
56
+ - **파일 탐색기** - 구문 강조 및 실시간 편집을 갖춘 인터랙티브 파일 트리
57
+ - **Git 탐색기** - 변경 사항 보기, 스테이징 및 커밋. 브랜치 전환 기능 포함
58
+ - **세션 관리** - 대화를 재개하고, 여러 세션을 관리하며 기록을 추적
59
+ - **플러그인 시스템** - 커스텀 탭, 백엔드 서비스, 통합을 추가하여 Pixcode 확장. [직접 빌드 →](https://github.com/alicomert/pixcode)
60
+ - **TaskMaster AI 통합** *(선택사항)* - AI 중심의 작업 계획, PRD 파싱, 워크플로 자동화를 통한 고급 프로젝트 관리
61
+ - **모델 호환성** - Claude, GPT, Gemini 모델 계열에서 작동 (`shared/modelConstants.js`에서 전체 지원 모델 확인)
62
+
63
+ ## 빠른 시작
64
+
65
+ ### Pixcode (추천)
66
+
67
+ 가장 빠르게 시작하는 방법 — 로컬 설정 없이도 가능합니다. 웹, 모바일 앱, API 또는 선호하는 IDE에서 이용할 수 있는 완전 관리형 컨테이너화된 개발 환경을 제공합니다.
68
+
69
+ **[Pixcode 시작하기](https://github.com/alicomert/pixcode)**
70
+
71
+ ### 셀프 호스트 (오픈 소스)
72
+
73
+ #### npm
74
+
75
+ **npx**로 즉시 Pixcode를 실행하세요 (Node.js v22+ 필요):
76
+
77
+ ```bash
78
+ npx @pixelbyte-software/pixcode
79
+ ```
80
+
81
+ **정기적으로 사용한다면 전역 설치:**
82
+
83
+ ```bash
84
+ npm install -g @pixelbyte-software/pixcode
85
+ pixcode
86
+ ```
87
+
88
+ `http://localhost:3001`을 열면 기존 세션이 자동으로 발견됩니다.
89
+
90
+ 자세한 구성 옵션, PM2, 원격 서버 설정 등은 **[문서 →](https://github.com/alicomert/pixcode)**를 참고하세요.
91
+
92
+ #### Docker Sandboxes (실험적)
93
+
94
+ 하이퍼바이저 수준 격리로 에이전트를 샌드박스에서 실행합니다. 기본 에이전트는 Claude Code입니다. [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/)가 필요합니다.
95
+
96
+ ```
97
+ npx @pixelbyte-software/pixcode@latest sandbox ~/my-project
98
+ ```
99
+
100
+ Claude Code, Codex, Gemini CLI를 지원합니다. 자세한 내용은 [샌드박스 문서](docker/)를 참고하세요.
101
+
102
+ ---
103
+
104
+ ## 어느 옵션이 적합한가요?
105
+
106
+ Pixcode는 Pixcode를 구동하는 오픈 소스 UI 계층입니다. 로컬 머신에서 직접 셀프 호스트하거나, Pixcode(완전 관리형 클라우드 환경, 팀 기능, 심화 통합 제공)를 사용할 수 있습니다.
107
+
108
+ | | Pixcode (셀프 호스트) | Pixcode |
109
+ |---|---|---|
110
+ | **적합한 대상** | 로컬 에이전트 세션을 위한 전체 UI가 필요한 개발자 | 어디서든 접근 가능한 클라우드에서 에이전트를 운영하고자 하는 팀 및 개발자 |
111
+ | **접근 방법** | `[yourip]:port`를 통해 브라우저 접속 | 브라우저, IDE, REST API, n8n |
112
+ | **설정** | `npx @pixelbyte-software/pixcode` | 설정 불필요 |
113
+ | **기기 유지 필요 여부** | 예 (머신 켜둬야 함) | 아니오 |
114
+ | **모바일 접근** | 네트워크 내 브라우저 | 모든 기기 (네이티브 앱 예정) |
115
+ | **세션 접근** | `~/.claude`에서 자동 발견 | 클라우드 환경 내 세션 |
116
+ | **지원 에이전트** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
117
+ | **파일 탐색기 및 Git** | UI에 통합됨 | UI에 통합됨 |
118
+ | **MCP 구성** | UI에서 관리, 로컬 `~/.claude` 설정과 동기화됨 | UI에서 관리 |
119
+ | **IDE 접근** | 로컬 IDE | 클라우드 환경에 연결된 모든 IDE |
120
+ | **REST API** | 예 | 예 |
121
+ | **n8n 노드** | 아니오 | 예 |
122
+ | **팀 공유** | 아니오 | 예 |
123
+ | **플랫폼 비용** | 무료, 오픈 소스 | 월 $7부터 |
124
+
125
+ > 둘 다 자체 AI 구독(Claude, Cursor 등)을 그대로 사용합니다 — Pixcode는 환경만 제공합니다.
126
+
127
+ ---
128
+
129
+ ## 보안 및 도구 구성
130
+
131
+ **🔒 중요 공지**: 모든 Claude Code 도구는 **기본적으로 비활성화**되어 있습니다. 이는 잠재적인 유해 작업이 자동 실행되는 것을 방지하기 위한 조치입니다.
132
+
133
+ ### 도구 활성화
134
+
135
+ 1. **도구 설정 열기** - 사이드바의 톱니바퀴 아이콘 클릭
136
+ 2. **선택적으로 활성화** - 필요한 도구만 켜기
137
+ 3. **설정 적용** - 선호도는 로컬에 저장됨
138
+
139
+ <div align="center">
140
+
141
+ ![도구 설정 모달](public/screenshots/tools-modal.png)
142
+ *도구 설정 인터페이스 - 필요한 것만 켜세요*
143
+
144
+ </div>
145
+
146
+ **권장 방법**: 기본 도구를 먼저 켜고 필요할 때 추가하세요. 언제든지 조정 가능합니다.
147
+
148
+ ---
149
+
150
+ ## 플러그인
151
+
152
+ Pixcode는 커스텀 탭과 선택적 Node.js 백엔드가 포함된 플러그인 시스템을 제공합니다. Settings > Plugins에서 Git 저장소에서 플러그인을 설치하거나 직접 빌드할 수 있습니다.
153
+
154
+ ### 이용 가능한 플러그인
155
+
156
+ | 플러그인 | 설명 |
157
+ |---|---|
158
+ | **[Project Stats](https://github.com/alicomert/pixcode)** | 현재 프로젝트의 파일 수, 코드 줄 수, 파일 유형 분포, 가장 큰 파일, 최근 수정 파일을 표시 |
159
+
160
+ ### 직접 만들기
161
+
162
+ **[Plugin Starter Template →](https://github.com/alicomert/pixcode)** — 이 저장소를 포크하여 플러그인 구축. 프런트엔드 렌더링, 실시간 컨텍스트 업데이트, RPC 통신 예제 포함.
163
+
164
+ **[플러그인 문서 →](https://github.com/alicomert/pixcode)** — 플러그인 API, 매니페스트 포맷, 보안 모델 등을 설명.
165
+
166
+ ---
167
+
168
+ ## FAQ
169
+
170
+ <details>
171
+ <summary>Claude Code Remote Control과 어떻게 다른가요?</summary>
172
+
173
+ Claude Code Remote Control은 이미 로컬 터미널에서 실행 중인 세션으로 메시지를 전송합니다. 이 경우 기계가 켜져 있어야 하고 터미널을 열어 둬야 하며, 네트워크 연결 없이 약 10분 후 타임아웃됩니다.
174
+
175
+ Pixcode와 Pixcode는 Claude Code를 확장하며 별도로 존재하지 않습니다 — MCP 서버, 권한, 설정, 세션은 Claude Code에서 그대로 사용됩니다.
176
+
177
+ - **모든 세션을 다룬다** — Pixcode는 `~/.claude` 폴더에서 모든 세션을 자동 발견합니다. Remote Control은 단일 활성 세션만 노출합니다.
178
+ - **설정은 그대로** — Pixcode에서 변경한 MCP, 도구 권한, 프로젝트 설정은 Claude Code에 즉시 반영됩니다.
179
+ - **지원 에이전트가 더 많음** — Claude Code, Cursor CLI, Codex, Gemini CLI 지원.
180
+ - **전체 UI 제공** — 단일 채팅 창이 아닌 파일 탐색기, Git 통합, MCP 관리 및 셸 터미널 포함.
181
+ - **Pixcode는 클라우드에서 실행** — 노트북을 닫아도 에이전트가 실행됩니다. 터미널을 계속 확인할 필요 없음.
182
+
183
+ </details>
184
+
185
+ <details>
186
+ <summary>AI 구독을 별도로 결제해야 하나요?</summary>
187
+
188
+ 네. Pixcode는 환경만 제공합니다. Claude, Cursor, Codex, Gemini 구독 비용은 별도로 부과됩니다. Pixcode는 관리형 환경을 월 $7부터 제공합니다.
189
+
190
+ </details>
191
+
192
+ <details>
193
+ <summary>Pixcode를 휴대폰에서 사용할 수 있나요?</summary>
194
+
195
+ 네. 셀프 호스트인 경우 기계에서 서버를 실행하고 네트워크의 아무 브라우저에서 `[yourip]:port`를 열면 됩니다. Pixcode는 어떤 기기에서도 열 수 있으며, 네이티브 앱도 준비 중입니다.
196
+
197
+ </details>
198
+
199
+ <details>
200
+ <summary>UI에서 변경하면 로컬 Claude Code 설정에 영향을 주나요?</summary>
201
+
202
+ 네, 셀프 호스트에서는 그렇습니다. Pixcode는 Claude Code가 사용하는 동일한 `~/.claude` 설정을 읽고 씁니다. UI에서 추가한 MCP 서버가 Claude Code에 즉시 나타납니다.
203
+
204
+ </details>
205
+
206
+ ---
207
+
208
+ ## 커뮤니티 및 지원
209
+
210
+ - **[문서](https://github.com/alicomert/pixcode)** — 설치, 구성, 기능, 문제 해결 안내
211
+ - **[Discord](https://discord.gg/buxwujPNRE)** — 도움 및 커뮤니티 참여
212
+ - **[GitHub Issues](https://github.com/alicomert/pixcode/issues)** — 버그 보고 및 기능 요청
213
+ - **[기여 안내](CONTRIBUTING.md)** — 프로젝트 참여 방법
214
+
215
+ ## 라이선스
216
+
217
+ GNU General Public License v3.0 - 자세한 내용은 [LICENSE](LICENSE) 파일 참조.
218
+
219
+ 이 프로젝트는 GPL v3 라이선스 하에 오픈 소스로 공개되어 있으며 자유롭게 사용, 수정, 배포할 수 있습니다.
220
+
221
+ ## 감사의 말
222
+
223
+ ### 사용 기술
224
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 공식 CLI
225
+ - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 공식 CLI
226
+ - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
227
+ - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
228
+ - **[React](https://react.dev/)** - 사용자 인터페이스 라이브러리
229
+ - **[Vite](https://vitejs.dev/)** - 빠른 빌드 도구 및 개발 서버
230
+ - **[Tailwind CSS](https://tailwindcss.com/)** - 유틸리티 우선 CSS 프레임워크
231
+ - **[CodeMirror](https://codemirror.net/)** - 고급 코드 에디터
232
+ - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(선택사항)* - AI 기반 프로젝트 관리 및 작업 계획
233
+
234
+ ### 스폰서
235
+ - [Siteboon - AI powered website builder](https://siteboon.ai)
236
+ ---
237
+
238
+ <div align="center">
239
+ <strong>Claude Code, Cursor, Codex 커뮤니티를 위해 정성껏 제작되었습니다.</strong>
240
+ </div>