pi-web — плагин
Расширение для агента Pi: веб-интерфейс на Go для сессий с телефона и ноутбука с удаленным доступом через Tailscale
- 119 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сервер читает журналы сессий агента и принимает команды из браузера, а при удаленном доступе открывается в сети Tailscale
- Пакет ставит бинарный файл и включает автозапуск при входе в систему
Установка
Ручная установка
pi install npm:@ygncode/pi-web@betaКоманда Pi. Скачивает бинарный файл, настраивает автозапуск и регистрирует команды /web, /pi-web, /remote и /refresh.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер читает журналы сессий агента и принимает команды из браузера, а при удаленном доступе открывается в сети Tailscale
- Пакет ставит бинарный файл и включает автозапуск при входе в систему
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pi-web ставится в агента Pi одной командой `pi install npm:@ygncode/pi-web@beta` и открывает его сессии в браузере по адресу `http://127.0.0.1:31415`. Сервер на Go читает журналы разговоров Pi из `~/.pi/agent/sessions/`, показывает их в приложении, которое ставится как PWA, и передает новые сообщения потоком SSE. Чаты из браузера обслуживают процессы `pi --mode rpc`, по одному на сессию, их освобождают после 10 минут простоя. Плагин регистрирует в Pi четыре команды: `/web` открывает текущую сессию в браузере, `/pi-web` показывает состояние и управляет сервером, `/remote` выдает QR-код и адрес для доступа по Tailscale, `/refresh` возвращает в терминал сообщения, написанные из браузера. Пакет скачивает нужный бинарный файл и настраивает автозапуск при входе: `launchd` на macOS, `systemd` на Linux, запись HKCU в Windows. Заголовки сессий можно создавать встроенной эвристикой без модели или выбрать малую модель. Для удаленного доступа токен задают в `~/.config/pi-web/env`.
Для кого. Пользователям агента Pi, которые хотят продолжать сессии с телефона или планшета и держать личное рабочее место на своем компьютере.
Подходит, если
- Сессия Pi идет на домашнем компьютере, и нужно проверить ее ход с телефона, пока вы не за столом
- Сообщение хочется набрать в браузере, а потом вернуть его в терминальную сессию командой `/refresh`
- Нужен удаленный доступ по HTTPS внутри собственной сети Tailscale через QR-код `/remote`
- Сессии надо называть автоматически, без обращения к модели, по встроенной эвристике
Не подходит, если
- Используется другой агент, не Pi: расширение работает только с журналами сессий Pi
- Нельзя открывать на компьютере автозапуск и сетевой сервер: пакет сам настраивает `launchd`, `systemd` или запись реестра
- Нужна стабильность: проект в бета-версии, и автор предупреждает, что все может ломаться
Пример запроса к агенту
Открой текущую сессию в браузере через /web и покажи QR-код для доступа с телефона через /remote.Ограничения
Проект в бета-версии, команда установки содержит тег `@beta`, и поведение может меняться. Пакет ставит бинарный файл в `~/.pi/agent/bin/pi-web` и включает автозапуск при входе в систему. Для удаленного доступа нужен запущенный и авторизованный Tailscale, на macOS его приходится открывать вручную и подтверждать запрос администратора. Задайте `PI_WEB_TOKEN` в файле `~/.config/pi-web/env`, если открываете сервер за пределами локального адреса. Расширение работает только с агентом Pi и его журналами.
Как отключить. Остановите сервер командой /pi-web, затем уберите пакет средствами Pi. Автозапуск лежит в com.pi-web.plist на macOS, pi-web.service на Linux или в ключе Run реестра на Windows, удалите его вручную.
Частые вопросы
Как поставить pi-web?
Выполните `pi install npm:@ygncode/pi-web@beta`. Команда скачает нужный бинарный файл, настроит автозапуск и добавит команды `/web`, `/pi-web`, `/remote` и `/refresh`. Затем откройте `http://127.0.0.1:31415`.
Как открыть сессию с телефона?
Запустите Tailscale на компьютере и телефоне, затем в Pi выполните `/remote`: появится QR-код и адрес HTTPS внутри вашей сети. На macOS сначала откройте Tailscale и выполните `/pi-web restart`.
Что делает команда /refresh?
Она возвращает в терминальную сессию Pi сообщения, которые написаны из удаленных браузеров, чтобы терминал и веб-интерфейс не расходились.
Как работает автозапуск?
Установка создает на macOS файл `launchd` `com.pi-web.plist`, на Linux пользовательскую службу `systemd` `pi-web.service`, на Windows запись в ключе Run реестра HKCU, которая запускает скрытый стартер.
Как называются сессии?
Автозаголовки включены по умолчанию и настраиваются на странице `/settings`. По умолчанию их создает встроенная эвристика без модели, а можно выбрать малую быструю модель для более осмысленных названий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныРасширение для агента Pi: строка состояния и боковая панель с моделью, контекстом, расходом, задачами и стоимостью субагентов
Самостоятельно размещаемый MCP-сервер и веб-приложение хранят проект графом задач, который делят люди и агенты.
Настольный питомец и монитор в строке меню: видно, какой из кодинг-агентов работает, закончил или ждет вашего ответа
Набор бытовых скиллов для агента: веб-поиск, автоматизация браузера, Gmail, Google Календарь и Диск, расшифровка речи и субтитры YouTube
MCP-сервер и приложение для Mac: один локальный индекс репозиториев, сессий агентов и задач, поиск по смыслу и нити работы
Плагин превращает документы и ссылки в локальную wiki с источниками, связанными страницами и поиском для AI-агента и Obsidian.
Коротко о README
README коротко описывает pi-web как веб-рабочее место для агента Pi, доступное с любого устройства, и предупреждает о бета-статусе. Показана схема работы: журналы сессий, сервер на Go, воркеры `rpc`, наблюдатель файлов и Tailscale. Затем идут установка одной командой, команды в Pi, автозапуск по системам, токен для удаленного доступа и сборка из исходников.