CCB - Die Mobile App ist da!

August 15, 2026 · View on GitHub

CCB - Die Mobile App ist da!

Ein leichtgewichtiges Multi-Agent-TUI mit stabiler provider-uebergreifender Kollaborationsschicht
Koordiniere Codex, Claude, Gemini und andere CLI-Agenten in sichtbaren, steuerbaren Workflows, die du direkt uebernehmen kannst

version platform providers

Codex Claude Gemini Grok CLI Kimi MiMo Qwen Cursor GitHub Copilot Crush Kiro Pi Z.ai OpenCode Antigravity Droid

中文 | English | 日本語 | Français | Deutsch | العربية | Español | Português | 한국어 | Русский

Schnellstart · Mobile App · Rich-Modus · Agents konfigurieren · Benutzerhandbuch · Entwicklerhandbuch

Sichtbarer Multi-Agent-CLI-Arbeitsbereich von CCB

Warum CCB?

  • Stabile Kommunikation zwischen Agents fuer komplexe Kollaborationsgraphen wie A -> B -> C, A,B -> C und A -> B,C.
  • Jeder Agent ist ein vollstaendiges natives Terminal mit sichtbarer Layoutsteuerung und direkter Uebernahme.
  • Der Hintergrund-daemon haelt den Projektstatus auch dann am Leben, wenn die Vordergrund-UI geschlossen wird.
  • Hub-Faehigkeit: mehrere CLI providers parallel mit einem einzigen Befehl ausfuehren.
  • Mobile Fernsteuerung: provider-uebergreifende Sprachsteuerung, Dateiuebertragung und Remote-Terminal-Zugriff.

Installation

Installieren oder aktualisieren Sie eine von npm verwaltete CCB-Installation mit npm:

npm install -g @seemseam/ccb@latest

Für GitHub-release- oder Source-Installationen verwenden Sie den transaktionalen CCB updater:

ccb update

Bei einer von npm verwalteten Installation zeigt ccb update den entsprechenden npm-Befehl an und ändert das eingebettete Payload nicht.

GitHub-release-Pakete und Source-Install als Fallback

Wenn npm in Ihrer Umgebung unpraktisch ist, laden Sie das passende Paket von Releases herunter, entpacken es und installieren es:

tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install

Die Installation aus dem Quellcode ist nur fuer Entwicklung oder temporaere Fallbacks gedacht:

git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install

Eine Source-Installation verlinkt die globalen Befehle ccb / ask zurueck auf den Checkout. Normale Benutzer sollten das npm-Paket bevorzugen.

Schnellstart

1. Starten

Fuehren Sie dies in Ihrem Arbeitsverzeichnis aus:

ccb

Wenn der Start meldet, dass .ccb nicht automatisch erstellt werden kann oder der Projektanker fehlt, erstellen Sie .ccb manuell:

mkdir -p .ccb

2. Projektkonfiguration erstellen

Ein leeres Projekt startet schlank: CCB öffnet nur ein main-Window mit einem Agent namens demo und wählt das erste auf dem Rechner verfügbare unterstützte CLI. Ein Multi-Agent-Team wird nicht mehr standardmäßig gemountet.

Klicken Sie oben links in der CCB-Sidebar auf ⚙ Einstellungen, um das lokale Konfigurationspanel zu öffnen. Alternativ können Sie ccb config ui ausführen.

CCB-Konfigurationspanel für den Standard-Agent demo

Das Panel konfiguriert Windows, Pane-Splits, Provider, Modelle, Thinking-Level, API-Overrides, Workspaces, Rich-Modus und Sidebar. Es validiert Änderungen vor dem Speichern und unterstützt Reload-Dry-Runs sowie geschützten Hot Reload.

Für eine fortgeschrittene Multi-Agent-Topologie können Sie visuell weitere Agents hinzufügen oder .ccb/ccb.config manuell erstellen. , und ; steuern dabei vertikale Stapelung und horizontale Splits; A,B;C,D entspricht etwa vier Panes.

version = 2

[windows]
main = "main:codex"
work = "worker1:codex(worktree), worker2:claude(worktree)"
review = "reviewer:claude, qa:gemini"

[ui.sidebar]
mode = "every_window"
width = "15%"
bottom_height = 20
agents_height = "50%"
comms_height = "15%"
tips_height = "35%"
comms_limit = 3

Validieren Sie die Konfiguration und starten Sie den Arbeitsbereich:

ccb config validate
ccb

3. Zusammenarbeiten

Sie koennen direkt in ein beliebiges Agent-pane schreiben oder Agents zusammenarbeiten lassen:

/ask reviewer review the latest parser changes and list blocking issues.

Agents koennen waehrend der Workflow-Orchestrierung auch /ask aufrufen, um Arbeit zu delegieren und zu uebergeben. Nutzen Sie Agent-memory oder die projektweite gemeinsame Memory-Datei .ccb/ccb_memory.md fuer dauerhafte Koordination.

Mobile Fernsteuerung (Android)

Die empfohlene Steuerung von CCB per Smartphone kann sich mit allen CCB-Projekten verbinden, jeden Agent steuern, Spracheingabe annehmen und Dateien uebertragen.

ccb update mobile

Dieser Befehl fuehrt durch Installation und Konfiguration.

CCB Mobile Agent-Chat CCB Mobile Terminalsteuerung CCB Mobile Dateiuebertragung CCB Mobile Pairing und Verbindung

Mobile-App-Details, Sicherheitsgrenze und Source

CCB 8.6.6 enthaelt den Flutter-Quellcode von CCB Mobile in mobile/ und veroeffentlicht das Android APK ueber GitHub Releases:

Die Smartphone-App ist eine Fernsteuerung fuer echte CCB-Projekte auf einem Server. Sie kann gemountete Projekte ueber das server-wide mobile gateway finden, windows und agents wechseln, Agent-Konversationen rendern, Text ueber pane-native input senden, eine Terminalansicht oeffnen und Bilder sowie Dokumente ueber das authentifizierte gateway hoch- und herunterladen.

Sicherheitsgrenze:

  • Das CCB gateway bindet nur an loopback, zum Beispiel 127.0.0.1:8787.
  • Remote-Zugriff nutzt Tailscale Serve, nicht Tailscale Funnel.
  • CCB speichert keine Tailscale-Passwoerter, OAuth tokens oder admin API tokens und aendert tailnet ACLs/grants nicht automatisch.
  • Das Smartphone erhaelt nur die vom pairing profile erlaubten scopes, etwa view, content, terminal, file upload und file download.

Rich-Medienterminal

Dateibaeume durchsuchen, Dateien oeffnen, Dokumente bearbeiten und Medien im Terminal anzeigen.

CCB Rich-Medien-Workbench mit Yazi-Vorschau in WezTerm

ccb update rich

Nach Aktivierung des Rich-Modus oeffnet normales ccb automatisch den rich WezTerm launcher, sofern es nicht bereits in einer CCB-managed rich WezTerm session laeuft. Mit ccb uninstall rich kehren Sie zum normalen Terminalstart zurueck.

Agent Roles Spec und Rollenkatalog

CCB unterstuetzt Agent Roles Spec, eine host-neutrale Spezifikation zum Verpacken spezialisierter Agents. Skills, Memory und Tool-Abhaengigkeiten koennen in installierbare, mountbare und entfernbare Role Packs gebuendelt werden. Dieses Repository dient auch als oeffentlicher Rollenkatalog.

RoleZweck
agentroles.ccb_selfCCB-Selbstwartung, Konfigurationshilfe, Laufzeitdiagnose, geschuetzte Wiederherstellung und Workflow-Orchestrierung.
agentroles.archiArchitekturreview, Grenzpruefung, Kopplungsanalyse, Wartbarkeitsrisiken und Gate-Empfehlungen.
agentroles.frontend_engineerFrontend-Design und Implementierung, Designsysteme, Barrierefreiheit, Browser-QA und gepruefte AGY-Delegation.
agentroles.mobile_app_engineerMobile-Design und Implementierung fuer iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose und mehr.
agentroles.motherRollenerstellung, Role-source-Audit, Rollenrecherche, Blueprint-Design und Agent-Roles-Spec-Compliance.
agentroles.su_ccbSU-CCB-Workflowbetrieb fuer Anforderungsanalyse, Planung, Dispatch, Review-Gates, Archivierung und Wiederherstellung.

Konfiguration und gemeinsame Memory

Für normale Projektkonfigurationen wird das ⚙ Einstellungen-Panel empfohlen. Für Agent-gestützte Konfiguration und Laufzeitdiagnose bleibt ccb_self als optionales Role Pack verfügbar und kann mit ccb roles add agentroles.ccb_self:codex hinzugefügt werden.

.ccb/ccb_memory.md ist das projektweite gemeinsame Memory-Dokument. Nutzen Sie es fuer Teamregeln, Projektbeschraenkungen, langlebigen Kontext und Uebergabekonventionen zwischen Agents. Stabile agent-uebergreifende Informationen gehoeren dorthin, statt in mehrere provider-private Memory-Dateien kopiert zu werden.

Kontakt

WeChat-Gruppe

Community und Danksagung

Danke an die Linux.do community fuer Tests, Feedback und Diskussionen.

Danke an tmux-agent-sidebar fuer Sidebar-Ideen und Inspiration.

Release Notes

v8.4.0 - Verschluesseltes Mobile Relay, einfaches Pairing, stabile Projekt-ID und Codex-Reconnect
  • Fuegt Ende-zu-Ende-verschluesseltes Relay, einmalige Einladungen, multiplexte Streams sowie offizielle oder selbst gehostete Modi hinzu.
  • Verschiebt die Auswahl von Tailscale, privatem LAN oder Relay nach ccb update mobile; das Telefon scannt nur QR oder gibt einen Code ein.
  • Prueft offizielle GitHub-Metadaten, Groesse und SHA-256, bevor Android ein signiertes APK installiert.
  • Bewahrt die Projekt-ID nach Verschiebungen, folgt dem System-Theme und integriert begrenztes opt-in Codex reconnect.
v8.3.1 - Einheitliche Provider-Updates, sichere Cache-Ablösung und persistenter Config-UI-Zugriff
  • Buendelt unterstuetzte Provider-Upgrades in ccb update, einschliesslich exakter Versionspruefung, Ablehnen und versionsgenauem Ueberspringen, ohne aktive Panes neu zu starten.
  • Ersetzt projektbezogene Claude-/Gemini-Software-Caches und bereinigt nur eindeutig CCB-eigene Altlasten; aktive Projekte, Sessions und Auth-Daten bleiben erhalten.
  • Ermoeglicht einen festen Loopback-Port und eine geschuetzte Token-Quelle fuer die Config UI, ohne Token-Werte auszugeben.
  • Erhaelt Shutdown-Finalizer waehrend des Serverstopps und nutzt im Rich Mode ein kompaktes Yazi-Layout mit zwei Spalten.
  • Synchronisiert CLI, npm, Linux, macOS, Android und alle Release-Artefakte auf 8.3.1.
v8.3.0 - Exakte Provider-Turns, Job-Integritaet und projektgebundenes Mobile-Terminal
  • Bindet Kimi, Claude und Qoder an ihre nativen Turn-, Aktivierungs-, Session- und Completion-Vertraege.
  • Ergaenzt Follow-ups fuer den exakten aktiven Job, korrelierte Ausfuehrungsphasen, Diagnose verwaister Inbounds und terminale Cancellation-Ergebnisse.
  • Uebernimmt Provider-Erweiterungen und Copilot-Plugins mit explizitem Ownership-Schutz fuer projizierte Assets.
  • Delegiert npm-verwaltete Upgrades an npm und entfernt Marker-only-Worktrees konservativ.
  • Haelt Mobile-Chat und -Terminal im Workspace des ausgewaehlten Projekts und synchronisiert alle Release-Oberflaechen mit 8.3.0.
v8.2.1 - Deterministischer Start, klare Auth-Recovery und Android-Hintergrundzugriff
  • Fuegt durchgaengige Startup-Generationszaeune, begrenzte Readiness-Nachweise und Zeitliniendiagnosen hinzu.
  • Stoppt aussichtslose Provider-Auth-Neustartschleifen und zeigt die erforderliche Login-Aktion an.
  • Ergaenzt opt-in Android-Hintergrundverbindungen und genau einen laufenden Reply-Status pro Agent.
  • Synchronisiert Linux-, macOS-, npm- und signierte Android-Artefakte auf 8.2.1.
v8.2.0 - Schnellerer Start, Provider-Fixes und Mobile-Zuverlaessigkeit
  • Reduziert wiederholte Arbeit beim ccbd-Start, ohne Lifecycle- und Ownership-Pruefungen abzuschwaechen.
  • Behebt Grok-Fullscreen-Start, erhaelt den Claude-Credential-Typ, stabilisiert Model-/Thinking-Auswahl und haertet Codex-Ask- sowie Reply-Bestaetigungen.
  • Verbessert Mobile-Recovery, Chat, Terminal, Anhaenge, Downloads und FCM; Linux-, macOS-, npm- und signierte Android-Artefakte sind auf 8.2.0 synchronisiert.
v8.0.14 - README-Verzeichnis bereinigt und Mobile-Release-Flaeche synchronisiert
  • Das Root-README.md ist wieder die englische GitHub-Startseite.
  • Lokalisierte README-Dateien liegen jetzt unter README/, die chinesische Version unter zh.md.
  • Mobile-App-Links, package metadata und release notes zeigen auf das 8.0.14 APK.
v8.0.12 - Release-CI-Portabilitaet und README-Lokalisierung
  • Mobile-host-registry-Tests legen temporaere Unix sockets jetzt unter einem kurzen /tmp/ccb-sock-* Pfad ab und vermeiden dadurch AF_UNIX path too long Fehler in macOS CI.
  • ccb update mobile, README-Links, package metadata und das mobile release manifest zeigen jetzt auf das 8.0.12 APK.
  • v8.0.12 fuehrte mehrsprachige READMEs mit gemeinsamer Abschnittsstruktur ein; die aktuellen lokalisierten Dateien liegen im Verzeichnis README/.
v8.0.0 - CCB Mobile Monorepo Release
  • Der Flutter-Source von CCB Mobile wurde offiziell in dieses Repository aufgenommen, mit Android APKs ueber GitHub Releases.
  • Hinzu kamen server-wide mobile project discovery, pairing, authentifizierte gateway routes, pane-native message input, conversation context rendering, terminal access sowie Upload/Download von Bildern und Dokumenten.
  • ccb update mobile wurde zum einheitlichen Tailscale-Tailnet-onboarding entrypoint, waehrend das gateway loopback-only bleibt, Funnel nicht nutzt, keine tokens speichert und ACLs/grants nicht automatisch aendert.
v7.7.0 - Runtime Accelerator Release-Hardening
  • Release artifacts enthalten jetzt den optionalen Rust ccb-runtime-accelerator; installierte Codex agents fallen nicht mehr still auf den Python hot path zurueck, wenn der sidecar erwartet wird.
  • Wenn ein Projektpfad den Unix-socket-Pfad zu lang macht, wechselt der accelerator socket automatisch zu einer kurzen per-user runtime socket root.
  • Callback repair und Codex binding cache invalidation wurden gehaertet, mit aufgezeichneten Regression-, long-idle Codex soak-, Claude callback- und mixed-provider integration-Nachweisen.
v7.6.19 - Standard-Wartepolitik fuer lange ask-Aufrufe
  • Normale lang laufende ask-Aufrufe warten weiter auf echte provider/completion-Ergebnisse, statt nur wegen heartbeat-Diagnosen als incomplete/heartbeat_timeout zu enden.
  • Codex-, Claude- und Gemini-pane-backed no-terminal timeouts sind nun standardmaessig explizit opt-in; explizite reliability timeout policies bleiben verfuegbar.
  • Ein 32-minuetiger source-runtime ask smoke bestaetigte, dass eine Aufgabe ueber 30 Minuten running bleiben und danach mit result_message abschliessen kann, ohne heartbeat_timeout oder incomplete.

Die vollstaendige Historie steht in CHANGELOG.md.