Документация Cookbox.ai

Cookbox.ai — это Android-панель управления для Claude Code, Codex, Cursor и обычных сессий оболочки на машинах, которые у вас уже есть. Подключение идёт напрямую по SSH. Нет ни учётной записи Cookbox, ни ретранслятора Cookbox.

Что где работает

Ничего вашего не выполняется на нашей инфраструктуре. Агент, мультиплексор и ваш код остаются на вашем сервере; телефон — это клиент, который к ним подключается и показывает, что там происходит.

Компонент	Где находится	Задача
Приложение Cookbox.ai	Ваш телефон на Android	Хранит SSH-ключи, рисует терминалы, вибрирует, когда ход завершён.
tmux или zellij	Ваш сервер	Держит сессии живыми между подключениями, поэтому закрытие приложения ничего не завершает.
Claude Code, Codex, Cursor	Ваш сервер	Делает работу — под вашей подпиской и с вашими учётными данными.
`mps` (moshpit)	Ваш сервер, необязательно	UDP-транспорт с локальным эхом: набор текста переживает слабую связь и смену сети.

Что умеет приложение

Сохраняет SSH-серверы и ключи, запоминает ключ каждого сервера при первом подключении и отвергает изменённый.
Показывает, создаёт, переименовывает, возобновляет, отсоединяет и закрывает сессии tmux и zellij.
Показывает, чем занят каждый агент — работает, ждёт вас или простаивает — и расход, если CLI его сообщает.
Держит несколько терминалов подключёнными одновременно, восстанавливает их и уведомляет, когда отслеживаемый агент останавливается.
Загружает изображения и аудио, принимает диктовку и пробрасывает удалённый веб-сервис в приложение или в ваш браузер.
Показывает, что запущено под pm2 на сервере: процессор, память, время работы и перезапуски по каждому приложению, плюс запуск, остановка и перезапуск для любого — а также среднюю загрузку самой машины и свободное место на диске.
Говорит по-английски, по-немецки и по-русски, в тёмной теме (Steam) и светлой (Bento).

Чего он не делает

SSH — это канал управления для обнаружения, загрузок, проброса портов и настройки moshpit; через moshpit идёт только интерактивный трафик терминала, и терминал пишет mp или ssh, так что откат никогда не остаётся загадкой. Кроме того:

Никаких учётных записей, рекламных SDK, аналитических SDK и ретрансляторов, которые видят ваши терминалы. См. политику конфиденциальности.
Ни размещённого агента, ни размещённой машины — сервер и подписку на агента приносите вы.
Сборки для iOS пока нет, и нет уведомлений для серверов, кроме подключённого.

Что нужно

Android 7.0 или новее.
Linux-сервер, доступный по SSH. WSL 2 подходит, если SSH завершается внутри Linux; macOS работает как урезанная предварительная версия, без определения состояния агентов и портов.
tmux или zellij на этом сервере и хотя бы один CLI агента, если вам нужна не только оболочка.

Установщик делает всё это одной командой, включая CLI агентов и приватный сетевой маршрут. Аутентификация агента всегда отдельна и всегда ваша: после установки выполните на сервере claude, codex или cursor-agent login.

С чего начать

Установите приложение из Google Play.
Подготовьте сервер — настройка сервера описывает всё целиком, а сопряжение по QR-коду — её короткая версия.
Сохраните подключение и при первом соединении сверьте отпечаток ключа сервера.
Откройте сессию и держите шпаргалку по навигации под рукой первую неделю.

Сессии Codex, созданные Cookbox, запускаются с --yolo, что отключает подтверждения и песочницу Codex. Если такая политика для сервера не подходит, запустите Codex там сами, а Cookbox пусть подключится к готовой сессии.

Известные ограничения

Состояние агента читается из /proc в Linux и с экрана терминала. Это хорошая эвристика, а не API; счётчики расхода скорее исчезнут, чем соврут.
Уведомления держатся на опросе: ход, который начался и закончился между двумя опросами, можно пропустить, и режим Doze в Android тоже действует.
Приватные ключи лежат в приватном хранилище приложения, а не в Android Keystore.
Загруженные файлы остаются на сервере в ~/.cookbox/uploads, пока вы их не удалите.
Нетекстовый файл, открытый в другом приложении, сначала копируется в собственное хранилище Cookbox, и хранится только последняя копия — открытие следующего файла её стирает.
Проброшенные страницы внутри приложения — это iframe без собственной истории; для всего, что переходит по ссылкам, используйте действие «открыть в браузере».