@pixelbyte-software/pixcode 1.35.2 → 1.35.3

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