Pi Coding Agent

Pi Coding Agent – терминальный кодинг-агент с открытым исходным кодом (лицензия MIT). В отличие от многих аналогичных решений, Pi позиционируется не как готовая экосистема с фиксированным набором функций, а как минимальное ядро, которое расширяется через TypeScript-расширения, Skills, Prompt Templates, Themes и Pi Packages. Такой подход позволяет адаптировать агент под существующий рабочий процесс вместо использования заранее определённой архитектуры.

Официальная документация отдельно подчёркивает, что ряд возможностей, присутствующих в других AI-агентах (например, встроенный plan mode, sub-agents или MCP), намеренно отсутствует в базовой поставке и предлагается реализовывать через расширения или сторонние пакеты. Это архитектурное решение является одной из ключевых особенностей проекта.

Установка

Pi распространяется как npm-пакет.

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

После установки агент запускается внутри каталога проекта:

pi

Для Linux и macOS также доступен официальный установочный скрипт.

Аутентификация выполняется одним из двух способов:

  • команда /login для провайдеров с OAuth или подпиской;
  • через API-ключи в переменных окружения (например, ANTHROPIC_API_KEY) либо в файле конфигурации.

Базовые команды

Документация описывает несколько основных режимов запуска:

pi

Интерактивный терминальный интерфейс.

pi -p "Запрос"

Print Mode для автоматизации и использования в shell-скриптах.

pi --mode json

Вывод событий в формате JSON.

pi --mode rpc

RPC-режим для интеграции с внешними приложениями.

Во время работы доступны встроенные команды, включая:

  • /login
  • /model
  • /tree
  • /export
  • /share
  • /settings
  • /reload

Расширения (skills, слеш-команды)

Одним из основных механизмов расширения являются Skills.

Skill представляет собой набор инструкций и сопутствующих файлов, которые автоматически подключаются агентом для выполнения определённого типа задач. Skills могут содержать документацию, инструкции по работе с CLI-инструментами, шаблоны взаимодействия и другие элементы контекста.

Дополнительно Pi поддерживает:

  • Prompt Templates;
  • пользовательские команды;
  • расширения на TypeScript;
  • Pi Packages, распространяемые через npm или Git.

Таким образом, многие дополнительные возможности реализуются именно как устанавливаемые расширения, а не встроенные функции.

Режим планирования

В базовой версии Pi встроенного режима планирования нет.

Это прямо указано в официальной документации. Вместо встроенного plan mode предлагается:

  • вести планы в отдельных Markdown-файлах;
  • создавать собственные расширения;
  • использовать сторонние Pi Packages;
  • поручить самому агенту создать необходимый workflow.

Таким образом, наличие полноценного режима планирования зависит от установленной конфигурации пользователя, а не от стандартной поставки.

Выполнение и проверка плана

После утверждения плана агент может выполнять изменения, используя встроенные инструменты:

  • чтение файлов;
  • редактирование файлов;
  • создание новых файлов;
  • запуск команд терминала (если соответствующий инструмент включён).

Для проверки результатов Pi может запускать тесты, линтеры и другие инструменты проекта. Конкретные процедуры проверки определяются самим проектом и доступными инструментами, а не встроенной логикой Pi.

Контроль выполнения плана

Pi предоставляет несколько механизмов контроля выполнения работы:

  • дерево сессий (/tree), позволяющее возвращаться к любой точке истории;
  • экспорт истории (/export);
  • публикация истории (/share);
  • возможность отправлять дополнительные инструкции во время выполнения задачи;
  • автоматическое сжатие контекста (Context Compaction) при приближении к лимиту окна модели.

Сессии сохраняются в виде дерева, что позволяет продолжать работу с любой предыдущей ветви без создания отдельных файлов истории.

Подключение провайдеров моделей по API

Pi поддерживает работу как через OAuth, так и через API-ключи.

Согласно официальной документации, поддерживаются более пятнадцати провайдеров моделей, включая:

  • Anthropic;
  • OpenAI;
  • Google;
  • Azure OpenAI;
  • Amazon Bedrock;
  • Groq;
  • Mistral;
  • xAI;
  • Hugging Face;
  • NVIDIA;
  • OpenRouter;
  • Ollama;
  • Cerebras;
  • MiniMax;
  • Kimi For Coding.

Также возможно подключение собственных провайдеров и моделей через конфигурацию или расширения.

Во время одной сессии допускается переключение модели командой /model.

Особенности Pi

Ключевые особенности Pi отличаются от большинства терминальных AI coding agents:

  • минимальное ядро без жёстко заданного рабочего процесса;
  • расширяемость через TypeScript Extensions;
  • поддержка Skills, Prompt Templates и Themes;
  • установка дополнительных возможностей через Pi Packages;
  • дерево сессий вместо линейной истории;
  • четыре режима работы (Interactive, Print, JSON, RPC);
  • SDK для встраивания агента в собственные приложения;
  • возможность изменять поведение самого агента без изменения исходного кода проекта;
  • поддержка пользовательских системных инструкций через AGENTS.md и SYSTEM.md;
  • настраиваемое управление контекстом и механизмами его сокращения.

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

Основные сценарии использования:

  • разработка программного обеспечения из терминала;
  • сопровождение существующих репозиториев;
  • написание и рефакторинг кода;
  • создание собственных AI-workflow;
  • интеграция AI-агента в внутренние инструменты компании через SDK или RPC;
  • использование локальных и облачных LLM;
  • автоматизация повторяющихся задач разработки;
  • исследование и экспериментирование с пользовательскими расширениями и инструментами.

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

Веб-сайт: https://pi.dev