Pi Pocket CLI
Веб-приложение для кодингового агента Pi: сессии переживают перезапуск, к ним можно подключать коллег и работать с телефона, без облачной виртуалки
- 637 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Любой участник с правом руководить агентом выполняет команды на вашей машине от вашего имени
- Режим `cloudflare` открывает сервер по ссылке любому, у кого она есть, а ссылка для входа служит ключом владельца
- Встроенный браузер и расписание дают агенту ходить в сеть и работать, пока вы не смотрите
Установка
Ручная установка
git clone https://github.com/TannerMidd/pi-pocket.git && cd pi-pocket && npm install && npm startНужен Node.js 22.19 или новее и вход в провайдера через Pi (`pi`, затем /login). Лаунчер выведет адрес, ссылку для входа и QR-код.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Любой участник с правом руководить агентом выполняет команды на вашей машине от вашего имени
- Режим `cloudflare` открывает сервер по ссылке любому, у кого она есть, а ссылка для входа служит ключом владельца
- Встроенный браузер и расписание дают агенту ходить в сеть и работать, пока вы не смотрите
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Pi Pocket запускает на вашей машине веб-интерфейс для кодингового агента Pi и делает его удобным с телефона. Команда `npm start` поднимает сервер, выводит адрес, ссылку для входа и QR-код. Каждый вызов модели, инструмента и субагента сохраняется по ходу работы в базе pocket.sqlite, поэтому после перезапуска сервера агент продолжает задачу, а оборванный вызов повторяется, только если это безопасно. В сессию можно пригласить коллег: у них есть присутствие, побочный чат, который агент не видит, упоминания, закрепления и общие заметки. Права выдаются ролями, с правом руководить или только просмотра, а лимиты расходов задаются на человека и на сессию. Ассистент PiP открывается по Alt+A над любым экраном и просматривает, запускает и пишет в другие сессии, а наблюдатели следят за репозиторием на GitHub, например за упавшим CI на main. Внутри приложения есть вкладки с файлами и построчное сравнение незакоммиченных изменений, встроенный Chromium для страниц, расписание сообщений агенту, режим плана, где ничего не меняется до одобрения, форки сессий с отдельным git worktree и галерея расширений. Запускается на Linux, macOS, Windows и Android через Termux.
Для кого. Для разработчиков, которые работают с агентом Pi и хотят следить за долгими задачами с телефона или вести одну сессию вместе с командой.
Подходит, если
- Агент Pi долго работает над задачей, и вы хотите видеть ход, одобрять вызовы и отвечать на вопросы с телефона
- Сервер приходится перезапускать посреди прогона, а работу терять нельзя
- Коллеге нужно дать посмотреть сессию или порулить агентом, не пуская его на свою машину целиком
- Нужно расписание вроде сводка по CI каждый будний день в 8:00 или команда `/until npm test`, которая гоняет агента до зеленой проверки
- Хотите смотреть и тыкать страницу своего сервера разработки в Chromium на сервере, в том числе с телефона
Не подходит, если
- Вы работаете с Claude Code, Cursor или Codex: приложение собрано вокруг агента Pi и его рантайма
- Нельзя давать никому, кроме себя, право запускать команды на машине: у любого с правом руководить агент выполняет команды от вашего имени
- Нет Node.js 22.19 или новее и нет желания его ставить
- Нужен облачный сервис с поддержкой и гарантиями: проект выпускается автором как самостоятельный открытый софт
Пример запроса к агенту
/schedule every weekday 8:00 summarize CIОграничения
Требуется Node.js 22.19 или новее и предварительный вход в провайдера через Pi (`pi`, затем /login). Лучше всего проверен Linux. Ссылка для входа служит ключом владельца, поэтому ее нельзя пересылать, а `--rotate-token` отзывает старую. Любой пользователь с правом руководить агентом может выполнять команды на машине от вашего имени и добраться до файлов, настроек и токенов Pi Pocket. Одиночное приглашение ограничивает видимое в приложении, но круг доступных агенту ресурсов остается прежним. Защита Lancet Guard по умолчанию выключена, ей нужен ONNX Runtime, который на Android может не загрузиться. Режим `cloudflare` открывает адрес любому, у кого есть ссылка.
Как отключить. Нажмите q в окне запуска, чтобы остановить сервер, и удалите папку pi-pocket. Данные лежат в `~/.pi-pocket`: удалите ее, чтобы стереть базу, настройки и ключи уведомлений.
Частые вопросы
Как запустить Pi Pocket?
Нужен Node.js 22.19 или новее и Pi, в который вы уже вошли у провайдера. Склонируйте репозиторий, выполните `npm install` и `npm start`. Лаунчер спросит, как подключаться устройствам, и выведет адрес, ссылку для входа и QR-код. Ссылку достаточно открыть один раз в каждом браузере, вход запоминается на год.
Какие режимы удаленного доступа есть?
Четыре: `local` слушает только 127.0.0.1, `lan` открывает локальную сеть по обычному http, `cloudflare` дает бесплатный https-туннель без аккаунта, а `tailscale` доступен только внутри вашей сети tailnet. Для другого туннеля, например ngrok, выберите `local` и направьте туннель на порт 8787.
Работает ли Pi Pocket на телефоне?
Да, двумя способами. Интерфейс открывается в браузере телефона и ставится на домашний экран. Сам сервер тоже можно запустить на Android через Termux: поставьте nodejs и git, затем Pi и склонируйте проект.
Что такое Lancet Guard?
Расширение, которое по умолчанию выключено. Если включить его в меню Extensions и поставить пакет specpi-lancet-guard, опасные вызовы bash, write и edit будут ждать одобрения кого-то из участников сессии. Если защита включена, но не загрузилась, Pi Pocket блокирует эти вызовы.
Как задать лимит расходов на человека?
Лимиты на расходы задаются отдельно для каждого приглашенного и для каждой сессии вместе с ролью: руководить агентом или только смотреть. Роль и доступ выдаются через одноразовые ссылки и QR-коды, а список людей лежит в меню People.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыМинималистичный агент для кода в терминале, который расширяется скиллами, шаблонами промптов и пакетами на TypeScript
Расширение для агента Pi (pi.dev): субагенты и оркестрация в стиле Claude Code, виджет и сценарии на JavaScript. Не для Claude Code
Кодинг-агент, настроенный под маленькие локальные модели: минимальный системный промпт, режим планирования и фоновые суб-агенты для исследования
Локальный ИИ-агент, который работает на своем железе через llama.cpp, водит браузер, правит файлы, выполняет разрешенные команды и помнит контекст между сессиям
Самостоятельный агент-платформа для одного рабочего места: чат с планированием, база знаний, MCP-инструменты, скиллы, память и песочница
Самостоятельно размещаемый рантайм для кодовых агентов: каждый экипаж в своем Linux-контейнере, вокруг них панель управления с ролями и аудитом
Коротко о README
README открывается скриншотом приложения на компьютере и телефоне и быстрым стартом из четырех команд. Дальше идет список возможностей, таблица режимов удаленного доступа с предупреждением о правах руководителя, инструкция для Android через Termux и раздел про Nix и NixOS с модулем сервиса. В конце приведены таблица параметров запуска, переменные окружения и карта каталогов проекта.