mirror of https://github.com/siteboon/claudecodeui.git synced 2026-07-08 22:55:41 +08:00

Files

Haile 4cee5e7286 Fix/resolve different bugs (#964 )

* fix: don't overlap thinking banner over conversation

* feat: support message queue and add attention indicator

* fix(shell): use c to copy for claude

* fix: strip timestamp tags from cursor

* fix: select project when loading session from direct URL

* feat: support attached images for all providers

* feat(opencode): support permission options

* fix: resolve source control and chat UX bugs

- make staging real in the git panel: new /stage and /unstage endpoints,
  /status now reports the actual index via porcelain -z (handles renames,
  conflicts, and paths with spaces), and Stage/Unstage All run real git
  commands instead of toggling client-side state
- add branch search to the header dropdown and Branches tab
- persist the chosen permission mode per provider so a brand-new chat
  keeps it once the session id arrives, instead of reverting to default
- replace cmdk's fuzzy model search with strict token matching so
  "chatgpt" no longer surfaces unrelated models
- unit tests for the git status parser

* feat(git): commit graph in history view and cross-spawn everywhere

- render a VSCode-style commit graph in the source control history:
  lane-assignment algorithm, SVG strip with colored rails, merge and
  branch curves, commit dots, and branch/tag badges per commit
- /commits returns parents and ref decorations across all branches
  (--branches --remotes --tags --topo-order) using unit-separator
  fields so pipes in commit subjects can't break parsing
- collect stats via a single --shortstat pass instead of one
  `git show --stat` call per commit; raise the history limit to 50
- replace child_process spawn with cross-spawn in all runtimes,
  routes, and services: it resolves .cmd shims and PATHEXT on
  Windows (fixing taskmaster's npx invocations) and delegates to
  native spawn elsewhere, removing the per-file win32 ternaries
- unit tests for the log parser and lane assignment

* fix: remove gemini support since google discontinued it

* fix: address code review findings

- validate chat image attachments server-side: only files inside the
  ~/.cloudcli/assets upload store may reach provider file reads
- harden asset serving with nosniff and attachment disposition for
  SVGs to prevent stored XSS
- show the timestamp on image-only user messages
- serialize git stage/unstage calls and defer the status re-sync so
  rapid toggles can't interleave or flicker
- use a literal hex fallback for commit ref badges (alpha suffix on a
  var() string produced invalid CSS)
- stop binding a URL session to a guening
  project instead
- add the missing attentionRequiredIndicator key to all sidebar locales
- clean up dangling conjunctions left the
  de/ru/tr/ja/zh-CN/zh-TW READMEs

* fix: address code scanning findings

- enforce a second image trust boundary in the provider builders:
  buildClaudeUserContent/buildCodexInputItems only accept files inside
  the upload store or the run's working directory (CodeQL path
  injection)
- drop an always-true selectedProject check in handleSubmit
- remove the unused resume option from spawnCursor

* fix: use CodeQL-recognized containment check for image reads

Replace the path.relative guard in isPathInsideDirectory with the
resolve + startsWith(root + sep) idiom so the path-injection barrier
is visible to code scanning; behavior is unchanged.

* fix(security): canonicalize Claude image attachment reads

Resolve image attachment paths with realpath before reading so symlinks
inside allowed roots cannot escape to arbitrary files. Preserve support for
symlinked project/upload roots and add focused coverage for both cases.

* fix: show agent subtask

* fix(sessions): title app-created sessions from the first user message

App-created sessions (started by sending a message from cloudcli) were
titled with placeholder names — "Untitled Codex Session" from the disk
indexer and, briefly, "New session" from the empty canonical upsert —
before a later sync finally settled on the right text, causing the
sidebar title to flicker.

- Codex/OpenCode synchronizers now title app-created sessions (distinct
  app id mapped to a provider id) from the first user message, while
  sessions found purely by indexing keep their existing setup. Claude
  keeps its AI-generated titles; Cursor already used the first message.
- Decode OpenCode's JSON-string-literal prompts so titles no longer
  surface wrapped in quotes; hoist unwrapJsonStringLiteral into
  shared/utils since it's now used by both the reader and synchronizer.
- Guard the sidebar upsert merge so an empty summary can never blank out
  a title that is already set.
- Add codex/opencode synchronizer tests for the app-created vs indexed
  naming paths.

* fix(chat): make message queuing reliable across sessions and turn boundaries

Queued messages had four related defects:

- A queued message flashed and then vanished at flush time: concurrent
  transcript refreshes (the `complete` handler racing the watcher-triggered
  update) could resolve out of order, letting a stale response overwrite
  newer server messages after the optimistic row was pruned. Session slots
  now carry a monotonic fetch ticket and discard stale fetch/refresh/
  fetchMore responses.

- Switching sessions flushed the previous session's queued draft into the
  newly viewed one (sending it with the wrong provider's settings, e.g. a
  Claude model into a Codex session). The composer flush is now scoped to
  its session, and a draft restored into an idle session sends after a
  short grace period so a live-run ack can cancel it.

- The thinking banner never appeared for a queued turn: the chat handler's
  session-keyed completeRun safety net could fire after a queued message
  had already started the session's next run, emitting a spurious
  `complete` that killed it. The safety net is now scoped to its own run
  via completeRunIfCurrent (with a regression test).

- Queued messages only sent while their session was being viewed. Drafts
  now persist their send options (model, effort, permissions) at queue
  time, and a new app-level useQueuedMessageAutoSend hook dispatches a
  non-viewed session's queued message as soon as its run completes, using
  the storage key as the claim ticket to prevent double sends.

2026-07-08 10:32:32 +02:00

19 KiB

Raw Blame History

Cloud CLI (aka Claude Code UI)

Десктопный и мобильный UI для Claude Code, Cursor CLI, Codex.
Используйте локально или удалённо, чтобы просматривать активные проекты и сессии отовсюду.

CloudCLI Cloud · Документация · Discord · Сообщить об ошибке · Участие в разработке

English · Русский · Deutsch · 한국어 · 简体中文 · 繁體中文 · 日本語 · Türkçe

Скриншоты

Версия для десктопа Основной интерфейс с обзором проекта и чатом	Мобильный режим Адаптивный мобильный дизайн с сенсорной навигацией
Выбор CLI Выбирайте между Claude Code, Cursor CLI и Codex

Возможности

Адаптивный дизайн - одинаково хорошо работает на десктопе, планшете и телефоне, поэтому можно пользоваться агентами и с мобильных устройств
Интерактивный чат-интерфейс - встроенный чат для бесшовного общения с агентами
Интегрированный shell-терминал - прямой доступ к CLI агентов через встроенную оболочку
Проводник файлов - интерактивное дерево файлов с подсветкой синтаксиса и редактированием в реальном времени
Git Explorer - просмотр, stage и commit изменений. Также можно переключать ветки
Управление сессиями - возобновляйте диалоги, управляйте несколькими сессиями и отслеживайте историю
Система плагинов - расширяйте CloudCLI кастомными плагинами — добавляйте новые вкладки, бэкенд-сервисы и интеграции. Создать свой →
Интеграция с TaskMaster AI (опционально) - продвинутое управление проектами с планированием задач на базе AI, разбором PRD и автоматизацией workflow
Совместимость с моделями - работает с семействами моделей Claude и GPT (полный список поддерживаемых моделей доступен через GET /api/providers/:provider/models)

Быстрый старт

CloudCLI Cloud (рекомендуется)

Самый быстрый способ начать — локальная настройка не требуется. Получите полностью управляемую контейнеризированную среду разработки с доступом из веба, мобильного приложения, API или вашей любимой IDE.

Начать с CloudCLI Cloud

Self-Hosted (Open source)

npm

Попробовать CloudCLI UI можно сразу через npx (требуется Node.js v22+):

npx @cloudcli-ai/cloudcli

Или установить глобально для регулярного использования:

npm install -g @cloudcli-ai/cloudcli
cloudcli

Откройте http://localhost:3001 — все ваши существующие сессии будут обнаружены автоматически.

Посетите документацию →, чтобы узнать про дополнительные варианты конфигурации, PM2, настройку удалённого сервера и многое другое.

Docker Sandboxes (Экспериментально)

Запускайте агентов в изолированных песочницах с гипервизорной изоляцией. По умолчанию запускается Claude Code. Требуется sbx CLI.

npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project

Поддерживаются Claude Code и Codex. Подробнее в документации sandbox.

Какой вариант подходит вам?

CloudCLI UI — это open source UI-слой, на котором построен CloudCLI Cloud. Вы можете развернуть его на своей машине или использовать CloudCLI Cloud, который добавляет полностью управляемую облачную среду, командные функции и более глубокие интеграции.

	CloudCLI UI (Self-hosted)	CloudCLI Cloud
Лучше всего подходит для	Разработчиков, которым нужен полноценный UI для локальных агентских сессий на своей машине	Команд и разработчиков, которым нужны агенты в облаке с доступом откуда угодно
Как вы получаете доступ	Браузер через `[yourip]:port`	Браузер, любая IDE, REST API, n8n
Настройка	`npx @cloudcli-ai/cloudcli`	Настройка не требуется
Машина должна оставаться включённой	Да	Нет
Доступ с мобильных устройств	Любой браузер в вашей сети	Любое устройство, нативное приложение в разработке
Доступные сессии	Все сессии автоматически обнаруживаются из `~/.claude`	Все сессии внутри вашей облачной среды
Поддерживаемые агенты	Claude Code, Cursor CLI, Codex	Claude Code, Cursor CLI, Codex
Проводник файлов и Git	Да, встроены в UI	Да, встроены в UI
Конфигурация MCP	Управляется через UI, синхронизируется с вашим локальным конфигом `~/.claude`	Управляется через UI
Доступ из IDE	Ваша локальная IDE	Любая IDE, подключенная к вашей облачной среде
REST API	Да	Да
n8n node	Нет	Да
Совместная работа	Нет	Да
Стоимость платформы	Бесплатно, open source	От €7/месяц

В обоих вариантах используются ваши собственные AI-подписки (Claude, Cursor и т.д.) — CloudCLI предоставляет среду, а не сам AI.

Безопасность и конфигурация инструментов

🔒 Важное примечание: все инструменты Claude Code по умолчанию отключены. Это предотвращает автоматический запуск потенциально опасных операций.

Включение инструментов

Чтобы использовать всю функциональность Claude Code, вам нужно вручную включить инструменты:

Откройте настройки инструментов - нажмите на иконку шестерёнки в боковой панели
Включайте выборочно - активируйте только те инструменты, которые вам нужны
Примените настройки - ваши предпочтения сохраняются локально

Интерфейс настройки инструментов — включайте только то, что вам нужно

Рекомендуемый подход: начните с базовых инструментов и добавляйте остальные по мере необходимости. Эти настройки всегда можно изменить позже.

Плагины

У CloudCLI есть система плагинов, которая позволяет добавлять кастомные вкладки со своим frontend UI и (опционально) Node.js бэкендом. Устанавливайте плагины напрямую из git-репозиториев в Settings > Plugins или создавайте свои.

Доступные плагины

Плагин	Описание
Project Stats	Показывает количество файлов, строки кода, разбивку по типам файлов, самые большие файлы и недавно изменённые файлы для текущего проекта
Web Terminal	Полноценный терминал xterm.js с поддержкой нескольких вкладок
Claude Watch	Отслеживает зависания долгих сессий Claude Code и предоставляет управление процессами
CloudCLI Scheduler	Создаёт запланированные промпты для рабочей области и запускает их через локальную CLI, например Codex или Claude Code
PRISM CloudCLI	Аналитика сессий Claude Code внутри CloudCLI, включая видимость расхода токенов
Sessions	Просмотр, управление и завершение активных сессий Claude Code
Token Cost Calculator	Расчёт стоимости API по ценам моделей и использованию токенов, с поддержкой пресетов цен
Task Queue	Дашборд очереди задач для просмотра, фильтрации и запуска агентских задач
GitHub Issues Board	Kanban-доска для GitHub Issues с двусторонней синхронизацией TaskMaster и автоустановкой CLI-навыка /github-task

Создать свой

Plugin Starter Template → — сделайте форк этого репозитория, чтобы создать свой плагин. В шаблоне есть рабочий пример с рендерингом на фронтенде, live-обновлением контекста и RPC-коммуникацией с бэкенд-сервером.

Plugin Documentation → — полный гайд по plugin API, формату манифеста, модели безопасности и другому.

FAQ

Чем это отличается от Claude Code Remote Control?

Claude Code Remote Control позволяет отправлять сообщения в сессию, которая уже запущена в вашем локальном терминале. Ваша машина должна оставаться включённой, терминал — открытым, а сессии завершаются примерно через 10 минут без сетевого соединения.

CloudCLI UI и CloudCLI Cloud расширяют Claude Code, а не работают рядом с ним — ваши MCP-серверы, разрешения, настройки и сессии остаются теми же самыми, что и в нативном Claude Code. Ничего не дублируется и не управляется отдельно.

Вот что это означает на практике:

Все ваши сессии, а не одна — CloudCLI UI автоматически находит каждую сессию из папки ~/.claude. Remote Control предоставляет только одну активную сессию, чтобы сделать её доступной в мобильном приложении Claude.
Ваши настройки — это ваши настройки — MCP-серверы, права инструментов и конфигурация проекта, изменённые в CloudCLI UI, записываются напрямую в конфиг Claude Code и вступают в силу сразу же, и наоборот.
Работает с большим числом агентов — Claude Code, Cursor CLI и Codex, а не только Claude Code.
Полноценный UI, а не просто окно чата — проводник файлов, Git-интеграция, управление MCP и shell-терминал — всё встроено.
CloudCLI Cloud работает в облаке — закройте ноутбук, и агент продолжит работать. Не нужно следить за терминалом и держать машину постоянно активной.

Нужно ли отдельно платить за AI-подписку?

Да. CloudCLI предоставляет среду, а не сам AI. Вы приносите свою подписку Claude, Cursor или Codex. CloudCLI Cloud начинается от €7/месяц за хостируемую среду поверх этого.

Можно ли пользоваться CloudCLI UI с телефона?

Да. Для self-hosted запустите сервер на своей машине и откройте [yourip]:port в любом браузере в вашей сети. Для CloudCLI Cloud откройте сервис с любого устройства — без VPN, проброса портов и дополнительной настройки. Нативное приложение тоже в разработке.

Повлияют ли изменения, сделанные в UI, на мой локальный Claude Code?

Да, в self-hosted режиме. CloudCLI UI читает и записывает тот же конфиг ~/.claude, который Claude Code использует нативно. MCP-серверы, добавленные через UI, сразу появляются в Claude Code, и наоборот.

Сообщество и поддержка

Документация — установка, настройка, возможности и устранение неполадок
Discord — помощь и общение с другими пользователями
GitHub Issues — сообщения об ошибках и запросы новых функций
Руководство для контрибьюторов — как участвовать в развитии проекта

Лицензия

GNU General Public License v3.0 - подробности в файле LICENSE.

Этот проект open source и бесплатен для использования, модификации и распространения в рамках лицензии GPL v3.

Благодарности

Используется

Claude Code - официальный CLI от Anthropic
Cursor CLI - официальный CLI от Cursor
Codex - OpenAI Codex
React - библиотека пользовательских интерфейсов
Vite - быстрый инструмент сборки и dev-сервер
Tailwind CSS - utility-first CSS framework
CodeMirror - продвинутый редактор кода
TaskMaster AI (опционально) - AI-управление проектами и планирование задач

Спонсоры

Siteboon - AI powered website builder

Сделано с заботой для сообщества Claude Code, Cursor и Codex.

19 KiB Raw Blame History Unescape Escape