Я давно искал минималистичный инструмент, который бы не навязывал мне свой workflow, а подстраивался под мой. Недавно наткнулся на Pi Coding Agent — и это именно то, что нужно, когда хочется гибкого AI-агента без лишних ограничений. Расскажу, как его установить и настроить под свои задачи.
Что такое Pi и зачем он дизайнеру и креатору
Pi — это минималистичный агентский фреймворк. В отличие от тяжеловесных AI-инструментов вроде Cursor или закрытых сервисов, Pi можно буквально собрать под себя: добавить расширения, навыки, шаблоны промптов и темы. Главное — он не запечатан как продукт. Если мне нужна какая-то команда, интеграция или UI-настройка, я прошу Pi сделать это прямо внутри сессии.
Для креаторов, работающих с нейросетями, это особенно интересно: можно автоматизировать рутину — генерацию промптов для Midjourney или Flux, сборку пайплайнов для обработки изображений, скрипты для работы с API Suno или Meshy.
Установка Pi: пошаговый гайд
Шаг 1. Выбери способ установки
Pi поддерживает несколько вариантов установки. Я предпочитаю через curl — быстро и без лишних шагов.
macOS / Linux:
curl -fsSL https://pi.dev/install.sh | shWindows (PowerShell):
powershell -c "irm https://pi.dev/install.ps1 | iex"Через пакетные менеджеры Node.js:
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# или
pnpm add -g --ignore-scripts @earendil-works/pi-coding-agent
# или
bun add -g --ignore-scripts @earendil-works/pi-coding-agentШаг 2. Подключи AI-провайдера
Pi поддерживает огромный список провайдеров: Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, Cerebras, xAI, Hugging Face, Kimi, MiniMax, OpenRouter, Ollama и другие. Аутентификация — через API-ключи или OAuth. Кастомные провайдеры и модели добавляются через файл models.json или расширения.
Прямо в середине сессии можно переключить модель командой /model или горячей клавишей Ctrl+L. Переключаться между избранными моделями — Ctrl+P. Это удобно, когда тестируешь разные модели для генерации промптов или кода.
Шаг 3. Настрой контекст и инструкции проекта
Pi поддерживает умную систему контекстной инженерии. Вот что можно сделать:
- AGENTS.md — инструкции проекта, загружаются при старте из
~/.pi/agent/, родительских директорий и текущей папки. - SYSTEM.md — замена или дополнение к системному промпту для конкретного проекта.
- Компакция контекста — Pi автоматически суммирует старые сообщения при приближении к лимиту контекста. Можно настроить через расширения: тематическая компакция, code-aware суммаризация, разные модели для суммаризации.
Шаг 4. Используй навыки и шаблоны промптов
Навыки (Skills) — это пакеты инструкций и инструментов, которые загружаются по требованию. Это позволяет не забивать системный промпт всем и сразу. Шаблоны промптов — Markdown-файлы, которые вызываются командой /название прямо в чате. Очень удобно для повторяющихся задач: например, я сделал шаблон для генерации промптов под Flux с нужными стилями.
Шаг 5. Работа с сессиями и ветками
Сессии в Pi хранятся в виде деревьев. Командой /tree можно вернуться к любой точке разговора и продолжить с неё — как git-ветки, но для диалогов. Все ветки живут в одном файле. Можно фильтровать по типу сообщений и ставить закладки.
Экспорт сессии в HTML — команда /export. Поделиться ссылкой — /share, Pi загружает сессию в GitHub Gist и возвращает URL с красивым рендерингом.
Режимы работы Pi
- Interactive — полноценный TUI-интерфейс в терминале.
- Print/JSON —
pi -p "запрос"для скриптов,--mode jsonдля событийного вывода. - RPC — для интеграции с другими инструментами.
- SDK — встройка Pi в собственные приложения.
Фишки, которые меня зацепили
Пока агент работает, можно отправлять новые сообщения. Enter — отправить управляющее сообщение прямо в процессе (прерывает текущий инструмент). Alt+Enter — дождаться завершения и добавить следующий запрос. Pi может редактировать себя в процессе работы: попросишь добавить новую команду или изменить поведение — сделает, затем /reload — и продолжает работу с обновлёнными настройками.
Мой вывод
Pi — редкий случай, когда инструмент действительно не мешает, а помогает. Для тех, кто автоматизирует работу с AI-генерацией — от промптов для Midjourney до скриптов обработки медиа — это гибкая база, которую можно собрать под себя буквально за вечер. Минимализм здесь — не ограничение, а философия.