CCB - мобильное приложение уже здесь!

August 15, 2026 · View on GitHub

CCB - мобильное приложение уже здесь!

Легкий multi-agent TUI со стабильным слоем взаимодействия между провайдерами
Координируйте Codex, Claude, Gemini и другие CLI Agent в видимых и управляемых процессах, которые можно напрямую взять под контроль

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 | 한국어 | Русский

Быстрый старт · Mobile App · Rich-режим · Настройка agents · Руководство пользователя · Руководство разработчика

Видимое multi-agent CLI рабочее пространство CCB

Почему CCB?

  • Стабильная коммуникация между agents для сложных графов сотрудничества, таких как A -> B -> C, A,B -> C и A -> B,C.
  • Каждый agent является полноценным нативным терминалом с видимым управлением layout и прямым перехватом управления.
  • Фоновый daemon сохраняет состояние проекта даже после закрытия foreground UI.
  • Возможность Hub: параллельно запускать несколько CLI providers одной командой.
  • Мобильный удаленный контроллер: голосовое управление между providers, передача файлов и доступ к удаленному терминалу.

Как установить

Устанавливайте или обновляйте управляемую npm установку через npm:

npm install -g @seemseam/ccb@latest

Для установки из GitHub release или исходников используйте транзакционный updater CCB:

ccb update

В установке под управлением npm команда ccb update выводит эквивалентную npm-команду и не изменяет vendored payload.

GitHub release package и установка из исходников как fallback

Если npm неудобен в вашей среде, скачайте подходящий пакет из Releases, распакуйте и установите:

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

Установка из исходников предназначена только для разработки или временного fallback:

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

Установка из исходников связывает глобальные команды ccb / ask с текущим checkout. Обычным пользователям рекомендуется npm package.

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

1. Запуск

Выполните в рабочем каталоге:

ccb

Если запуск сообщает, что .ccb не может быть создан автоматически или отсутствует project anchor, создайте .ccb вручную:

mkdir -p .ccb

2. Создать конфигурацию проекта

Пустой проект запускается в легком режиме: CCB открывает только одно window main, выбирает первый доступный на машине поддерживаемый CLI и создает одного agent с именем demo. Multi-agent команда больше не монтируется по умолчанию.

Нажмите ⚙ Настройки в левом верхнем углу sidebar CCB, чтобы открыть локальную панель конфигурации. Ее также можно запустить командой ccb config ui.

Панель конфигурации CCB для стандартного agent demo

Панель настраивает windows, splits panes, providers, models, thinking levels, API overrides, workspaces, Rich mode и sidebar. Перед сохранением выполняется проверка; доступны reload dry-run и защищенный hot reload.

Для расширенной multi-agent topology добавьте agents визуально или создайте .ccb/ccb.config вручную. , и ; управляют вертикальной укладкой и горизонтальными splits; A,B;C,D близко к четырем 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

Проверьте конфигурацию и запустите workspace:

ccb config validate
ccb

3. Совместная работа

Можно вводить текст напрямую в любой agent pane или позволить agents сотрудничать:

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

Agents также могут вызывать /ask во время workflow orchestration, чтобы делегировать и передавать работу. Для устойчивой координации используйте agent memory или общий файл памяти проекта .ccb/ccb_memory.md.

Мобильное удаленное управление (Android)

Рекомендуемый способ управления CCB с телефона может подключаться ко всем CCB projects, управлять каждым agent, принимать голосовой ввод и передавать файлы.

ccb update mobile

Эта команда проведет через установку и настройку.

Чат agent в CCB Mobile Управление терминалом в CCB Mobile Передача файлов в CCB Mobile Pairing и подключение в CCB Mobile

Детали Mobile App, граница безопасности и исходники

CCB 8.6.6 включает Flutter source CCB Mobile в mobile/ и публикует Android APK через GitHub Releases:

Телефонное приложение является удаленным контроллером для реальных CCB projects, работающих на сервере. Оно может находить mounted projects через server-wide mobile gateway, переключать windows и agents, отображать контекст разговоров agents, отправлять текст через pane-native input, открывать terminal view и загружать/скачивать изображения и документы через authenticated gateway.

Граница безопасности:

  • CCB gateway привязывается только к loopback, например 127.0.0.1:8787.
  • Удаленный доступ использует Tailscale Serve, а не Tailscale Funnel.
  • CCB не хранит пароли Tailscale, OAuth tokens или admin API tokens и не изменяет автоматически tailnet ACLs/grants.
  • Телефон получает только scopes, разрешенные pairing profile, например view, content, terminal, file upload и file download.

Rich media terminal

Просматривайте деревья файлов, открывайте файлы, редактируйте документы и preview медиа внутри терминала.

CCB rich media workbench с Yazi preview в WezTerm

ccb update rich

После включения rich mode обычный ccb автоматически открывает rich WezTerm launcher, если он еще не работает внутри CCB-managed rich WezTerm session. Выполните ccb uninstall rich, чтобы вернуться к обычному запуску терминала.

Agent Roles Spec и каталог ролей

CCB поддерживает Agent Roles Spec, host-neutral спецификацию для упаковки специализированных agents. Она может объединять skills, memory и tool dependencies в устанавливаемые, монтируемые и удаляемые Role Packs. Этот репозиторий также служит публичным каталогом ролей.

RoleНазначение
agentroles.ccb_selfСамообслуживание CCB, помощь с конфигурацией, runtime diagnosis, protected recovery и workflow orchestration.
agentroles.archiАрхитектурный review, проверка границ, анализ связности, риски maintainability и рекомендации gate.
agentroles.frontend_engineerFrontend design и implementation, design systems, accessibility, browser QA и проверенная AGY delegation.
agentroles.mobile_app_engineerMobile design и implementation для iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose и другого.
agentroles.motherСоздание ролей, role source audit, role research, blueprint design и проверки соответствия Agent Roles spec.
agentroles.su_ccbОперации SU-CCB workflow для анализа требований, planning, dispatch, review gates, архивирования и recovery.

Конфигурация и общая память

Для обычной конфигурации проекта используйте панель ⚙ Настройки. Для настройки с помощью agent и runtime diagnosis ccb_self остается доступным как optional Role Pack и добавляется командой ccb roles add agentroles.ccb_self:codex.

.ccb/ccb_memory.md является проектным документом общей памяти. Используйте его для правил командной работы, ограничений проекта, долгоживущего контекста и соглашений handoff между agents. Стабильная информация между agents должна храниться там, а не копироваться в несколько provider-private memory files.

Контакты

Группа WeChat

Сообщество и благодарности

Спасибо сообществу Linux.do за тестирование, обратную связь и обсуждения.

Спасибо tmux-agent-sidebar за идеи и вдохновение для sidebar.

Release Notes

v8.4.0 - Шифрованный Mobile Relay, простое сопряжение, стабильный ID и переподключение Codex
  • Добавляет сквозное шифрование Relay, одноразовые приглашения, мультиплексированные потоки и официальный либо собственный сервер.
  • Переносит выбор Tailscale, private LAN или Relay в ccb update mobile; на телефоне остаётся QR или код сопряжения.
  • Проверяет официальные metadata GitHub, размер и SHA-256 перед передачей подписанного APK системе Android.
  • Сохраняет ID после переноса проекта, следует системной теме и интегрирует ограниченный opt-in reconnect для Codex.
v8.3.1 - Единое обновление providers, безопасный вывод кешей и постоянный доступ к Config UI
  • Объединяет поддерживаемые обновления providers в ccb update: точная проверка версии, отказ и пропуск конкретной версии без перезапуска активных panes.
  • Выводит из эксплуатации проектные кеши Claude/Gemini и удаляет только подтверждённые CCB legacy-данные; активные проекты, sessions и данные аутентификации сохраняются.
  • Позволяет задать стабильный loopback-порт и защищённый источник token для Config UI без вывода значения token.
  • Сохраняет shutdown finalizers во время остановки сервера и использует компактный двухколоночный Yazi layout в Rich mode.
  • Синхронизирует CLI, npm, Linux, macOS, Android и все release-артефакты с 8.3.1.
v8.3.0 - Точные provider-turn, целостность jobs и Mobile-терминал внутри проекта
  • Kimi, Claude и Qoder привязаны к своим нативным контрактам turn, активации, сессии и завершения.
  • Добавлены follow-up для точного active job, коррелированные фазы выполнения, диагностика потерянных inbound и терминальный результат отмены.
  • Расширения providers и плагины Copilot наследуются с явной защитой ownership проецируемых assets.
  • Обновления npm-managed установок переданы npm, а worktree только с маркерами удаляются консервативно.
  • Чат и терминал Mobile остаются в workspace выбранного проекта; все release-поверхности синхронизированы с 8.3.0.
v8.2.1 - Детерминированный запуск, понятное восстановление авторизации и фоновое подключение Android
  • Добавлены ограждение поколений запуска, ограниченная проверка готовности и диагностика операций и временной шкалы.
  • Остановлены бесполезные циклы перезапуска при неисправимой ошибке авторизации провайдера; показывается нужное действие входа.
  • Добавлены включаемое пользователем фоновое подключение Android и один статус активного ответа на Agent.
  • Артефакты Linux, macOS, npm и подписанный Android APK синхронизированы с 8.2.1.
v8.2.0 - Ускоренный запуск, исправления провайдеров и надежность Mobile
  • Сокращена повторная работа при запуске ccbd без ослабления проверок lifecycle и ownership.
  • Исправлены fullscreen-запуск Grok, сохранение типа credential Claude, выбор model/thinking и доставка Codex ask/reply.
  • Улучшены recovery, chat, terminal, вложения, downloads и FCM в Mobile; Linux, macOS, npm и подписанный Android artifact синхронизированы с 8.2.0.
v8.0.14 - Упорядочен каталог README и mobile release surface
  • Корневой README.md снова является английской страницей GitHub.
  • Локализованные README теперь находятся в README/, китайская версия - zh.md.
  • Ссылки Mobile App, package metadata и release notes указывают на APK 8.0.14.
v8.0.12 - Переносимость Release CI и локализация README
  • Тесты mobile host registry теперь размещают временные Unix sockets в коротком пути /tmp/ccb-sock-*, чтобы избежать ошибок AF_UNIX path too long в macOS CI.
  • ccb update mobile, ссылки README, package metadata и mobile release manifest теперь указывают на APK 8.0.12.
  • v8.0.12 добавил многоязычный набор README с общей структурой разделов; текущие локализованные файлы находятся в каталоге README/.
v8.0.0 - Релиз CCB Mobile Monorepo
  • Flutter source CCB Mobile официально вошел в этот репозиторий, а Android APK публикуется через GitHub Releases.
  • Добавлены server-wide mobile project discovery, pairing, authenticated gateway routes, pane-native message input, conversation context rendering, terminal access и upload/download изображений и документов.
  • ccb update mobile стал единым entrypoint для Tailscale Tailnet onboarding, при этом gateway остается loopback-only, Funnel не используется, tokens не сохраняются и ACLs/grants не изменяются автоматически.
v7.7.0 - Укрепление релиза Runtime Accelerator
  • Release artifacts теперь включают optional Rust ccb-runtime-accelerator; installed Codex agents больше не откатываются тихо на Python hot path, когда ожидается sidecar.
  • Если путь проекта делает Unix socket path слишком длинным, accelerator socket автоматически переходит в короткий per-user runtime socket root.
  • Усилены callback repair и Codex binding cache invalidation, с зафиксированными доказательствами regression, long-idle Codex soak, Claude callback и mixed-provider integration.
v7.6.19 - Политика ожидания по умолчанию для долгих ask
  • Обычные долгие вызовы ask теперь продолжают ждать реальные provider/completion результаты вместо завершения как incomplete/heartbeat_timeout только из-за heartbeat diagnostics.
  • Pane-backed no-terminal timeouts для Codex, Claude и Gemini теперь по умолчанию explicit opt-in, при этом explicit reliability timeout policies остаются доступными.
  • 32-минутный source-runtime ask smoke подтвердил, что задача может оставаться running более 30 минут, затем завершиться с result_message, без признаков heartbeat_timeout или incomplete.

Полная история находится в CHANGELOG.md.