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

14 KiB

Raw Blame History

Cloud CLI (auch bekannt als Claude Code UI)

Eine Desktop- und Mobile-Oberfläche für Claude Code, Cursor CLI und Codex.
Lokal oder remote nutzbar – verwalte deine aktiven Projekte und Sitzungen von überall.

CloudCLI Cloud · Dokumentation · Discord · Fehler melden · Mitwirken

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

Screenshots

Desktop-Ansicht Hauptoberfläche mit Projektübersicht und Chat	Mobile-Erfahrung Responsives mobiles Design mit Touch-Navigation
CLI-Auswahl Wähle zwischen Claude Code, Cursor CLI und Codex

Funktionen

Responsives Design – Funktioniert nahtlos auf Desktop, Tablet und Mobilgerät, sodass du Agents auch vom Smartphone aus nutzen kannst
Interaktives Chat-Interface – Eingebaute Chat-Oberfläche für die reibungslose Kommunikation mit den Agents
Integriertes Shell-Terminal – Direkter Zugriff auf die Agents CLI über die eingebaute Shell-Funktionalität
Datei-Explorer – Interaktiver Dateibaum mit Syntaxhervorhebung und Live-Bearbeitung
Git-Explorer – Änderungen anzeigen, stagen und committen. Branches wechseln ebenfalls möglich
Sitzungsverwaltung – Gespräche fortsetzen, mehrere Sitzungen verwalten und Verlauf nachverfolgen
Plugin-System – CloudCLI mit eigenen Plugins erweitern – neue Tabs, Backend-Dienste und Integrationen hinzufügen. Eigenes Plugin erstellen →
TaskMaster AI Integration (Optional) – Erweitertes Projektmanagement mit KI-gestützter Aufgabenplanung, PRD-Parsing und Workflow-Automatisierung
Modell-Kompatibilität – Funktioniert mit den Claude- und GPT-Modellfamilien (vollständige Liste unterstützter Modelle zur Laufzeit über GET /api/providers/:provider/models)

Schnellstart

CloudCLI Cloud (Empfohlen)

Der schnellste Einstieg – keine lokale Einrichtung erforderlich. Erhalte eine vollständig verwaltete, containerisierte Entwicklungsumgebung, die über Web, Mobile App, API oder deine bevorzugte IDE erreichbar ist.

Mit CloudCLI Cloud starten

Self-Hosted (Open Source)

npm

CloudCLI UI sofort mit npx ausprobieren (erfordert Node.js v22+):

npx @cloudcli-ai/cloudcli

Oder global installieren für regelmäßige Nutzung:

npm install -g @cloudcli-ai/cloudcli
cloudcli

Öffne http://localhost:3001 – alle vorhandenen Sitzungen werden automatisch erkannt.

Die Dokumentation → enthält weitere Konfigurationsoptionen, PM2, Remote-Server-Einrichtung und mehr.

Docker Sandboxes (Experimentell)

Agents in isolierten Sandboxes mit Hypervisor-Isolation ausführen. Standardmäßig wird Claude Code gestartet. Erfordert die sbx CLI.

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

Unterstützt Claude Code und Codex. Weitere Details in der Sandbox-Dokumentation.

Welche Option passt zu dir?

CloudCLI UI ist die Open-Source-UI-Schicht, die CloudCLI Cloud antreibt. Du kannst es auf deinem eigenen Rechner selbst hosten oder CloudCLI Cloud nutzen, das darauf aufbaut und eine vollständig verwaltete Cloud-Umgebung, Team-Funktionen und tiefere Integrationen bietet.

	CloudCLI UI (Self-hosted)	CloudCLI Cloud
Am besten für	Entwickler:innen, die eine vollständige UI für lokale Agent-Sitzungen auf ihrem eigenen Rechner möchten	Teams und Entwickler:innen, die Agents in der Cloud betreiben möchten, überall erreichbar
Zugriff	Browser via `[deineIP]:port`	Browser, jede IDE, REST API, n8n
Einrichtung	`npx @cloudcli-ai/cloudcli`	Keine Einrichtung erforderlich
Rechner muss laufen	Ja	Nein
Mobiler Zugriff	Jeder Browser im Netzwerk	Jedes Gerät, native App in Entwicklung
Verfügbare Sitzungen	Alle Sitzungen automatisch aus `~/.claude` erkannt	Alle Sitzungen in deiner Cloud-Umgebung
Unterstützte Agents	Claude Code, Cursor CLI, Codex	Claude Code, Cursor CLI, Codex
Datei-Explorer und Git	Ja, direkt in der UI	Ja, direkt in der UI
MCP-Konfiguration	Über UI verwaltet, synchronisiert mit lokalem `~/.claude`	Über UI verwaltet
IDE-Zugriff	Deine lokale IDE	Jede IDE, die mit deiner Cloud-Umgebung verbunden ist
REST API	Ja	Ja
n8n-Node	Nein	Ja
Team-Sharing	Nein	Ja
Plattformkosten	Kostenlos, Open Source	Ab €7/Monat

Beide Optionen verwenden deine eigenen KI-Abonnements (Claude, Cursor usw.) – CloudCLI stellt die Umgebung bereit, nicht die KI.

Sicherheit & Tool-Konfiguration

🔒 Wichtiger Hinweis: Alle Claude Code Tools sind standardmäßig deaktiviert. Dies verhindert, dass potenziell schädliche Operationen automatisch ausgeführt werden.

Tools aktivieren

Um den vollen Funktionsumfang von Claude Code zu nutzen, müssen Tools manuell aktiviert werden:

Tool-Einstellungen öffnen – Klicke auf das Zahnrad-Symbol in der Seitenleiste
Selektiv aktivieren – Nur die benötigten Tools einschalten
Einstellungen übernehmen – Deine Einstellungen werden lokal gespeichert

Tool-Einstellungen – nur aktivieren, was benötigt wird

Empfohlene Vorgehensweise: Mit grundlegenden Tools starten und bei Bedarf weitere hinzufügen. Die Einstellungen können jederzeit angepasst werden.

Plugins

CloudCLI verfügt über ein Plugin-System, mit dem benutzerdefinierte Tabs mit eigener Frontend-UI und optionalem Node.js-Backend hinzugefügt werden können. Plugins können direkt in Einstellungen > Plugins aus Git-Repos installiert oder selbst entwickelt werden.

Verfügbare Plugins

Plugin	Beschreibung
Project Stats	Zeigt Dateianzahl, Codezeilen, Dateityp-Aufschlüsselung, größte Dateien und zuletzt geänderte Dateien des aktuellen Projekts
Web Terminal	Vollwertiges xterm.js-Terminal mit Multi-Tab-Unterstützung
Claude Watch	Überwacht lange laufende Claude-Code-Sitzungen auf Hänger und stellt Prozesssteuerungen bereit
CloudCLI Scheduler	Erstellt arbeitsbereichsbezogene geplante Prompts und führt sie über eine lokale CLI wie Codex oder Claude Code aus
PRISM CloudCLI	Sitzungsintelligenz für Claude Code in CloudCLI, inklusive Sichtbarkeit des Token-Verbrauchs
Sessions	Aktive Claude-Code-Sitzungen anzeigen, verwalten und beenden
Token Cost Calculator	API-Kosten anhand von Modellpreisen und Token-Nutzung berechnen, mit Unterstützung für Preisvorlagen
Task Queue	Task-Queue-Dashboard zum Anzeigen, Filtern und Starten von Agent-Aufgaben
GitHub Issues Board	Kanban-Board für GitHub Issues mit bidirektionaler TaskMaster-Synchronisierung und automatischer Installation des /github-task CLI-Skills

Eigenes Plugin erstellen

Plugin-Starter-Vorlage → – Forke dieses Repository, um ein eigenes Plugin zu erstellen. Es enthält ein funktionierendes Beispiel mit Frontend-Rendering, Live-Kontext-Updates und RPC-Kommunikation zu einem Backend-Server.

Plugin-Dokumentation → – Vollständige Anleitung zur Plugin-API, zum Manifest-Format, zum Sicherheitsmodell und mehr.

FAQ

Wie unterscheidet sich das von Claude Code Remote Control?

Claude Code Remote Control ermöglicht es, Nachrichten an eine bereits im lokalen Terminal laufende Sitzung zu senden. Der Rechner muss eingeschaltet bleiben, das Terminal muss offen bleiben, und Sitzungen laufen nach etwa 10 Minuten ohne Netzwerkverbindung ab.

CloudCLI UI und CloudCLI Cloud erweitern Claude Code, anstatt neben ihm zu laufen – MCP-Server, Berechtigungen, Einstellungen und Sitzungen sind exakt dieselben, die Claude Code nativ verwendet. Nichts wird dupliziert oder separat verwaltet.

Das bedeutet in der Praxis:

Alle Sitzungen, nicht nur eine – CloudCLI UI erkennt automatisch jede Sitzung aus dem ~/.claude-Ordner. Remote Control stellt nur die einzelne aktive Sitzung bereit, um sie in der Claude Mobile App verfügbar zu machen.
Deine Einstellungen sind deine Einstellungen – MCP-Server, Tool-Berechtigungen und Projektkonfiguration, die in CloudCLI UI geändert werden, werden direkt in die Claude Code-Konfiguration geschrieben und treten sofort in Kraft – und umgekehrt.
Funktioniert mit mehr Agents – Claude Code, Cursor CLI und Codex, nicht nur Claude Code.
Vollständige UI, nicht nur ein Chat-Fenster – Datei-Explorer, Git-Integration, MCP-Verwaltung und ein Shell-Terminal sind alle eingebaut.
CloudCLI Cloud läuft in der Cloud – Laptop zuklappen, der Agent läuft weiter. Kein Terminal zu überwachen, kein Rechner, der laufen muss.

Muss ich ein KI-Abonnement separat bezahlen?

Ja. CloudCLI stellt die Umgebung bereit, nicht die KI. Du bringst dein eigenes Claude-, Cursor- oder Codex-Abonnement mit. CloudCLI Cloud beginnt bei €7/Monat für die gehostete Umgebung zusätzlich dazu.

Kann ich CloudCLI UI auf meinem Smartphone nutzen?

Ja. Bei Self-Hosted: Server auf dem eigenen Rechner starten und [deineIP]:port in einem beliebigen Browser im Netzwerk öffnen. Bei CloudCLI Cloud: Von jedem Gerät aus öffnen – kein VPN, keine Portweiterleitung, keine Einrichtung. Eine native App ist ebenfalls in Entwicklung.

Wirken sich Änderungen in der UI auf mein lokales Claude Code-Setup aus?

Ja, bei Self-Hosted. CloudCLI UI liest aus und schreibt in dieselbe ~/.claude-Konfiguration, die Claude Code nativ verwendet. MCP-Server, die über die UI hinzugefügt werden, erscheinen sofort in Claude Code und umgekehrt.

Community & Support

Dokumentation — Installation, Konfiguration, Funktionen und Fehlerbehebung
Discord — Hilfe erhalten und mit anderen Nutzer:innen in Kontakt treten
GitHub Issues — Fehlerberichte und Feature-Anfragen
Beitragsrichtlinien — So kannst du zum Projekt beitragen

Lizenz

GNU General Public License v3.0 – siehe LICENSE-Datei für Details.

Dieses Projekt ist Open Source und kann unter der GPL v3-Lizenz kostenlos genutzt, modifiziert und verteilt werden.

Danksagungen

Erstellt mit

Claude Code - Anthropics offizielle CLI
Cursor CLI - Cursors offizielle CLI
Codex - OpenAI Codex
React - UI-Bibliothek
Vite - Schnelles Build-Tool und Dev-Server
Tailwind CSS - Utility-first CSS-Framework
CodeMirror - Erweiterter Code-Editor
TaskMaster AI (Optional) - KI-gestütztes Projektmanagement und Aufgabenplanung

Sponsoren

Siteboon - KI-gestützter Website-Builder

Mit Sorgfalt für die Claude Code-, Cursor- und Codex-Community erstellt.

14 KiB Raw Blame History Unescape Escape