VorobeoffAIВиталий Воробьев

Pi Pocket: self-hosted веб-клиент для кодинг-агента Pi

Как Pi Pocket выносит кодинг-агента Pi из терминала в браузер и на телефон, сохраняет работу после перезапуска и даёт работать над одной сессией вдвоём.

Pi Pocket позволяет управлять кодинг-агентом Pi из браузера, в том числе с телефона. Приложение можно запустить на собственном компьютере, сервере или Android-устройстве через Termux. Оно сохраняет состояние задач, чтобы после перезапуска сервера агент мог продолжить работу.

Что это

Pi Pocket — веб-приложение для кодинг-агента Pi. Сам Pi — минималистичный расширяемый агент для программирования, который работает в терминале и поддерживает модели разных провайдеров. Он распространяется в пакете @earendil-works/pi-coding-agent. Pi Pocket добавляет веб-интерфейс и серверную часть: один процесс Node.js, базу данных SQLite и приложение, для которого не нужна отдельная сборка. Автор проекта — Tanner Middleton; Pi Pocket распространяется по лицензии MIT и не связан с разработчиком Pi, Earendil. Актуальная на 17 ноября 2026 года стабильная версия — 0.29.0. Приложение работает на Linux, macOS, Windows и Android через Termux.

Pi Pocket: список сессий, открытый диалог и поле управления агентом
Pi Pocket: список сессий, открытый диалог и поле управления агентом

В основе Pi Pocket лежит Pi Durable — система выполнения и сохранения длительных задач агента. Она хранит разговоры, задачи и документы в общем хранилище и записывает результаты этапов работы до их отображения в интерфейсе. Pi Durable пока считается экспериментальным проектом: его программный интерфейс (API) может меняться между версиями.

Ключевое правило: кто может управлять сессией, тот получает доступ к машине. Приглашайте только тех, кому доверили бы терминал.

Если нужно управлять несколькими агентами, работающими через командную строку, посмотрите на панель Paseo. Pi Pocket сосредоточен на агенте Pi: его длительных задачах, восстановлении работы и совместном доступе к одной сессии.

Зачем нужно

  • Управлять агентом с телефона и планшета: получать push-уведомления, диктовать сообщения и добавить приложение на главный экран.
  • Работать вдвоём в одной сессии: видеть подключённых участников, передавать управление, общаться в отдельном чате, недоступном агенту, и согласовывать рискованные команды.
  • Выполнять длительные задачи: при перезапуске сервера сохранённое состояние позволяет продолжить работу. Сам сервер при этом должен быть запущен.
  • Работать в собственной среде: агент получает доступ к нужным файлам, репозиториям Git и локальным сервисам. При использовании удалённой ИИ-модели содержимое запросов и фрагменты кода могут передаваться её провайдеру.
  • Добавлять расширения без изменения основного кода: подключать свои инструменты, элементы промпта, серверные маршруты и страницы интерфейса через отдельные модули.

Для push-уведомлений нужен адрес с HTTPS; на iPhone приложение также необходимо добавить на главный экран. Диктовка работает в браузерах с поддержкой распознавания речи и требует HTTPS либо доступа через localhost. В Chrome распознавание может происходить на серверах Google.

Как устроено

КомпонентНазначениеГде живёт
PocketApp
Серверное ядро: хранит сведения о сессиях, проверяет права доступа, отслеживает сохранённые изменения и учитывает расходы на модели
src/server/app.ts
Pi Durable
Хранит разговоры, задачи и документы, записывает состояние работы для восстановления после перезапуска
@earendil-works/pi-durable, pocket.sqlite
Комнаты и события
Объединяют изменения за короткий интервал и отправляют вкладкам только обновления через поток событий или периодические запросы
room.ts, http/events.ts
Веб-приложение
Интерфейс на Preact и htm без отдельной сборки; изменения в web/ обновляют открытые вкладки
web/
Расширения
Встроенные функции и пользовательские модули из ~/.pi-pocket/extensions/; галерея проверяет целостность загружаемых файлов
src/server/extensions/
Запуск и доступ
Предлагает способ подключения и настраивает удалённый доступ
src/launcher/; режимы: local, lan, cloudflare, tailscale, tailscale-serve
Встроенный браузер
Запускает Chromium на сервере; страницей могут пользоваться интерфейс и инструмент агента browser
browser.ts

Для восстановления работы Pi Durable сохраняет контрольные точки: результаты обращений к модели, вызовов инструментов и подзадач. Если сервер неожиданно завершит работу, после запуска он откроет прежнее хранилище и восстановит выполнение с сохранённого этапа. Интерфейс показывает уже записанные события, поэтому история действий согласована с состоянием задачи.

Например, пользователь поручил агенту изменить файлы и запустить тесты. Если в процессе сервер перезапустился, агент использует сохранённые результаты. Уже выполненные этапы не нужно проходить заново, а прерванные операции обрабатываются с учётом безопасности повторного запуска.

Каждый запрос к модели получает идентификатор, по которому система различает обращения и распознаёт повторные отправки после сетевого сбоя. Решения пользователя, например разрешение на выполнение команды, сохраняются вместе с состоянием задачи и не требуют повторного согласования после перезапуска. Прерванный вызов инструмента запускается снова только тогда, когда повтор безопасен. Иначе агент получает сообщение о прерывании.

Pi Pocket отвечает за интерфейс, доступ к сессиям и сохранение их состояния. Это другая задача, чем у MCP: протокол помогает подключать ИИ-агентов к внешним инструментам и данным. Подробнее о нём — в материале «Что такое MCP-сервер».

Когда использовать

СитуацияПодходит / не подходитПочему
Нужно управлять агентом с телефона
Подходит
Интерфейс адаптирован для мобильного экрана; доступны уведомления, диктовка и жесты навигации
Одна сессия на двоих
Подходит
Есть роли владельца, участника с правом управления и наблюдателя; можно передавать управление и согласовывать действия
Длительная задача с восстановлением после сбоя
Подходит
Состояние задач и очередь сообщений сохраняются, поэтому после перезапуска работа может продолжиться
Нужно хранить рабочую среду на своей машине
Подходит
Pi Pocket размещается на вашей инфраструктуре; при использовании облачных моделей содержимое запросов может передаваться провайдеру
Нет постоянно работающего компьютера или сервера
Не подходит
Для удалённого управления машина с Pi Pocket должна быть включена и доступна по сети
Нужна готовая изолированная среда для выполнения команд
Не подходит
Участник с правом управления может запускать команды от имени пользователя сервера. Изоляцию нужно настраивать самостоятельно
Chromium на Windows обязателен для панели браузера
Ограниченно
Браузерная панель проверена на Linux и macOS, на Windows не тестировалась

Если основной способ общения с агентом — мессенджер, посмотрите на OpenClaw, где подключение каналов организовано через единый шлюз (Gateway). В Pi Pocket версии 0.29.0 появился встроенный модуль Relay для Discord, Telegram, Slack и Matrix, но основным интерфейсом остаётся веб-приложение.

Пример

Для установки понадобится Node.js версии 22.19 или новее. После запуска потребуется авторизоваться у провайдера ИИ-модели: сначала через Pi (pi, затем /login) или в разделе Providers самого Pi Pocket. Команды установки приведены в официальном README проекта.

npm install -g pi-pocket
pi-pocket

При первом запуске программа предложит выбрать способ подключения, затем покажет ссылку для входа и QR-код. Ссылка предоставляет права владельца, поэтому её нельзя передавать посторонним. Для доступа с телефона вне локальной сети можно выбрать, например, режим cloudflare или tailscale-serve; для явного выбора используйте команду pi-pocket —access cloudflare. Чтобы заменить скомпрометированный токен владельца, предусмотрена команда pi-pocket —rotate-token.

git clone https://github.com/TannerMidd/pi-pocket.git
cd pi-pocket
npm install
npm start

Второй способ нужен тем, кто хочет изменять исходный код приложения. Изменения в каталоге web/ обновляют открытые вкладки, а модули из src/server/extensions/ могут перезагружаться без полной остановки сервера.

Официальная документация Pi Pocket: расширения, инструменты, модули интерфейса и безопасность
Официальная документация Pi Pocket: расширения, инструменты, модули интерфейса и безопасность

Для первого входа с телефона откройте ссылку или отсканируйте QR-код, который покажет приложение. Вручную вводить токен в командную строку не требуется.

Pi Pocket позволяет запускать агента на собственной машине и обращаться к нему с другого устройства. При таком подходе ответственность за доступность сервера, защиту файлов и права участников остаётся у владельца установки.

Ссылки

По теме

Продолжить тему

Материалы, которые связаны с этим разбором

Подборка учитывает тему, редкие теги и смысл заголовка с описанием материала.

Открыть материалы по теме ↗

Обсудить задачу

Есть задача, которую хотите усилить с помощью ИИ?

Опишите процесс, что уже пробовали и какой результат хотите получить. Я помогу понять, где ИИ и автоматизация действительно дадут эффект, и предложу понятный следующий шаг.

Для первого сообщения достаточно пары абзацев — готовое техническое задание не требуется.