@cloudcli-ai/cloudcli 1.28.0

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 (163) hide show
  1. package/LICENSE +718 -0
  2. package/README.de.md +239 -0
  3. package/README.ja.md +231 -0
  4. package/README.ko.md +230 -0
  5. package/README.md +242 -0
  6. package/README.ru.md +239 -0
  7. package/README.zh-CN.md +230 -0
  8. package/dist/api-docs.html +879 -0
  9. package/dist/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  10. package/dist/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  11. package/dist/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  12. package/dist/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  13. package/dist/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  14. package/dist/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  15. package/dist/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  16. package/dist/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  17. package/dist/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  18. package/dist/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  19. package/dist/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  20. package/dist/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  21. package/dist/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  22. package/dist/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  23. package/dist/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  24. package/dist/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  25. package/dist/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  26. package/dist/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  27. package/dist/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  28. package/dist/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  29. package/dist/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  30. package/dist/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  31. package/dist/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  32. package/dist/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  33. package/dist/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  34. package/dist/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  35. package/dist/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  36. package/dist/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  37. package/dist/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  38. package/dist/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  39. package/dist/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  40. package/dist/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  41. package/dist/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  42. package/dist/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  43. package/dist/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  44. package/dist/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  45. package/dist/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  46. package/dist/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  47. package/dist/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  48. package/dist/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  49. package/dist/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  50. package/dist/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  51. package/dist/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  52. package/dist/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  53. package/dist/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  54. package/dist/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  55. package/dist/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  56. package/dist/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  57. package/dist/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  58. package/dist/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  59. package/dist/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  60. package/dist/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  61. package/dist/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  62. package/dist/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  63. package/dist/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  64. package/dist/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  65. package/dist/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  66. package/dist/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  67. package/dist/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  68. package/dist/assets/index-B1XAhG_4.css +32 -0
  69. package/dist/assets/index-BWQPmiP5.js +1275 -0
  70. package/dist/assets/vendor-codemirror-C8f1vU1x.js +41 -0
  71. package/dist/assets/vendor-react-CdSTmIF1.js +59 -0
  72. package/dist/assets/vendor-xterm-CJZjLICi.js +66 -0
  73. package/dist/clear-cache.html +85 -0
  74. package/dist/convert-icons.md +53 -0
  75. package/dist/favicon.png +0 -0
  76. package/dist/favicon.svg +9 -0
  77. package/dist/generate-icons.js +49 -0
  78. package/dist/icons/claude-ai-icon.svg +1 -0
  79. package/dist/icons/codex-white.svg +3 -0
  80. package/dist/icons/codex.svg +3 -0
  81. package/dist/icons/cursor-white.svg +12 -0
  82. package/dist/icons/cursor.svg +1 -0
  83. package/dist/icons/gemini-ai-icon.svg +1 -0
  84. package/dist/icons/icon-128x128.png +0 -0
  85. package/dist/icons/icon-128x128.svg +12 -0
  86. package/dist/icons/icon-144x144.png +0 -0
  87. package/dist/icons/icon-144x144.svg +12 -0
  88. package/dist/icons/icon-152x152.png +0 -0
  89. package/dist/icons/icon-152x152.svg +12 -0
  90. package/dist/icons/icon-192x192.png +0 -0
  91. package/dist/icons/icon-192x192.svg +12 -0
  92. package/dist/icons/icon-384x384.png +0 -0
  93. package/dist/icons/icon-384x384.svg +12 -0
  94. package/dist/icons/icon-512x512.png +0 -0
  95. package/dist/icons/icon-512x512.svg +12 -0
  96. package/dist/icons/icon-72x72.png +0 -0
  97. package/dist/icons/icon-72x72.svg +12 -0
  98. package/dist/icons/icon-96x96.png +0 -0
  99. package/dist/icons/icon-96x96.svg +12 -0
  100. package/dist/icons/icon-template.svg +12 -0
  101. package/dist/index.html +52 -0
  102. package/dist/logo-128.png +0 -0
  103. package/dist/logo-256.png +0 -0
  104. package/dist/logo-32.png +0 -0
  105. package/dist/logo-512.png +0 -0
  106. package/dist/logo-64.png +0 -0
  107. package/dist/logo.svg +17 -0
  108. package/dist/manifest.json +61 -0
  109. package/dist/screenshots/cli-selection.png +0 -0
  110. package/dist/screenshots/desktop-main.png +0 -0
  111. package/dist/screenshots/mobile-chat.png +0 -0
  112. package/dist/screenshots/tools-modal.png +0 -0
  113. package/dist/sw.js +124 -0
  114. package/package.json +153 -0
  115. package/scripts/fix-node-pty.js +67 -0
  116. package/server/claude-sdk.js +817 -0
  117. package/server/cli.js +330 -0
  118. package/server/constants/config.js +5 -0
  119. package/server/cursor-cli.js +335 -0
  120. package/server/database/db.js +630 -0
  121. package/server/database/init.sql +99 -0
  122. package/server/gemini-cli.js +453 -0
  123. package/server/gemini-response-handler.js +79 -0
  124. package/server/index.js +2577 -0
  125. package/server/load-env.js +29 -0
  126. package/server/middleware/auth.js +132 -0
  127. package/server/openai-codex.js +418 -0
  128. package/server/projects.js +2561 -0
  129. package/server/providers/claude/adapter.js +278 -0
  130. package/server/providers/codex/adapter.js +248 -0
  131. package/server/providers/cursor/adapter.js +353 -0
  132. package/server/providers/gemini/adapter.js +186 -0
  133. package/server/providers/registry.js +44 -0
  134. package/server/providers/types.js +119 -0
  135. package/server/providers/utils.js +29 -0
  136. package/server/routes/agent.js +1245 -0
  137. package/server/routes/auth.js +135 -0
  138. package/server/routes/cli-auth.js +434 -0
  139. package/server/routes/codex.js +329 -0
  140. package/server/routes/commands.js +601 -0
  141. package/server/routes/cursor.js +798 -0
  142. package/server/routes/gemini.js +24 -0
  143. package/server/routes/git.js +1488 -0
  144. package/server/routes/mcp-utils.js +48 -0
  145. package/server/routes/mcp.js +552 -0
  146. package/server/routes/messages.js +61 -0
  147. package/server/routes/plugins.js +307 -0
  148. package/server/routes/projects.js +548 -0
  149. package/server/routes/settings.js +276 -0
  150. package/server/routes/taskmaster.js +1963 -0
  151. package/server/routes/user.js +123 -0
  152. package/server/services/notification-orchestrator.js +227 -0
  153. package/server/services/vapid-keys.js +35 -0
  154. package/server/sessionManager.js +226 -0
  155. package/server/utils/commandParser.js +303 -0
  156. package/server/utils/frontmatter.js +18 -0
  157. package/server/utils/gitConfig.js +34 -0
  158. package/server/utils/mcp-detector.js +198 -0
  159. package/server/utils/plugin-loader.js +457 -0
  160. package/server/utils/plugin-process-manager.js +184 -0
  161. package/server/utils/taskmaster-websocket.js +129 -0
  162. package/shared/modelConstants.js +92 -0
  163. package/shared/networkHosts.js +22 -0
package/README.ru.md ADDED
@@ -0,0 +1,239 @@
1
+ <div align="center">
2
+ <img src="public/logo.svg" alt="CloudCLI UI" 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://cloudcli.ai">CloudCLI Cloud</a> · <a href="https://cloudcli.ai/docs">Документация</a> · <a href="https://discord.gg/buxwujPNRE">Discord</a> · <a href="https://github.com/siteboon/claudecodeui/issues">Сообщить об ошибке</a> · <a href="CONTRIBUTING.md">Участие в разработке</a>
9
+ </p>
10
+
11
+ <p align="center">
12
+ <a href="https://cloudcli.ai"><img src="https://img.shields.io/badge/☁️_CloudCLI_Cloud-Try_Now-0066FF?style=for-the-badge" alt="CloudCLI Cloud"></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
+ <br><br>
15
+ <a href="https://trendshift.io/repositories/15586" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15586" alt="siteboon%2Fclaudecodeui | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
16
+ </p>
17
+
18
+ <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></i></div>
19
+
20
+ ---
21
+
22
+ ## Скриншоты
23
+
24
+ <div align="center">
25
+
26
+ <table>
27
+ <tr>
28
+ <td align="center">
29
+ <h3>Версия для десктопа</h3>
30
+ <img src="public/screenshots/desktop-main.png" alt="Desktop Interface" width="400">
31
+ <br>
32
+ <em>Основной интерфейс с обзором проекта и чатом</em>
33
+ </td>
34
+ <td align="center">
35
+ <h3>Мобильный режим</h3>
36
+ <img src="public/screenshots/mobile-chat.png" alt="Mobile Interface" width="250">
37
+ <br>
38
+ <em>Адаптивный мобильный дизайн с сенсорной навигацией</em>
39
+ </td>
40
+ </tr>
41
+ <tr>
42
+ <td align="center" colspan="2">
43
+ <h3>Выбор CLI</h3>
44
+ <img src="public/screenshots/cli-selection.png" alt="CLI Selection" width="400">
45
+ <br>
46
+ <em>Выбирайте между Claude Code, Gemini, Cursor CLI и Codex</em>
47
+ </td>
48
+ </tr>
49
+ </table>
50
+
51
+
52
+
53
+ </div>
54
+
55
+ ## Возможности
56
+
57
+ - **Адаптивный дизайн** - одинаково хорошо работает на десктопе, планшете и телефоне, поэтому можно пользоваться агентами и с мобильных устройств
58
+ - **Интерактивный чат-интерфейс** - встроенный чат для бесшовного общения с агентами
59
+ - **Интегрированный shell-терминал** - прямой доступ к CLI агентов через встроенную оболочку
60
+ - **Проводник файлов** - интерактивное дерево файлов с подсветкой синтаксиса и редактированием в реальном времени
61
+ - **Git Explorer** - просмотр, stage и commit изменений. Также можно переключать ветки
62
+ - **Управление сессиями** - возобновляйте диалоги, управляйте несколькими сессиями и отслеживайте историю
63
+ - **Система плагинов** - расширяйте CloudCLI кастомными плагинами — добавляйте новые вкладки, бэкенд-сервисы и интеграции. [Создать свой →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)
64
+ - **Интеграция с TaskMaster AI** *(опционально)* - продвинутое управление проектами с планированием задач на базе AI, разбором PRD и автоматизацией workflow
65
+ - **Совместимость с моделями** - работает с семействами моделей Claude, GPT и Gemini (см. [`shared/modelConstants.js`](shared/modelConstants.js) для полного списка поддерживаемых моделей)
66
+
67
+
68
+ ## Быстрый старт
69
+
70
+ ### CloudCLI Cloud (рекомендуется)
71
+
72
+ Самый быстрый способ начать — локальная настройка не требуется. Получите полностью управляемую контейнеризированную среду разработки с доступом из веба, мобильного приложения, API или вашей любимой IDE.
73
+
74
+ **[Начать с CloudCLI Cloud](https://cloudcli.ai)**
75
+
76
+
77
+ ### Self-Hosted (Open source)
78
+
79
+ Попробовать CloudCLI UI можно сразу через **npx** (требуется **Node.js** v22+):
80
+
81
+ ```bash
82
+ npx @cloudcli-ai/cloudcli
83
+ ```
84
+
85
+ Или установить **глобально** для регулярного использования:
86
+
87
+ ```bash
88
+ npm install -g @cloudcli-ai/cloudcli
89
+ cloudcli
90
+ ```
91
+
92
+ Откройте `http://localhost:3001` — все ваши существующие сессии будут обнаружены автоматически.
93
+
94
+ Посетите **[документацию →](https://cloudcli.ai/docs)**, чтобы узнать про дополнительные варианты конфигурации, PM2, настройку удалённого сервера и многое другое
95
+
96
+
97
+ ---
98
+
99
+ ## Какой вариант подходит вам?
100
+
101
+ CloudCLI UI — это open source UI-слой, на котором построен CloudCLI Cloud. Вы можете развернуть его на своей машине или использовать CloudCLI Cloud, который добавляет полностью управляемую облачную среду, командные функции и более глубокие интеграции.
102
+
103
+ | | CloudCLI UI (Self-hosted) | CloudCLI Cloud |
104
+ |---|---|---|
105
+ | **Лучше всего подходит для** | Разработчиков, которым нужен полноценный UI для локальных агентских сессий на своей машине | Команд и разработчиков, которым нужны агенты в облаке с доступом откуда угодно |
106
+ | **Как вы получаете доступ** | Браузер через `[yourip]:port` | Браузер, любая IDE, REST API, n8n |
107
+ | **Настройка** | `npx @cloudcli-ai/cloudcli` | Настройка не требуется |
108
+ | **Машина должна оставаться включённой** | Да | Нет |
109
+ | **Доступ с мобильных устройств** | Любой браузер в вашей сети | Любое устройство, нативное приложение в разработке |
110
+ | **Доступные сессии** | Все сессии автоматически обнаруживаются из `~/.claude` | Все сессии внутри вашей облачной среды |
111
+ | **Поддерживаемые агенты** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
112
+ | **Проводник файлов и Git** | Да, встроены в UI | Да, встроены в UI |
113
+ | **Конфигурация MCP** | Управляется через UI, синхронизируется с вашим локальным конфигом `~/.claude` | Управляется через UI |
114
+ | **Доступ из IDE** | Ваша локальная IDE | Любая IDE, подключенная к вашей облачной среде |
115
+ | **REST API** | Да | Да |
116
+ | **n8n node** | Нет | Да |
117
+ | **Совместная работа** | Нет | Да |
118
+ | **Стоимость платформы** | Бесплатно, open source | От $7/месяц |
119
+
120
+ > В обоих вариантах используются ваши собственные AI-подписки (Claude, Cursor и т.д.) — CloudCLI предоставляет среду, а не сам AI.
121
+
122
+ ---
123
+
124
+ ## Безопасность и конфигурация инструментов
125
+
126
+ **🔒 Важное примечание**: все инструменты Claude Code **по умолчанию отключены**. Это предотвращает автоматический запуск потенциально опасных операций.
127
+
128
+ ### Включение инструментов
129
+
130
+ Чтобы использовать всю функциональность Claude Code, вам нужно вручную включить инструменты:
131
+
132
+ 1. **Откройте настройки инструментов** - нажмите на иконку шестерёнки в боковой панели
133
+ 2. **Включайте выборочно** - активируйте только те инструменты, которые вам нужны
134
+ 3. **Примените настройки** - ваши предпочтения сохраняются локально
135
+
136
+ <div align="center">
137
+
138
+ ![Tools Settings Modal](public/screenshots/tools-modal.png)
139
+ *Интерфейс настройки инструментов — включайте только то, что вам нужно*
140
+
141
+ </div>
142
+
143
+ **Рекомендуемый подход**: начните с базовых инструментов и добавляйте остальные по мере необходимости. Эти настройки всегда можно изменить позже.
144
+
145
+ ---
146
+
147
+ ## Плагины
148
+
149
+ У CloudCLI есть система плагинов, которая позволяет добавлять кастомные вкладки со своим frontend UI и (опционально) Node.js бэкендом. Устанавливайте плагины напрямую из git-репозиториев в **Settings > Plugins** или создавайте свои.
150
+
151
+ ### Доступные плагины
152
+
153
+ | Плагин | Описание |
154
+ |---|---|
155
+ | **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Показывает количество файлов, строки кода, разбивку по типам файлов, самые большие файлы и недавно изменённые файлы для текущего проекта |
156
+
157
+ ### Создать свой
158
+
159
+ **[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — сделайте форк этого репозитория, чтобы создать свой плагин. В шаблоне есть рабочий пример с рендерингом на фронтенде, live-обновлением контекста и RPC-коммуникацией с бэкенд-сервером.
160
+
161
+ **[Plugin Documentation →](https://cloudcli.ai/docs/plugin-overview)** — полный гайд по plugin API, формату манифеста, модели безопасности и другому.
162
+
163
+ ---
164
+ ## FAQ
165
+
166
+ <details>
167
+ <summary>Чем это отличается от Claude Code Remote Control?</summary>
168
+
169
+ Claude Code Remote Control позволяет отправлять сообщения в сессию, которая уже запущена в вашем локальном терминале. Ваша машина должна оставаться включённой, терминал — открытым, а сессии завершаются примерно через 10 минут без сетевого соединения.
170
+
171
+ CloudCLI UI и CloudCLI Cloud расширяют Claude Code, а не работают рядом с ним — ваши MCP-серверы, разрешения, настройки и сессии остаются теми же самыми, что и в нативном Claude Code. Ничего не дублируется и не управляется отдельно.
172
+
173
+ Вот что это означает на практике:
174
+
175
+ - **Все ваши сессии, а не одна** — CloudCLI UI автоматически находит каждую сессию из папки `~/.claude`. Remote Control предоставляет только одну активную сессию, чтобы сделать её доступной в мобильном приложении Claude.
176
+ - **Ваши настройки — это ваши настройки** — MCP-серверы, права инструментов и конфигурация проекта, изменённые в CloudCLI UI, записываются напрямую в конфиг Claude Code и вступают в силу сразу же, и наоборот.
177
+ - **Работает с большим числом агентов** — Claude Code, Cursor CLI, Codex и Gemini CLI, а не только Claude Code.
178
+ - **Полноценный UI, а не просто окно чата** — проводник файлов, Git-интеграция, управление MCP и shell-терминал — всё встроено.
179
+ - **CloudCLI Cloud работает в облаке** — закройте ноутбук, и агент продолжит работать. Не нужно следить за терминалом и держать машину постоянно активной.
180
+
181
+ </details>
182
+
183
+ <details>
184
+ <summary>Нужно ли отдельно платить за AI-подписку?</summary>
185
+
186
+ Да. CloudCLI предоставляет среду, а не сам AI. Вы приносите свою подписку Claude, Cursor, Codex или Gemini. CloudCLI Cloud начинается от $7/месяц за хостируемую среду поверх этого.
187
+
188
+ </details>
189
+
190
+ <details>
191
+ <summary>Можно ли пользоваться CloudCLI UI с телефона?</summary>
192
+
193
+ Да. Для self-hosted запустите сервер на своей машине и откройте `[yourip]:port` в любом браузере в вашей сети. Для CloudCLI Cloud откройте сервис с любого устройства — без VPN, проброса портов и дополнительной настройки. Нативное приложение тоже в разработке.
194
+
195
+ </details>
196
+
197
+ <details>
198
+ <summary>Повлияют ли изменения, сделанные в UI, на мой локальный Claude Code?</summary>
199
+
200
+ Да, в self-hosted режиме. CloudCLI UI читает и записывает тот же конфиг `~/.claude`, который Claude Code использует нативно. MCP-серверы, добавленные через UI, сразу появляются в Claude Code, и наоборот.
201
+
202
+ </details>
203
+
204
+ ---
205
+
206
+ ## Сообщество и поддержка
207
+
208
+ - **[Документация](https://cloudcli.ai/docs)** — установка, настройка, возможности и устранение неполадок
209
+ - **[Discord](https://discord.gg/buxwujPNRE)** — помощь и общение с другими пользователями
210
+ - **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — сообщения об ошибках и запросы новых функций
211
+ - **[Руководство для контрибьюторов](CONTRIBUTING.md)** — как участвовать в развитии проекта
212
+
213
+ ## Лицензия
214
+
215
+ GNU General Public License v3.0 - подробности в файле [LICENSE](LICENSE).
216
+
217
+ Этот проект open source и бесплатен для использования, модификации и распространения в рамках лицензии GPL v3.
218
+
219
+ ## Благодарности
220
+
221
+ ### Используется
222
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - официальный CLI от Anthropic
223
+ - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - официальный CLI от Cursor
224
+ - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
225
+ - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
226
+ - **[React](https://react.dev/)** - библиотека пользовательских интерфейсов
227
+ - **[Vite](https://vitejs.dev/)** - быстрый инструмент сборки и dev-сервер
228
+ - **[Tailwind CSS](https://tailwindcss.com/)** - utility-first CSS framework
229
+ - **[CodeMirror](https://codemirror.net/)** - продвинутый редактор кода
230
+ - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(опционально)* - AI-управление проектами и планирование задач
231
+
232
+
233
+ ### Спонсоры
234
+ - [Siteboon - AI powered website builder](https://siteboon.ai)
235
+ ---
236
+
237
+ <div align="center">
238
+ <strong>Сделано с заботой для сообщества Claude Code, Cursor и Codex.</strong>
239
+ </div>
@@ -0,0 +1,230 @@
1
+ <div align="center">
2
+ <img src="public/logo.svg" alt="CloudCLI UI" width="64" height="64">
3
+ <h1>Cloud CLI(又名 Claude Code UI)</h1>
4
+ <p><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>、<a href="https://docs.cursor.com/en/cli/overview">Cursor CLI</a>、<a href="https://developers.openai.com/codex">Codex</a> 和 <a href="https://geminicli.com/">Gemini-CLI</a> 的桌面和移动端 UI。可在本地或远程使用,从任何地方查看激活的项目与会话。</p>
5
+ </div>
6
+
7
+ <p align="center">
8
+ <a href="https://cloudcli.ai">CloudCLI Cloud</a> · <a href="https://cloudcli.ai/docs">文档</a> · <a href="https://discord.gg/buxwujPNRE">Discord</a> · <a href="https://github.com/siteboon/claudecodeui/issues">Bug 报告</a> · <a href="CONTRIBUTING.md">贡献指南</a>
9
+ </p>
10
+
11
+ <p align="center">
12
+ <a href="https://cloudcli.ai"><img src="https://img.shields.io/badge/☁️_CloudCLI_Cloud-Try_Now-0066FF?style=for-the-badge" alt="CloudCLI Cloud"></a>
13
+ <a href="https://discord.gg/buxwujPNRE"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="加入 Discord 社区"></a>
14
+ <br><br>
15
+ <a href="https://trendshift.io/repositories/15586" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15586" alt="siteboon%2Fclaudecodeui | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
16
+ </p>
17
+
18
+ <div align="right"><i><a href="./README.md">English</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ko.md">한국어</a> · <b>中文</b> · <a href="./README.ja.md">日本語</a></i></div>
19
+
20
+ ---
21
+
22
+ ## 截图
23
+
24
+ <div align="center">
25
+
26
+ <table>
27
+ <tr>
28
+ <td align="center">
29
+ <h3>桌面视图</h3>
30
+ <img src="public/screenshots/desktop-main.png" alt="桌面界面" width="400">
31
+ <br>
32
+ <em>显示项目概览和聊天的主界面</em>
33
+ </td>
34
+ <td align="center">
35
+ <h3>移动体验</h3>
36
+ <img src="public/screenshots/mobile-chat.png" alt="移动界面" width="250">
37
+ <br>
38
+ <em>具有触控导航的响应式移动设计</em>
39
+ </td>
40
+ </tr>
41
+ <tr>
42
+ <td align="center" colspan="2">
43
+ <h3>CLI 选择</h3>
44
+ <img src="public/screenshots/cli-selection.png" alt="CLI 选择" width="400">
45
+ <br>
46
+ <em>在 Claude Code、Gemini、Cursor CLI 与 Codex 之间进行选择</em>
47
+ </td>
48
+ </tr>
49
+ </table>
50
+
51
+ </div>
52
+
53
+ ## 功能
54
+
55
+ - **响应式设计** - 在桌面、平板和移动设备上无缝运行,让您随时随地使用 Agents
56
+ - **交互聊天界面** - 内置聊天 UI,轻松与 Agents 交流
57
+ - **集成 Shell 终端** - 通过内置 shell 功能直接访问 Agents CLI
58
+ - **文件浏览器** - 交互式文件树,支持语法高亮与实时编辑
59
+ - **Git 浏览器** - 查看、暂存并提交更改,还可切换分支
60
+ - **会话管理** - 恢复对话、管理多个会话并跟踪历史记录
61
+ - **插件系统** - 通过自定义选项卡、后端服务与集成扩展 CloudCLI。 [开始构建 →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)
62
+ - **TaskMaster AI 集成** *(可选)* - 结合 AI 任务规划、PRD 分析与工作流自动化,实现高级项目管理
63
+ - **模型兼容性** - 支持 Claude、GPT、Gemini 模型家族(完整支持列表见 [`shared/modelConstants.js`](shared/modelConstants.js))
64
+
65
+ ## 快速开始
66
+
67
+ ### CloudCLI Cloud(推荐)
68
+
69
+ 无需本地设置即可快速启动。提供可通过网络浏览器、移动应用、API 或喜欢的 IDE 访问的完全集装式托管开发环境。
70
+
71
+ **[立即开始 CloudCLI Cloud](https://cloudcli.ai)**
72
+
73
+ ### 自托管(开源)
74
+
75
+ 启动 CloudCLI UI,只需一行 `npx`(需要 Node.js v22+):
76
+
77
+ ```bash
78
+ npx @cloudcli-ai/cloudcli
79
+ ```
80
+
81
+ 或进行全局安装,便于日常使用:
82
+
83
+ ```bash
84
+ npm install -g @cloudcli-ai/cloudcli
85
+ cloudcli
86
+ ```
87
+
88
+ 打开 `http://localhost:3001`,系统会自动发现所有现有会话。
89
+
90
+ 更多配置选项、PM2、远程服务器设置等,请参阅 **[文档 →](https://cloudcli.ai/docs)**
91
+
92
+ ---
93
+
94
+ ## 哪个选项更适合你?
95
+
96
+ CloudCLI UI 是 CloudCLI Cloud 的开源 UI 层。你可以在本地机器上自托管它,也可以使用提供团队功能与深入集成的 CloudCLI Cloud。
97
+
98
+ | | CloudCLI UI(自托管) | CloudCLI Cloud |
99
+ |---|---|---|
100
+ | **适合对象** | 需要为本地代理会话提供完整 UI 的开发者 | 需要部署在云端,随时从任何地方访问代理的团队与开发者 |
101
+ | **访问方式** | 通过 `[yourip]:port` 在浏览器中访问 | 浏览器、任意 IDE、REST API、n8n |
102
+ | **设置** | `npx @cloudcli-ai/cloudcli` | 无需设置 |
103
+ | **机器需保持开机吗** | 是 | 否 |
104
+ | **移动端访问** | 网络内任意浏览器 | 任意设备(原生应用即将推出) |
105
+ | **可用会话** | 自动发现 `~/.claude` 中的所有会话 | 云端环境内的会话 |
106
+ | **支持的 Agents** | Claude Code、Cursor CLI、Codex、Gemini CLI | Claude Code、Cursor CLI、Codex、Gemini CLI |
107
+ | **文件浏览与 Git** | 内置于 UI | 内置于 UI |
108
+ | **MCP 配置** | UI 管理,与本地 `~/.claude` 配置同步 | UI 管理 |
109
+ | **IDE 访问** | 本地 IDE | 任何连接到云环境的 IDE |
110
+ | **REST API** | 是 | 是 |
111
+ | **n8n 节点** | 否 | 是 |
112
+ | **团队共享** | 否 | 是 |
113
+ | **平台费用** | 免费开源 | 起价 $7/月 |
114
+
115
+ > 两种方式都使用你自己的 AI 订阅(Claude、Cursor 等)— CloudCLI 提供环境,而非 AI。
116
+
117
+ ---
118
+
119
+ ## 安全与工具配置
120
+
121
+ **🔒 重要提示**: 所有 Claude Code 工具默认**禁用**,可防止潜在的有害操作自动运行。
122
+
123
+ ### 启用工具
124
+
125
+ 1. **打开工具设置** - 点击侧边栏齿轮图标
126
+ 2. **选择性启用** - 仅启用所需工具
127
+ 3. **应用设置** - 偏好设置保存在本地
128
+
129
+ <div align="center">
130
+
131
+ ![工具设置弹窗](public/screenshots/tools-modal.png)
132
+ *工具设置界面 - 只启用你需要的内容*
133
+
134
+ </div>
135
+
136
+ **推荐做法**: 先启用基础工具,再根据需要添加其他工具。随时可以调整。
137
+
138
+ ---
139
+
140
+ ## 插件
141
+
142
+ CloudCLI 配备插件系统,允许你添加带自定义前端 UI 和可选 Node.js 后端的选项卡。在 Settings > Plugins 中直接从 Git 仓库安装插件,或自行开发。
143
+
144
+ ### 可用插件
145
+
146
+ | 插件 | 描述 |
147
+ |---|---|
148
+ | **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 展示当前项目的文件数、代码行数、文件类型分布、最大文件以及最近修改的文件 |
149
+
150
+ ### 自行构建
151
+
152
+ **[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — Fork 该仓库以构建自己的插件。示例包括前端渲染、实时上下文更新和 RPC 通信。
153
+
154
+ **[插件文档 →](https://cloudcli.ai/docs/plugin-overview)** — 提供插件 API、清单格式、安全模型等完整指南。
155
+
156
+ ---
157
+
158
+ ## 常见问题
159
+
160
+ <details>
161
+ <summary>与 Claude Code Remote Control 有何不同?</summary>
162
+
163
+ Claude Code Remote Control 让你发送消息到本地终端中已经运行的会话。该方式要求你的机器保持开机,终端保持开启,断开网络后约 10 分钟会话会超时。
164
+
165
+ CloudCLI UI 与 CloudCLI Cloud 是对 Claude Code 的扩展,而非旁观 — MCP 服务器、权限、设置、会话与 Claude Code 完全一致。
166
+
167
+ - **覆盖全部会话** — CloudCLI UI 会自动扫描 `~/.claude` 文件夹中的每个会话。Remote Control 只暴露当前活动的会话。
168
+ - **设置统一** — 在 CloudCLI UI 中修改的 MCP、工具权限等设置会立即写入 Claude Code。
169
+ - **支持更多 Agents** — Claude Code、Cursor CLI、Codex、Gemini CLI。
170
+ - **完整 UI** — 除了聊天界面,还包括文件浏览器、Git 集成、MCP 管理和 Shell 终端。
171
+ - **CloudCLI Cloud 保持运行于云端** — 关闭本地设备也不会中断代理运行,无需监控终端。
172
+
173
+ </details>
174
+
175
+ <details>
176
+ <summary>需要额外购买 AI 订阅吗?</summary>
177
+
178
+ 需要。CloudCLI 只提供环境。你仍需自行获取 Claude、Cursor、Codex 或 Gemini 订阅。CloudCLI Cloud 从 $7/月起提供托管环境。
179
+
180
+ </details>
181
+
182
+ <details>
183
+ <summary>能在手机上使用 CloudCLI UI 吗?</summary>
184
+
185
+ 可以。自托管时,在你的设备上运行服务器,然后在网络中的任意浏览器打开 `[yourip]:port`。CloudCLI Cloud 可从任意设备访问,内置原生应用也在开发中。
186
+
187
+ </details>
188
+
189
+ <details>
190
+ <summary>UI 中的更改会影响本地 Claude Code 配置吗?</summary>
191
+
192
+ 会的。自托管模式下,CloudCLI UI 读取并写入 Claude Code 使用的 `~/.claude` 配置。通过 UI 添加的 MCP 服务器会立即在 Claude Code 中可见。
193
+
194
+ </details>
195
+
196
+ ---
197
+
198
+ ## 社区与支持
199
+
200
+ - **[文档](https://cloudcli.ai/docs)** — 安装、配置、功能与故障排除指南
201
+ - **[Discord](https://discord.gg/buxwujPNRE)** — 获取帮助并与社区交流
202
+ - **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — 报告 Bug 与建议功能
203
+ - **[贡献指南](CONTRIBUTING.md)** — 如何参与项目贡献
204
+
205
+ ## 许可证
206
+
207
+ GNU 通用公共许可证 v3.0 - 详见 [LICENSE](LICENSE) 文件。
208
+
209
+ 该项目为开源软件,在 GPL v3 许可证下可自由使用、修改与分发。
210
+
211
+ ## 致谢
212
+
213
+ ### 使用技术
214
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 官方 CLI
215
+ - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 官方 CLI
216
+ - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
217
+ - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
218
+ - **[React](https://react.dev/)** - 用户界面库
219
+ - **[Vite](https://vitejs.dev/)** - 快速构建工具与开发服务器
220
+ - **[Tailwind CSS](https://tailwindcss.com/)** - 实用先行 CSS 框架
221
+ - **[CodeMirror](https://codemirror.net/)** - 高级代码编辑器
222
+ - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(可选)* - AI 驱动的项目管理与任务规划
223
+
224
+ ### 赞助商
225
+ - [Siteboon - AI powered website builder](https://siteboon.ai)
226
+ ---
227
+
228
+ <div align="center">
229
+ <strong>为 Claude Code、Cursor 和 Codex 社区精心打造。</strong>
230
+ </div>