Pi CLI
Минималистичный агент для кода в терминале, который расширяется скиллами, шаблонами промптов и пакетами на TypeScript
- 118 586 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Выполняет произвольные команды bash без встроенных ограничений
- Имеет доступ ко всем файлам и учетным данным пользователя
Установка
Ручная установка
npm install -g --ignore-scripts @earendil-works/pi-coding-agentПосле установки запустите pi и выполните /login или задайте ключ провайдера.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Выполняет произвольные команды bash без встроенных ограничений
- Имеет доступ ко всем файлам и учетным данным пользователя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Pi запускается в каталоге проекта командой pi и открывает диалог, в котором модель получает четыре инструмента: читать файлы, создавать их, править и выполнять команды bash. Подключение к модели делается внутри сессии командой /login: она принимает подписку Claude, ChatGPT, Copilot или ключ провайдера. Остальное подключается расширениями на TypeScript из папки .pi/extensions проекта, шаблоны промптов в .pi/prompts, скиллы в .pi/skills. Готовый набор можно упаковать в Pi-пакет и раздать через npm или git. Помимо диалога есть режим печати и JSON для скриптов, RPC для управления из другой программы и TypeScript SDK для встраивания.
Для кого. Для разработчиков, которые хотят небольшой агент и готовы настраивать его под свой процесс.
Подходит, если
- Вы запускаете агента в разных проектах и хотите держать его правила в папке .pi рядом с кодом
- У вас есть подписка Claude Pro или ChatGPT Plus, и нужен один терминальный агент вместо двух разных программ
- Нужно вызывать агента из скрипта в CI: режим печати или JSON отдает ответ без интерактивного окна
- Вы пишете собственное приложение с агентом и берете готовый цикл вызова инструментов из пакета pi-agent-core
- Вам нужен единый слой над разными провайдерами моделей, чтобы переключать их без переписывания кода (пакет pi-ai)
Не подходит, если
- Нужна встроенная система разрешений, которая спрашивает перед записью файла: возьмите Claude Code или Codex CLI, там такие подтверждения есть из коробки
- Вам нужны подагенты и режим планирования сразу после установки: у Pi их нет, придется ставить пакет или писать расширение
- Вы не хотите тратить время на настройку и ищете готовый агент с лентой плагинов: посмотрите OpenCode или Crush из раздела CLI
Пример запроса к агенту
Напиши расширение для Pi в .pi/extensions, которое перед каждой командой bash из репозитория api-gateway показывает ее текст и ждет моего ответа y или nОграничения
Доступ: широкий. Встроенной системы разрешений нет, агент читает и пишет любые файлы, запускает любые команды и ходит в сеть с правами пользователя, который его запустил. Для границ авторы описывают три способа: расширение Gondolin (инструменты уходят в локальную микро-ВМ), обычный Docker и песочница OpenShell. Требуется Node.js 22.19 или новее; установщики для macOS, Linux и Windows умеют поставить его сами, есть и запуск через Nix. Платных частей у самого агента нет, расходы идут по подписке или API-ключу выбранной модели. Новые issues и pull requests от новых участников закрываются автоматически, ответ приходит после ручной проверки.
Как отключить. Удалите глобальный пакет командой npm uninstall -g @earendil-works/pi-coding-agent.
Частые вопросы
Какие модели поддерживаются?
Подписки Claude Pro и Max, ChatGPT Plus и Pro, GitHub Copilot, а также API-ключи Anthropic, OpenAI, Google, DeepSeek, Mistral, Groq и других провайдеров.
Как ограничить доступ агента?
Запустите его в Docker или песочнице, варианты описаны в документации по контейнеризации в репозитории. Расширение Gondolin оставляет сам pi и вход в провайдера на хосте, а инструменты отправляет в микро-ВМ.
Как установить и запустить Pi?
Выполните npm install -g --ignore-scripts @earendil-works/pi-coding-agent или установщик с pi.dev, затем перейдите в папку проекта и введите pi. Внутри сессии команда /login подключит подписку или ключ.
Как обновить и проверить, что все работает?
Команда pi update обновляет программу. Чтобы проверить связку с моделью, дайте простую задачу, например прочитать README, и посмотрите, что агент вызвал инструмент чтения файла.
Чем Pi отличается от Claude Code?
Claude Code поставляется с подагентами, режимом планирования и системой разрешений. Pi оставляет только четыре инструмента и предлагает достроить остальное расширениями, зато работает с несколькими провайдерами сразу.
Почему мой issue или pull request закрыли сами?
Так настроен репозиторий: обращения от новых участников закрываются автоматически, а мейнтейнеры разбирают их ежедневно. Подробности в файле CONTRIBUTING.md.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыВеб-приложение для кодингового агента Pi: сессии переживают перезапуск, к ним можно подключать коллег и работать с телефона, без облачной виртуалки
Расширение для агента Pi (pi.dev): субагенты и оркестрация в стиле Claude Code, виджет и сценарии на JavaScript. Не для Claude Code
Веб-панель для кодинг-агента pi с группировкой сессий по веткам, встроенным терминалом и мобильным режимом
Расширение для агента Pi: один программируемый инструмент fabric_exec вызывает инструменты, MCP, агентов и воркфлоу кодом
Кодовый агент для терминала на Go: один бинарник без Node и Python, ревью диффа прямо в интерфейсе и подагенты
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Pi (эта запись) | нет | 118 586 | |
| CoreCoder | нет | 1 881 | учебный терминальный агент для кода на Python |
| Metis — агент для кода в терминале и на десктопе | нет | 431 | открытый агент для программирования |
Коротко о README
Корневой README описывает монорепозиторий: агент для кода, рантайм агента, единый API к провайдерам моделей, терминальный интерфейс и вспомогательные пакеты. Отдельно сказано, что прав и ограничений у агента нет, и перечислены три способа изоляции. Много внимания уделено защите цепочки зависимостей npm. README пакета агента показывает установку через npm или скрипт и список провайдеров. Лицензия MIT.