@pixelbyte-software/pixcode 1.35.1 → 1.35.2

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 (172) 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-CBdsvGSR.js → index-D1-AIL_5.js} +1 -1
  11. package/dist/clear-cache.html +85 -85
  12. package/dist/convert-icons.md +52 -52
  13. package/dist/favicon.svg +8 -8
  14. package/dist/generate-icons.js +48 -48
  15. package/dist/icons/codex-white.svg +3 -3
  16. package/dist/icons/codex.svg +3 -3
  17. package/dist/icons/cursor-white.svg +11 -11
  18. package/dist/icons/icon-128x128.svg +9 -9
  19. package/dist/icons/icon-144x144.svg +9 -9
  20. package/dist/icons/icon-152x152.svg +9 -9
  21. package/dist/icons/icon-192x192.svg +9 -9
  22. package/dist/icons/icon-384x384.svg +9 -9
  23. package/dist/icons/icon-512x512.svg +9 -9
  24. package/dist/icons/icon-72x72.svg +9 -9
  25. package/dist/icons/icon-96x96.svg +9 -9
  26. package/dist/icons/icon-template.svg +9 -9
  27. package/dist/icons/qwen-logo.svg +14 -14
  28. package/dist/index.html +58 -58
  29. package/dist/logo.svg +12 -12
  30. package/dist/manifest.json +60 -60
  31. package/dist/openapi.yaml +1693 -1693
  32. package/dist/sw.js +124 -124
  33. package/dist-server/server/cli.js +96 -96
  34. package/dist-server/server/daemon/manager.js +33 -33
  35. package/dist-server/server/daemon-manager.js +64 -64
  36. package/dist-server/server/routes/commands.js +25 -25
  37. package/dist-server/server/routes/git.js +17 -17
  38. package/dist-server/server/routes/taskmaster.js +419 -419
  39. package/package.json +180 -180
  40. package/scripts/fix-node-pty.js +67 -67
  41. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  42. package/scripts/smoke/orchestration-api.mjs +172 -172
  43. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  44. package/server/claude-sdk.js +898 -898
  45. package/server/cli.js +935 -935
  46. package/server/constants/config.js +4 -4
  47. package/server/cursor-cli.js +342 -342
  48. package/server/daemon/manager.js +564 -564
  49. package/server/daemon-manager.js +959 -959
  50. package/server/database/db.js +794 -794
  51. package/server/database/json-store.js +197 -197
  52. package/server/gemini-cli.js +535 -535
  53. package/server/gemini-response-handler.js +79 -79
  54. package/server/index.js +3135 -3135
  55. package/server/load-env.js +34 -34
  56. package/server/middleware/auth.js +173 -173
  57. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  58. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  59. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  60. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  61. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  62. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  63. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  64. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  65. package/server/modules/orchestration/a2a/routes.ts +577 -577
  66. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  67. package/server/modules/orchestration/a2a/types.ts +125 -125
  68. package/server/modules/orchestration/a2a/validator.ts +113 -113
  69. package/server/modules/orchestration/index.ts +66 -66
  70. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  71. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  72. package/server/modules/orchestration/preview/types.ts +19 -19
  73. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  74. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  75. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  76. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  77. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  78. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  79. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  80. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  81. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  82. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  83. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  84. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  85. package/server/modules/orchestration/workspace/types.ts +52 -52
  86. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  87. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  88. package/server/modules/providers/index.ts +2 -2
  89. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  90. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  91. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  92. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  93. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  94. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  95. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  96. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  97. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  98. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  99. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  100. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  101. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  102. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  103. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  104. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  105. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +130 -130
  106. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  107. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  108. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  109. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +145 -145
  110. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  111. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  112. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  113. package/server/modules/providers/provider.registry.ts +40 -40
  114. package/server/modules/providers/provider.routes.ts +819 -819
  115. package/server/modules/providers/services/mcp.service.ts +86 -86
  116. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  117. package/server/modules/providers/services/sessions.service.ts +45 -45
  118. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  119. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  120. package/server/modules/providers/shared/provider-configs.ts +142 -142
  121. package/server/modules/providers/tests/mcp.test.ts +293 -293
  122. package/server/openai-codex.js +462 -462
  123. package/server/opencode-cli.js +459 -459
  124. package/server/opencode-response-handler.js +107 -107
  125. package/server/projects.js +3105 -3105
  126. package/server/qwen-code-cli.js +395 -395
  127. package/server/qwen-response-handler.js +73 -73
  128. package/server/routes/agent.js +1365 -1365
  129. package/server/routes/auth.js +138 -138
  130. package/server/routes/codex.js +19 -19
  131. package/server/routes/commands.js +554 -554
  132. package/server/routes/cursor.js +52 -52
  133. package/server/routes/gemini.js +24 -24
  134. package/server/routes/git.js +1488 -1488
  135. package/server/routes/mcp-utils.js +31 -31
  136. package/server/routes/messages.js +61 -61
  137. package/server/routes/network.js +120 -120
  138. package/server/routes/plugins.js +318 -318
  139. package/server/routes/projects.js +915 -915
  140. package/server/routes/qwen.js +27 -27
  141. package/server/routes/settings.js +286 -286
  142. package/server/routes/taskmaster.js +1496 -1496
  143. package/server/routes/telegram.js +125 -125
  144. package/server/routes/user.js +123 -123
  145. package/server/services/external-access.js +171 -171
  146. package/server/services/install-jobs.js +571 -571
  147. package/server/services/notification-orchestrator.js +242 -242
  148. package/server/services/provider-credentials.js +189 -189
  149. package/server/services/provider-models.js +381 -381
  150. package/server/services/telegram/bot.js +279 -279
  151. package/server/services/telegram/telegram-http-client.js +130 -130
  152. package/server/services/telegram/translations.js +170 -170
  153. package/server/services/vapid-keys.js +36 -36
  154. package/server/sessionManager.js +225 -225
  155. package/server/shared/interfaces.ts +54 -54
  156. package/server/shared/types.ts +172 -172
  157. package/server/shared/utils.ts +193 -193
  158. package/server/tsconfig.json +36 -36
  159. package/server/utils/colors.js +21 -21
  160. package/server/utils/commandParser.js +303 -303
  161. package/server/utils/frontmatter.js +18 -18
  162. package/server/utils/gitConfig.js +34 -34
  163. package/server/utils/mcp-detector.js +147 -147
  164. package/server/utils/plugin-loader.js +457 -457
  165. package/server/utils/plugin-process-manager.js +184 -184
  166. package/server/utils/port-access.js +209 -209
  167. package/server/utils/runtime-paths.js +37 -37
  168. package/server/utils/taskmaster-websocket.js +128 -128
  169. package/server/utils/url-detection.js +71 -71
  170. package/server/vite-daemon.js +78 -78
  171. package/shared/modelConstants.js +162 -162
  172. 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>