# CCB - мобильное приложение уже здесь!
**Легкий multi-agent TUI со стабильным слоем взаимодействия между провайдерами**
**Координируйте Codex, Claude, Gemini и другие CLI Agent в видимых и управляемых процессах, которые можно напрямую взять под контроль**
## Почему CCB?
- Стабильная коммуникация между agents для сложных графов сотрудничества, таких как `A -> B -> C`, `A,B -> C` и `A -> B,C`.
- Каждый agent является полноценным нативным терминалом с видимым управлением layout и прямым перехватом управления.
- Фоновый daemon сохраняет состояние проекта даже после закрытия foreground UI.
- Возможность Hub: параллельно запускать несколько CLI providers одной командой.
- Мобильный удаленный контроллер: голосовое управление между providers, передача файлов и доступ к удаленному терминалу.
## Как установить
Устанавливайте или обновляйте управляемую npm установку через npm:
```bash
npm install -g @seemseam/ccb@latest
```
Для установки из GitHub release или исходников используйте транзакционный updater CCB:
```bash
ccb update
```
В установке под управлением npm команда `ccb update` выводит эквивалентную npm-команду и не изменяет vendored payload.
GitHub release package и установка из исходников как fallback
Если npm неудобен в вашей среде, скачайте подходящий пакет из [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases), распакуйте и установите:
```bash
tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install
```
Установка из исходников предназначена только для разработки или временного fallback:
```bash
git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install
```
Установка из исходников связывает глобальные команды `ccb` / `ask` с текущим checkout. Обычным пользователям рекомендуется npm package.
## Быстрый старт
### 1. Запуск
Выполните в рабочем каталоге:
```bash
ccb
```
Если запуск сообщает, что `.ccb` не может быть создан автоматически или отсутствует project anchor, создайте `.ccb` вручную:
```bash
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.
```toml
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:
```bash
ccb config validate
ccb
```
### 3. Совместная работа
Можно вводить текст напрямую в любой agent pane или позволить agents сотрудничать:
```text
/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, принимать голосовой ввод и передавать файлы.
```bash
ccb update mobile
```
Эта команда проведет через установку и настройку.
Детали Mobile App, граница безопасности и исходники
CCB 8.5.2 включает Flutter source CCB Mobile в [`mobile/`](../mobile/) и публикует Android APK через GitHub Releases:
- [Скачать CCB Mobile v8.5.2 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.5.2/ccb-mobile-v8.5.2.apk)
- Исходники app: [`mobile/app`](../mobile/app)
- Исходники server gateway: [`lib/mobile_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 медиа внутри терминала.
```bash
ccb update rich
```
После включения rich mode обычный `ccb` автоматически открывает rich WezTerm launcher, если он еще не работает внутри CCB-managed rich WezTerm session. Выполните `ccb uninstall rich`, чтобы вернуться к обычному запуску терминала.
## Agent Roles Spec и каталог ролей
CCB поддерживает [Agent Roles Spec](https://github.com/SeemSeam/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 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
- WeChat: `seemseam-com`
## Сообщество и благодарности
Спасибо [сообществу Linux.do](https://linux.do) за тестирование, обратную связь и обсуждения.
Спасибо [tmux-agent-sidebar](https://github.com/hiroppy/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`](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](../CHANGELOG.md).
