Repolode
Xpropel

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. 1

    Установите терминального агента для программирования pi (требуется Node 22.18 или новее).

    npm install -g @earendil-works/pi-coding-agent
  2. 2

    Установите зависимости Pi-Remote в папку проекта.

    npm install
  3. 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 обновляется ежедневно.

Похожие проекты

Десктопное приложение для macOS, Windows и Linux, которое упаковывает AI-агента для программирования Pi в устанавливаемую программу со встроенным окном чата.

902+31 за неделю105TypeScriptMITАктивно поддерживаетсяОбновлён вчера