Самостоятельно размещаемое веб-приложение для телефонов и браузеров, позволяющее запускать Pi coding agents, сохраняя сессии после перезапуска сервера.
Xpropel/Pi-Remote
Удалённое управление терминальным coding-агентом pi: трансляция активных сессий в браузер или на телефон и отправка сообщений и команд через собственный relay.
- Звёзды
- 307
- Форки
- 10
- Открытые issues
- 0
- Последний коммит
- позавчера
Что это?
Pi-Remote подключается к работающей сессии pi в терминале через официальный API расширений pi, не меняя исходный код pi и не перехватывая управление терминалом. Сессия продолжает работать в локальном процессе pi, а браузер отображает её в реальном времени. Из браузера можно отправлять сообщения, переключать модели и уровни thinking, сжимать контекст, создавать или разветвлять сессии и перемещаться по дереву сессий.
Система состоит из трёх частей: расширения синхронизации, работающего внутри pi, relay-сервиса на Node для аутентификации и пересылки данных и веб-интерфейса, который обслуживает relay. К одному relay могут подключаться несколько машин, причём каждое устройство доступно только пока открыто его окно подключения. В serverless-режиме relay работает на вашем компьютере, а телефоны подключаются через ту же сеть Wi-Fi или временный Cloudflare Tunnel.
Проект рассчитан на личное использование одним пользователем. Удалённый bash по умолчанию отключён, а расширение и интерфейс просмотра используют разные токены. Содержимое переписки не сохраняется, если отдельно не включить сохранение.
Ключевые возможности
- 01Отображение в браузере в реальном времени вывода pi в терминале, вызовов инструментов и статуса
- 02Удалённая отправка сообщений с постановкой в очередь или перенаправлением, пока pi занят
- 03Удалённое переключение моделей и уровней thinking, ручное сжатие контекста и навигация по дереву сессий
- 04Подключение устройств по QR-коду и поддержка нескольких подключённых машин
- 05Serverless-режим для локальной сети с опциональным Cloudflare Tunnel по запросу
- 06Отдельные макеты для компьютеров и мобильных устройств, а также несколько визуальных тем
Сценарии использования
- Проверять с телефона ход длительной задачи coding-агента
- Отвечать на запросы pi, находясь вдали от рабочего места
- Управлять сессиями pi на нескольких машинах из одной панели в браузере
Быстрый старт
- 1
Установите терминального агента для программирования pi (требуется Node 22.18 или новее).
npm install -g @earendil-works/pi-coding-agent - 2
Установите зависимости Pi-Remote в папку проекта.
npm install - 3
Запустите relay на своём компьютере (веб-интерфейс доступен на порту 7002).
npm run relay
Что важно знать
- Агент для программирования pi нужно установить отдельно; он не входит в Pi-Remote.
- Для работы с нескольких устройств через relay нужен сервер, которым вы управляете, за исключением режима локального цикла.
- Приложение рассчитано на личное использование одним пользователем и не предусматривает систему разрешений для нескольких пользователей.
- Любой, у кого есть viewer token, может отправлять сообщения и команды в pi, поэтому token нужно защищать.
В подборках
Темы
Частые вопросы
- Что такое Pi-Remote?
- Удалённое управление терминальным coding-агентом pi: трансляция активных сессий в браузер или на телефон и отправка сообщений и команд через собственный relay. Pi-Remote подключается к работающей сессии pi в терминале через официальный API расширений pi, не меняя исходный код pi и не перехватывая управление терминалом. Сессия продолжает работать в локальном процессе pi, а браузер отображает её в реальном времени. Из браузера можно отправлять сообщения, переключать модели и уровни thinking, сжимать контекст, создавать или разветвлять сессии и перемещаться по дереву сессий.
- Pi-Remote можно использовать бесплатно? Какая у него лицензия?
- Pi-Remote распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- Pi-Remote всё ещё поддерживается?
- Активно поддерживается. Последний коммит в Pi-Remote — 5 нояб. 2026 г..
- Для чего можно использовать Pi-Remote?
- Проверять с телефона ход длительной задачи coding-агента Отвечать на запросы pi, находясь вдали от рабочего места Управлять сессиями pi на нескольких машинах из одной панели в браузере
- Как установить Pi-Remote?
- Установите терминального агента для программирования pi (требуется Node 22.18 или новее).: npm install -g @earendil-works/pi-coding-agent Установите зависимости Pi-Remote в папку проекта.: npm install Запустите relay на своём компьютере (веб-интерфейс доступен на порту 7002).: npm run relay
- Где скачать Pi-Remote?
- Исходный код и инструкции по установке — на GitHub: https://github.com/Xpropel/Pi-Remote
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Эмулятор терминала в браузере: работает по HTTP/HTTPS и построен на xterm.js и WebSockets.
Лёгкий терминальный помощник для программирования с циклом работы с инструментами и TUI в духе Claude Code — компактная кодовая база для обучения и экспериментов.
Десктопное приложение для macOS, Windows и Linux, которое упаковывает AI-агента для программирования Pi в устанавливаемую программу со встроенным окном чата.
Пошаговое руководство по созданию с нуля минимального coding agent на TypeScript, который читает файлы, редактирует код и запускает команды.
Неофициальное руководство на китайском языке по Pi Coding Agent — от установки до Skills, Extensions, Subagents и длительных рабочих процессов.