@pixelbyte-software/pixcode 1.35.0 → 1.35.1

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 (150) 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-Djuh0wHV.js → index-CBdsvGSR.js} +133 -133
  11. package/dist/clear-cache.html +85 -85
  12. package/dist/convert-icons.md +52 -52
  13. package/dist/generate-icons.js +48 -48
  14. package/dist/icons/codex-white.svg +3 -3
  15. package/dist/icons/codex.svg +3 -3
  16. package/dist/icons/cursor-white.svg +11 -11
  17. package/dist/icons/qwen-logo.svg +14 -14
  18. package/dist/index.html +58 -58
  19. package/dist/manifest.json +60 -60
  20. package/dist/openapi.yaml +1693 -1693
  21. package/dist/sw.js +124 -124
  22. package/dist-server/server/cli.js +96 -96
  23. package/dist-server/server/daemon/manager.js +33 -33
  24. package/dist-server/server/daemon-manager.js +64 -64
  25. package/dist-server/server/modules/orchestration/preview/preview-proxy.js +3 -3
  26. package/dist-server/server/modules/orchestration/preview/preview-proxy.js.map +1 -1
  27. package/dist-server/server/routes/commands.js +25 -25
  28. package/dist-server/server/routes/git.js +17 -17
  29. package/dist-server/server/routes/taskmaster.js +419 -419
  30. package/package.json +180 -180
  31. package/scripts/fix-node-pty.js +67 -67
  32. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  33. package/scripts/smoke/orchestration-api.mjs +172 -172
  34. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  35. package/server/claude-sdk.js +898 -898
  36. package/server/cli.js +935 -935
  37. package/server/constants/config.js +4 -4
  38. package/server/cursor-cli.js +342 -342
  39. package/server/daemon/manager.js +564 -564
  40. package/server/daemon-manager.js +959 -959
  41. package/server/database/json-store.js +197 -197
  42. package/server/gemini-cli.js +535 -535
  43. package/server/gemini-response-handler.js +79 -79
  44. package/server/index.js +3135 -3135
  45. package/server/load-env.js +34 -34
  46. package/server/middleware/auth.js +173 -173
  47. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  48. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  49. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  50. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  51. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  52. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  53. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  54. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  55. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  56. package/server/modules/orchestration/a2a/auth.middleware.ts +29 -29
  57. package/server/modules/orchestration/a2a/bus.ts +46 -46
  58. package/server/modules/orchestration/a2a/routes.ts +577 -577
  59. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  60. package/server/modules/orchestration/a2a/types.ts +125 -125
  61. package/server/modules/orchestration/a2a/validator.ts +113 -113
  62. package/server/modules/orchestration/index.ts +66 -66
  63. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  64. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  65. package/server/modules/orchestration/preview/types.ts +19 -19
  66. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  67. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  68. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  69. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  70. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  71. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  72. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  73. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  74. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  75. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  76. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  77. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  78. package/server/modules/orchestration/workspace/types.ts +52 -52
  79. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  80. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  81. package/server/modules/providers/index.ts +2 -2
  82. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  83. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  84. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  85. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  86. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  87. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  88. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  89. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  90. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  91. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  92. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  93. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  94. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  95. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  96. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  97. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  98. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  99. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  100. package/server/modules/providers/provider.registry.ts +40 -40
  101. package/server/modules/providers/provider.routes.ts +819 -819
  102. package/server/modules/providers/services/mcp.service.ts +86 -86
  103. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  104. package/server/modules/providers/services/sessions.service.ts +45 -45
  105. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  106. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  107. package/server/modules/providers/tests/mcp.test.ts +293 -293
  108. package/server/openai-codex.js +462 -462
  109. package/server/opencode-cli.js +459 -459
  110. package/server/opencode-response-handler.js +107 -107
  111. package/server/projects.js +3105 -3105
  112. package/server/routes/agent.js +1365 -1365
  113. package/server/routes/auth.js +138 -138
  114. package/server/routes/codex.js +19 -19
  115. package/server/routes/commands.js +554 -554
  116. package/server/routes/cursor.js +52 -52
  117. package/server/routes/gemini.js +24 -24
  118. package/server/routes/git.js +1488 -1488
  119. package/server/routes/mcp-utils.js +31 -31
  120. package/server/routes/messages.js +61 -61
  121. package/server/routes/network.js +120 -120
  122. package/server/routes/plugins.js +318 -318
  123. package/server/routes/projects.js +915 -915
  124. package/server/routes/settings.js +286 -286
  125. package/server/routes/taskmaster.js +1496 -1496
  126. package/server/routes/telegram.js +125 -125
  127. package/server/routes/user.js +123 -123
  128. package/server/services/install-jobs.js +571 -571
  129. package/server/services/notification-orchestrator.js +242 -242
  130. package/server/services/provider-credentials.js +189 -189
  131. package/server/services/telegram/bot.js +279 -279
  132. package/server/services/telegram/translations.js +170 -170
  133. package/server/sessionManager.js +225 -225
  134. package/server/shared/interfaces.ts +54 -54
  135. package/server/shared/types.ts +172 -172
  136. package/server/shared/utils.ts +193 -193
  137. package/server/tsconfig.json +36 -36
  138. package/server/utils/colors.js +21 -21
  139. package/server/utils/commandParser.js +303 -303
  140. package/server/utils/frontmatter.js +18 -18
  141. package/server/utils/gitConfig.js +34 -34
  142. package/server/utils/mcp-detector.js +147 -147
  143. package/server/utils/plugin-loader.js +457 -457
  144. package/server/utils/plugin-process-manager.js +184 -184
  145. package/server/utils/runtime-paths.js +37 -37
  146. package/server/utils/taskmaster-websocket.js +128 -128
  147. package/server/utils/url-detection.js +71 -71
  148. package/server/vite-daemon.js +78 -78
  149. package/shared/modelConstants.js +162 -162
  150. package/shared/networkHosts.js +22 -22
package/README.ru.md CHANGED
@@ -1,248 +1,248 @@
1
- <div align="center">
2
- <img src="public/logo.svg" alt="Pixcode" width="64" height="64">
3
- <h1>Cloud CLI (aka Claude Code UI)</h1>
4
- <p>Десктопный и мобильный UI для <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>.<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="Join our Discord"></a>
14
- </p>
15
-
16
- <div align="right"><i><a href="./README.md">English</a> · <b>Русский</b> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ko.md">한국어</a> · <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="Desktop Interface" 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="Mobile Interface" 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 Selection" width="400">
43
- <br>
44
- <em>Выбирайте между Claude Code, Gemini, Cursor CLI и Codex</em>
45
- </td>
46
- </tr>
47
- </table>
48
-
49
-
50
-
51
- </div>
52
-
53
- ## Возможности
54
-
55
- - **Адаптивный дизайн** - одинаково хорошо работает на десктопе, планшете и телефоне, поэтому можно пользоваться агентами и с мобильных устройств
56
- - **Интерактивный чат-интерфейс** - встроенный чат для бесшовного общения с агентами
57
- - **Интегрированный shell-терминал** - прямой доступ к CLI агентов через встроенную оболочку
58
- - **Проводник файлов** - интерактивное дерево файлов с подсветкой синтаксиса и редактированием в реальном времени
59
- - **Git Explorer** - просмотр, stage и commit изменений. Также можно переключать ветки
60
- - **Управление сессиями** - возобновляйте диалоги, управляйте несколькими сессиями и отслеживайте историю
61
- - **Система плагинов** - расширяйте Pixcode кастомными плагинами — добавляйте новые вкладки, бэкенд-сервисы и интеграции. [Создать свой →](https://github.com/alicomert/pixcode)
62
- - **Интеграция с TaskMaster AI** *(опционально)* - продвинутое управление проектами с планированием задач на базе AI, разбором PRD и автоматизацией workflow
63
- - **Совместимость с моделями** - работает с семействами моделей Claude, GPT и Gemini (см. [`shared/modelConstants.js`](shared/modelConstants.js) для полного списка поддерживаемых моделей)
64
-
65
-
66
- ## Быстрый старт
67
-
68
- ### Pixcode (рекомендуется)
69
-
70
- Самый быстрый способ начать — локальная настройка не требуется. Получите полностью управляемую контейнеризированную среду разработки с доступом из веба, мобильного приложения, API или вашей любимой IDE.
71
-
72
- **[Начать с Pixcode](https://github.com/alicomert/pixcode)**
73
-
74
-
75
- ### Self-Hosted (Open source)
76
-
77
- #### npm
78
-
79
- Попробовать Pixcode можно сразу через **npx** (требуется **Node.js** v22+):
80
-
81
- ```bash
82
- npx @pixelbyte-software/pixcode
83
- ```
84
-
85
- Или установить **глобально** для регулярного использования:
86
-
87
- ```bash
88
- npm install -g @pixelbyte-software/pixcode
89
- pixcode
90
- ```
91
-
92
- Откройте `http://localhost:3001` — все ваши существующие сессии будут обнаружены автоматически.
93
-
94
- Посетите **[документацию →](https://github.com/alicomert/pixcode)**, чтобы узнать про дополнительные варианты конфигурации, PM2, настройку удалённого сервера и многое другое.
95
-
96
- #### Docker Sandboxes (Экспериментально)
97
-
98
- Запускайте агентов в изолированных песочницах с гипервизорной изоляцией. По умолчанию запускается Claude Code. Требуется [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/).
99
-
100
- ```
101
- npx @pixelbyte-software/pixcode@latest sandbox ~/my-project
102
- ```
103
-
104
- Поддерживаются Claude Code, Codex и Gemini CLI. Подробнее в [документации sandbox](docker/).
105
-
106
- ---
107
-
108
- ## Какой вариант подходит вам?
109
-
110
- Pixcode — это open source UI-слой, на котором построен Pixcode. Вы можете развернуть его на своей машине или использовать Pixcode, который добавляет полностью управляемую облачную среду, командные функции и более глубокие интеграции.
111
-
112
- | | Pixcode (Self-hosted) | Pixcode |
113
- |---|---|---|
114
- | **Лучше всего подходит для** | Разработчиков, которым нужен полноценный UI для локальных агентских сессий на своей машине | Команд и разработчиков, которым нужны агенты в облаке с доступом откуда угодно |
115
- | **Как вы получаете доступ** | Браузер через `[yourip]:port` | Браузер, любая IDE, REST API, n8n |
116
- | **Настройка** | `npx @pixelbyte-software/pixcode` | Настройка не требуется |
117
- | **Машина должна оставаться включённой** | Да | Нет |
118
- | **Доступ с мобильных устройств** | Любой браузер в вашей сети | Любое устройство, нативное приложение в разработке |
119
- | **Доступные сессии** | Все сессии автоматически обнаруживаются из `~/.claude` | Все сессии внутри вашей облачной среды |
120
- | **Поддерживаемые агенты** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
121
- | **Проводник файлов и Git** | Да, встроены в UI | Да, встроены в UI |
122
- | **Конфигурация MCP** | Управляется через UI, синхронизируется с вашим локальным конфигом `~/.claude` | Управляется через UI |
123
- | **Доступ из IDE** | Ваша локальная IDE | Любая IDE, подключенная к вашей облачной среде |
124
- | **REST API** | Да | Да |
125
- | **n8n node** | Нет | Да |
126
- | **Совместная работа** | Нет | Да |
127
- | **Стоимость платформы** | Бесплатно, open source | От $7/месяц |
128
-
129
- > В обоих вариантах используются ваши собственные AI-подписки (Claude, Cursor и т.д.) — Pixcode предоставляет среду, а не сам AI.
130
-
131
- ---
132
-
133
- ## Безопасность и конфигурация инструментов
134
-
135
- **🔒 Важное примечание**: все инструменты Claude Code **по умолчанию отключены**. Это предотвращает автоматический запуск потенциально опасных операций.
136
-
137
- ### Включение инструментов
138
-
139
- Чтобы использовать всю функциональность Claude Code, вам нужно вручную включить инструменты:
140
-
141
- 1. **Откройте настройки инструментов** - нажмите на иконку шестерёнки в боковой панели
142
- 2. **Включайте выборочно** - активируйте только те инструменты, которые вам нужны
143
- 3. **Примените настройки** - ваши предпочтения сохраняются локально
144
-
145
- <div align="center">
146
-
147
- ![Tools Settings Modal](public/screenshots/tools-modal.png)
148
- *Интерфейс настройки инструментов — включайте только то, что вам нужно*
149
-
150
- </div>
151
-
152
- **Рекомендуемый подход**: начните с базовых инструментов и добавляйте остальные по мере необходимости. Эти настройки всегда можно изменить позже.
153
-
154
- ---
155
-
156
- ## Плагины
157
-
158
- У Pixcode есть система плагинов, которая позволяет добавлять кастомные вкладки со своим frontend UI и (опционально) Node.js бэкендом. Устанавливайте плагины напрямую из git-репозиториев в **Settings > Plugins** или создавайте свои.
159
-
160
- ### Доступные плагины
161
-
162
- | Плагин | Описание |
163
- |---|---|
164
- | **[Project Stats](https://github.com/alicomert/pixcode)** | Показывает количество файлов, строки кода, разбивку по типам файлов, самые большие файлы и недавно изменённые файлы для текущего проекта |
165
-
166
- ### Создать свой
167
-
168
- **[Plugin Starter Template →](https://github.com/alicomert/pixcode)** — сделайте форк этого репозитория, чтобы создать свой плагин. В шаблоне есть рабочий пример с рендерингом на фронтенде, live-обновлением контекста и RPC-коммуникацией с бэкенд-сервером.
169
-
170
- **[Plugin Documentation →](https://github.com/alicomert/pixcode)** — полный гайд по plugin API, формату манифеста, модели безопасности и другому.
171
-
172
- ---
173
- ## FAQ
174
-
175
- <details>
176
- <summary>Чем это отличается от Claude Code Remote Control?</summary>
177
-
178
- Claude Code Remote Control позволяет отправлять сообщения в сессию, которая уже запущена в вашем локальном терминале. Ваша машина должна оставаться включённой, терминал — открытым, а сессии завершаются примерно через 10 минут без сетевого соединения.
179
-
180
- Pixcode и Pixcode расширяют Claude Code, а не работают рядом с ним — ваши MCP-серверы, разрешения, настройки и сессии остаются теми же самыми, что и в нативном Claude Code. Ничего не дублируется и не управляется отдельно.
181
-
182
- Вот что это означает на практике:
183
-
184
- - **Все ваши сессии, а не одна** — Pixcode автоматически находит каждую сессию из папки `~/.claude`. Remote Control предоставляет только одну активную сессию, чтобы сделать её доступной в мобильном приложении Claude.
185
- - **Ваши настройки — это ваши настройки** — MCP-серверы, права инструментов и конфигурация проекта, изменённые в Pixcode, записываются напрямую в конфиг Claude Code и вступают в силу сразу же, и наоборот.
186
- - **Работает с большим числом агентов** — Claude Code, Cursor CLI, Codex и Gemini CLI, а не только Claude Code.
187
- - **Полноценный UI, а не просто окно чата** — проводник файлов, Git-интеграция, управление MCP и shell-терминал — всё встроено.
188
- - **Pixcode работает в облаке** — закройте ноутбук, и агент продолжит работать. Не нужно следить за терминалом и держать машину постоянно активной.
189
-
190
- </details>
191
-
192
- <details>
193
- <summary>Нужно ли отдельно платить за AI-подписку?</summary>
194
-
195
- Да. Pixcode предоставляет среду, а не сам AI. Вы приносите свою подписку Claude, Cursor, Codex или Gemini. Pixcode начинается от $7/месяц за хостируемую среду поверх этого.
196
-
197
- </details>
198
-
199
- <details>
200
- <summary>Можно ли пользоваться Pixcode с телефона?</summary>
201
-
202
- Да. Для self-hosted запустите сервер на своей машине и откройте `[yourip]:port` в любом браузере в вашей сети. Для Pixcode откройте сервис с любого устройства — без VPN, проброса портов и дополнительной настройки. Нативное приложение тоже в разработке.
203
-
204
- </details>
205
-
206
- <details>
207
- <summary>Повлияют ли изменения, сделанные в UI, на мой локальный Claude Code?</summary>
208
-
209
- Да, в self-hosted режиме. Pixcode читает и записывает тот же конфиг `~/.claude`, который Claude Code использует нативно. MCP-серверы, добавленные через UI, сразу появляются в Claude Code, и наоборот.
210
-
211
- </details>
212
-
213
- ---
214
-
215
- ## Сообщество и поддержка
216
-
217
- - **[Документация](https://github.com/alicomert/pixcode)** — установка, настройка, возможности и устранение неполадок
218
- - **[Discord](https://discord.gg/buxwujPNRE)** — помощь и общение с другими пользователями
219
- - **[GitHub Issues](https://github.com/alicomert/pixcode/issues)** — сообщения об ошибках и запросы новых функций
220
- - **[Руководство для контрибьюторов](CONTRIBUTING.md)** — как участвовать в развитии проекта
221
-
222
- ## Лицензия
223
-
224
- GNU General Public License v3.0 - подробности в файле [LICENSE](LICENSE).
225
-
226
- Этот проект open source и бесплатен для использования, модификации и распространения в рамках лицензии GPL v3.
227
-
228
- ## Благодарности
229
-
230
- ### Используется
231
- - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - официальный CLI от Anthropic
232
- - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - официальный CLI от Cursor
233
- - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
234
- - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
235
- - **[React](https://react.dev/)** - библиотека пользовательских интерфейсов
236
- - **[Vite](https://vitejs.dev/)** - быстрый инструмент сборки и dev-сервер
237
- - **[Tailwind CSS](https://tailwindcss.com/)** - utility-first CSS framework
238
- - **[CodeMirror](https://codemirror.net/)** - продвинутый редактор кода
239
- - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(опционально)* - AI-управление проектами и планирование задач
240
-
241
-
242
- ### Спонсоры
243
- - [Siteboon - AI powered website builder](https://siteboon.ai)
244
- ---
245
-
246
- <div align="center">
247
- <strong>Сделано с заботой для сообщества Claude Code, Cursor и Codex.</strong>
248
- </div>
1
+ <div align="center">
2
+ <img src="public/logo.svg" alt="Pixcode" width="64" height="64">
3
+ <h1>Cloud CLI (aka Claude Code UI)</h1>
4
+ <p>Десктопный и мобильный UI для <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>.<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="Join our Discord"></a>
14
+ </p>
15
+
16
+ <div align="right"><i><a href="./README.md">English</a> · <b>Русский</b> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ko.md">한국어</a> · <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="Desktop Interface" 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="Mobile Interface" 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 Selection" width="400">
43
+ <br>
44
+ <em>Выбирайте между Claude Code, Gemini, Cursor CLI и Codex</em>
45
+ </td>
46
+ </tr>
47
+ </table>
48
+
49
+
50
+
51
+ </div>
52
+
53
+ ## Возможности
54
+
55
+ - **Адаптивный дизайн** - одинаково хорошо работает на десктопе, планшете и телефоне, поэтому можно пользоваться агентами и с мобильных устройств
56
+ - **Интерактивный чат-интерфейс** - встроенный чат для бесшовного общения с агентами
57
+ - **Интегрированный shell-терминал** - прямой доступ к CLI агентов через встроенную оболочку
58
+ - **Проводник файлов** - интерактивное дерево файлов с подсветкой синтаксиса и редактированием в реальном времени
59
+ - **Git Explorer** - просмотр, stage и commit изменений. Также можно переключать ветки
60
+ - **Управление сессиями** - возобновляйте диалоги, управляйте несколькими сессиями и отслеживайте историю
61
+ - **Система плагинов** - расширяйте Pixcode кастомными плагинами — добавляйте новые вкладки, бэкенд-сервисы и интеграции. [Создать свой →](https://github.com/alicomert/pixcode)
62
+ - **Интеграция с TaskMaster AI** *(опционально)* - продвинутое управление проектами с планированием задач на базе AI, разбором PRD и автоматизацией workflow
63
+ - **Совместимость с моделями** - работает с семействами моделей Claude, GPT и Gemini (см. [`shared/modelConstants.js`](shared/modelConstants.js) для полного списка поддерживаемых моделей)
64
+
65
+
66
+ ## Быстрый старт
67
+
68
+ ### Pixcode (рекомендуется)
69
+
70
+ Самый быстрый способ начать — локальная настройка не требуется. Получите полностью управляемую контейнеризированную среду разработки с доступом из веба, мобильного приложения, API или вашей любимой IDE.
71
+
72
+ **[Начать с Pixcode](https://github.com/alicomert/pixcode)**
73
+
74
+
75
+ ### Self-Hosted (Open source)
76
+
77
+ #### npm
78
+
79
+ Попробовать Pixcode можно сразу через **npx** (требуется **Node.js** v22+):
80
+
81
+ ```bash
82
+ npx @pixelbyte-software/pixcode
83
+ ```
84
+
85
+ Или установить **глобально** для регулярного использования:
86
+
87
+ ```bash
88
+ npm install -g @pixelbyte-software/pixcode
89
+ pixcode
90
+ ```
91
+
92
+ Откройте `http://localhost:3001` — все ваши существующие сессии будут обнаружены автоматически.
93
+
94
+ Посетите **[документацию →](https://github.com/alicomert/pixcode)**, чтобы узнать про дополнительные варианты конфигурации, PM2, настройку удалённого сервера и многое другое.
95
+
96
+ #### Docker Sandboxes (Экспериментально)
97
+
98
+ Запускайте агентов в изолированных песочницах с гипервизорной изоляцией. По умолчанию запускается Claude Code. Требуется [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/).
99
+
100
+ ```
101
+ npx @pixelbyte-software/pixcode@latest sandbox ~/my-project
102
+ ```
103
+
104
+ Поддерживаются Claude Code, Codex и Gemini CLI. Подробнее в [документации sandbox](docker/).
105
+
106
+ ---
107
+
108
+ ## Какой вариант подходит вам?
109
+
110
+ Pixcode — это open source UI-слой, на котором построен Pixcode. Вы можете развернуть его на своей машине или использовать Pixcode, который добавляет полностью управляемую облачную среду, командные функции и более глубокие интеграции.
111
+
112
+ | | Pixcode (Self-hosted) | Pixcode |
113
+ |---|---|---|
114
+ | **Лучше всего подходит для** | Разработчиков, которым нужен полноценный UI для локальных агентских сессий на своей машине | Команд и разработчиков, которым нужны агенты в облаке с доступом откуда угодно |
115
+ | **Как вы получаете доступ** | Браузер через `[yourip]:port` | Браузер, любая IDE, REST API, n8n |
116
+ | **Настройка** | `npx @pixelbyte-software/pixcode` | Настройка не требуется |
117
+ | **Машина должна оставаться включённой** | Да | Нет |
118
+ | **Доступ с мобильных устройств** | Любой браузер в вашей сети | Любое устройство, нативное приложение в разработке |
119
+ | **Доступные сессии** | Все сессии автоматически обнаруживаются из `~/.claude` | Все сессии внутри вашей облачной среды |
120
+ | **Поддерживаемые агенты** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
121
+ | **Проводник файлов и Git** | Да, встроены в UI | Да, встроены в UI |
122
+ | **Конфигурация MCP** | Управляется через UI, синхронизируется с вашим локальным конфигом `~/.claude` | Управляется через UI |
123
+ | **Доступ из IDE** | Ваша локальная IDE | Любая IDE, подключенная к вашей облачной среде |
124
+ | **REST API** | Да | Да |
125
+ | **n8n node** | Нет | Да |
126
+ | **Совместная работа** | Нет | Да |
127
+ | **Стоимость платформы** | Бесплатно, open source | От $7/месяц |
128
+
129
+ > В обоих вариантах используются ваши собственные AI-подписки (Claude, Cursor и т.д.) — Pixcode предоставляет среду, а не сам AI.
130
+
131
+ ---
132
+
133
+ ## Безопасность и конфигурация инструментов
134
+
135
+ **🔒 Важное примечание**: все инструменты Claude Code **по умолчанию отключены**. Это предотвращает автоматический запуск потенциально опасных операций.
136
+
137
+ ### Включение инструментов
138
+
139
+ Чтобы использовать всю функциональность Claude Code, вам нужно вручную включить инструменты:
140
+
141
+ 1. **Откройте настройки инструментов** - нажмите на иконку шестерёнки в боковой панели
142
+ 2. **Включайте выборочно** - активируйте только те инструменты, которые вам нужны
143
+ 3. **Примените настройки** - ваши предпочтения сохраняются локально
144
+
145
+ <div align="center">
146
+
147
+ ![Tools Settings Modal](public/screenshots/tools-modal.png)
148
+ *Интерфейс настройки инструментов — включайте только то, что вам нужно*
149
+
150
+ </div>
151
+
152
+ **Рекомендуемый подход**: начните с базовых инструментов и добавляйте остальные по мере необходимости. Эти настройки всегда можно изменить позже.
153
+
154
+ ---
155
+
156
+ ## Плагины
157
+
158
+ У Pixcode есть система плагинов, которая позволяет добавлять кастомные вкладки со своим frontend UI и (опционально) Node.js бэкендом. Устанавливайте плагины напрямую из git-репозиториев в **Settings > Plugins** или создавайте свои.
159
+
160
+ ### Доступные плагины
161
+
162
+ | Плагин | Описание |
163
+ |---|---|
164
+ | **[Project Stats](https://github.com/alicomert/pixcode)** | Показывает количество файлов, строки кода, разбивку по типам файлов, самые большие файлы и недавно изменённые файлы для текущего проекта |
165
+
166
+ ### Создать свой
167
+
168
+ **[Plugin Starter Template →](https://github.com/alicomert/pixcode)** — сделайте форк этого репозитория, чтобы создать свой плагин. В шаблоне есть рабочий пример с рендерингом на фронтенде, live-обновлением контекста и RPC-коммуникацией с бэкенд-сервером.
169
+
170
+ **[Plugin Documentation →](https://github.com/alicomert/pixcode)** — полный гайд по plugin API, формату манифеста, модели безопасности и другому.
171
+
172
+ ---
173
+ ## FAQ
174
+
175
+ <details>
176
+ <summary>Чем это отличается от Claude Code Remote Control?</summary>
177
+
178
+ Claude Code Remote Control позволяет отправлять сообщения в сессию, которая уже запущена в вашем локальном терминале. Ваша машина должна оставаться включённой, терминал — открытым, а сессии завершаются примерно через 10 минут без сетевого соединения.
179
+
180
+ Pixcode и Pixcode расширяют Claude Code, а не работают рядом с ним — ваши MCP-серверы, разрешения, настройки и сессии остаются теми же самыми, что и в нативном Claude Code. Ничего не дублируется и не управляется отдельно.
181
+
182
+ Вот что это означает на практике:
183
+
184
+ - **Все ваши сессии, а не одна** — Pixcode автоматически находит каждую сессию из папки `~/.claude`. Remote Control предоставляет только одну активную сессию, чтобы сделать её доступной в мобильном приложении Claude.
185
+ - **Ваши настройки — это ваши настройки** — MCP-серверы, права инструментов и конфигурация проекта, изменённые в Pixcode, записываются напрямую в конфиг Claude Code и вступают в силу сразу же, и наоборот.
186
+ - **Работает с большим числом агентов** — Claude Code, Cursor CLI, Codex и Gemini CLI, а не только Claude Code.
187
+ - **Полноценный UI, а не просто окно чата** — проводник файлов, Git-интеграция, управление MCP и shell-терминал — всё встроено.
188
+ - **Pixcode работает в облаке** — закройте ноутбук, и агент продолжит работать. Не нужно следить за терминалом и держать машину постоянно активной.
189
+
190
+ </details>
191
+
192
+ <details>
193
+ <summary>Нужно ли отдельно платить за AI-подписку?</summary>
194
+
195
+ Да. Pixcode предоставляет среду, а не сам AI. Вы приносите свою подписку Claude, Cursor, Codex или Gemini. Pixcode начинается от $7/месяц за хостируемую среду поверх этого.
196
+
197
+ </details>
198
+
199
+ <details>
200
+ <summary>Можно ли пользоваться Pixcode с телефона?</summary>
201
+
202
+ Да. Для self-hosted запустите сервер на своей машине и откройте `[yourip]:port` в любом браузере в вашей сети. Для Pixcode откройте сервис с любого устройства — без VPN, проброса портов и дополнительной настройки. Нативное приложение тоже в разработке.
203
+
204
+ </details>
205
+
206
+ <details>
207
+ <summary>Повлияют ли изменения, сделанные в UI, на мой локальный Claude Code?</summary>
208
+
209
+ Да, в self-hosted режиме. Pixcode читает и записывает тот же конфиг `~/.claude`, который Claude Code использует нативно. MCP-серверы, добавленные через UI, сразу появляются в Claude Code, и наоборот.
210
+
211
+ </details>
212
+
213
+ ---
214
+
215
+ ## Сообщество и поддержка
216
+
217
+ - **[Документация](https://github.com/alicomert/pixcode)** — установка, настройка, возможности и устранение неполадок
218
+ - **[Discord](https://discord.gg/buxwujPNRE)** — помощь и общение с другими пользователями
219
+ - **[GitHub Issues](https://github.com/alicomert/pixcode/issues)** — сообщения об ошибках и запросы новых функций
220
+ - **[Руководство для контрибьюторов](CONTRIBUTING.md)** — как участвовать в развитии проекта
221
+
222
+ ## Лицензия
223
+
224
+ GNU General Public License v3.0 - подробности в файле [LICENSE](LICENSE).
225
+
226
+ Этот проект open source и бесплатен для использования, модификации и распространения в рамках лицензии GPL v3.
227
+
228
+ ## Благодарности
229
+
230
+ ### Используется
231
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - официальный CLI от Anthropic
232
+ - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - официальный CLI от Cursor
233
+ - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
234
+ - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
235
+ - **[React](https://react.dev/)** - библиотека пользовательских интерфейсов
236
+ - **[Vite](https://vitejs.dev/)** - быстрый инструмент сборки и dev-сервер
237
+ - **[Tailwind CSS](https://tailwindcss.com/)** - utility-first CSS framework
238
+ - **[CodeMirror](https://codemirror.net/)** - продвинутый редактор кода
239
+ - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(опционально)* - AI-управление проектами и планирование задач
240
+
241
+
242
+ ### Спонсоры
243
+ - [Siteboon - AI powered website builder](https://siteboon.ai)
244
+ ---
245
+
246
+ <div align="center">
247
+ <strong>Сделано с заботой для сообщества Claude Code, Cursor и Codex.</strong>
248
+ </div>