← Все проекты
Проект / TypeScript

FredySandoval/pi-browser-template: pi-browser-template — Шаблон для управления Chrome-расширениями через Pi

Свяжите Pi-агента с браузером за минуты — готовый конвейер с полной типовой безопасностью.

FredySandoval/pi-browser-template — open-source проект на TypeScript, который стоит оценить перед внедрением или доработкой.

★ 20 TypeScript Форки 0 Issue 0 Оценка 6/10 Карточка проверена

Для кого это

Для разработчиков, создающих браузерные интерфейсы для AI-агентов на базе Pi. Подойдёт тем, кто пишет на TypeScript и хочет быстро прототипировать сценарии «команда → браузер».

Проблема / задача

Сложно настраивать взаимодействие между Pi-кодинг-агентом и браузером: нужно вручную писать native messaging host, обрабатывать протокол, синхронизировать типы и отлаживать связку. Без готового шаблона это отнимает много времени и приводит к ошибкам.

Как это работает

Шаблон предоставляет готовый конвейер: команда или инструмент Pi отправляется через локальный сокет в native-хост, который через API Chrome Native Messaging передаёт сообщение в фоновый сервис-воркер расширения, а тот — в активный скрипт содержимого вкладки. Все сообщения строго типизированы с помощью TypeBox, изменения протокола вносятся в одном месте (packages/shared/src/messages.ts). В комплекте идут тесты и...

Что видно по README

pi-browser-template — это минималистичный, но готовый к использованию шаблон репозитория для проектов, где Pi должен управлять браузером. Он включает Pi-расширение с командой и инструментом, Chrome-расширение с popup и content script, native-хост для передачи сообщений, а также скрипты сборки и установки. Всё построено на TypeScript и полной типизации от Pi до браузера. Разработчик может сразу начать добавлять свою...

Ключевые возможности

Сквозная типовая безопасность: Pi → хост → расширение — все сообщения проверяются через TypeBoxГотовые компоненты: Pi-расширение (команда + инструмент), Chrome-расширение (popup, background, content script), native-хостЕдиное место для протокола: добавление нового сообщения начинается с packages/shared/src/messages.tsВстроенные тесты и диагностика подключения (pnpm diagnose:native)Простая установка через pnpm и bash-скрипт инсталлера native-хоста

Технологии

TypeScriptTypeBoxpnpmChrome Extension API (Native Messaging)Node.js

Интересный факт

Для аутентификации соединения между Pi и хостом используется временный токен, записываемый в /tmp/*.token — простой, но надёжный способ без сложных схем.

С чего начать

  • Клонируйте репозиторий и выполните pnpm install
  • Соберите проект: pnpm build
  • Загрузите расширение в Chrome: откройте chrome://extensions, включите режим разработчика, выберите папку dist/chrome-extension
  • Установите native-хост: скопируйте ID расширения и запустите bash apps/native-host/install/install.sh <ID>
  • Установите пакет в Pi: pi install ./pi-browser-template и проверьте соединение через popup расширения

Оценка GitRadar

Удобство
6/10
Свежесть
8/10
Перспектива
7/10
Монетизация
3/10
Общая оценка
6/10

Вердикт GitRadar

Стоит попробовать, если вы разрабатываете браузерные интерфейсы для AI-агентов на Pi. Проект решает рутинную задачу интеграции, но требует базового понимания расширений и native messaging. Отлично подходит для прототипирования и небольших продуктов.

Наблюдения по обновлениям

Проект свежий (версия 0.1.0), но пока мало звёзд и нет вкладов сообщества. Основа стабильна, но экоcистема только формируется.

Что мы проверили

Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.

Исходный репозиторий
https://github.com/FredySandoval/pi-browser-template
Лицензия
MIT
Создан на GitHub
26 апреля 2026 г.
Последнее обновление репо
26 апреля 2026 г.
Последняя проверка GitRadar
26 апреля 2026 г.
Изученные файлы
README.md, package.json, apps/pi/src/index.ts, apps/extension/src/config.ts, apps/extension/src/browser-utils.ts, packages/shared/src/validation.ts

FAQ

Что это такое?

Это шаблон репозитория для создания Chrome-расширений, которыми можно управлять через Pi-кодинг-агент. Включает всю инфраструктуру: Pi-команду, native-хост, расширение и тесты.

Для кого подходит?

Для TypeScript-разработчиков, которые хотят быстро соединить Pi с браузером. Нужно уметь работать с Chrome Extensions и немного с native messaging.

Источники

  • GitHub исходный код и активность
  • README описание, ссылки, стартовые материалы

Нужна помощь с FredySandoval/pi-browser-template?

Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.