CCB - мобильное приложение уже здесь!
August 15, 2026 · View on GitHub
CCB - мобильное приложение уже здесь!
Легкий multi-agent TUI со стабильным слоем взаимодействия между провайдерами
Координируйте Codex, Claude, Gemini и другие CLI Agent в видимых и управляемых процессах, которые можно напрямую взять под контроль
中文 | English | 日本語 | Français | Deutsch | العربية | Español | Português | 한국어 | Русский
Быстрый старт · Mobile App · Rich-режим · Настройка agents · Руководство пользователя · Руководство разработчика
Почему 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.
Панель настраивает 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
Эта команда проведет через установку и настройку.
Детали Mobile App, граница безопасности и исходники
CCB 8.6.6 включает Flutter source CCB Mobile в mobile/ и публикует Android APK через GitHub Releases:
- Скачать CCB Mobile v8.6.6 APK
- Исходники app:
mobile/app - Исходники server gateway:
lib/mobile_gateway
Телефонное приложение является удаленным контроллером для реальных 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 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_engineer | Frontend design и implementation, design systems, accessibility, browser QA и проверенная AGY delegation. |
agentroles.mobile_app_engineer | Mobile 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.
Контакты
- Email:
bfly123@126.com - Telegram group & contact / TG 群与联系
- WeChat:
seemseam-com
Сообщество и благодарности
Спасибо сообществу 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
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.