pi-env

English | Русский

Профили для агента pi: своя конфигурация под каждый проект и модель — создание и запуск из одного TUI.

Агент pi читает конфигурацию из каталога, заданного PI_CODING_AGENT_DIR: settings.json, extensions/, skills/, agents/, themes/, mcp.json. Разные модели, скиллы и MCP под разные задачи — это разные каталоги. pi-env делает их управляемыми: список окружений, создание формой, запуск по Enter, обновление расширений и MCP на месте — не покидая терминал.

Быстрый старт

Требования: Node.js ≥ 20 и установленный CLI pi (npm install -g @earendil-works/pi-coding-agent).

npm install -g @devmaksi/pi-env                  # либо одноразово: npx @devmaksi/pi-env
pi-env                                           # TUI, корень окружений — ~/.pi-env
pi-env myenv --mode json "Review this repository"  # запустить pi в окружении (аргументы — как есть)

Зачем, если есть PI_CODING_AGENT_DIR

• Переменную всё равно надо помнить, экспортировать и держать в голове путь — pi-env превращает это в список с именами и запуском по Enter.
• Новое окружение — это не mkdir: нужно скопировать инструменты, скиллы, пакеты, каталог моделей и auth.json. Форма создания делает это сама.
• Расширения и MCP живут в разных файлах у каждого окружения; pi-env показывает обновления и правит mcp.json за тебя.
• Запуск остаётся запуском pi: дочерний процесс получает PI_CODING_AGENT_DIR=<окружение>, аргументы пробрасываются как есть — годно для скриптов и --mode json.

Не путать с @earendil-works/pi-env

Это независимый проект, не связанный с earendil-works. Официальный @earendil-works/pi-env — про удалённое исполнение (ssh, remote, durable-агенты) и к управлению локальными конфигурациями отношения не имеет. Похожее имя, разный смысл.

Возможности

• список окружений (корневой каталог ~/.pi-env, переопределяется флагом --root <путь> или переменной PI_ENV_ROOT);
• вкладки: Окружения | Расширения | MCP | Настройки | О программе;
• создание окружения через форму: имя, модель, инструменты, расширения-пакеты, скиллы (каталог берётся из main-агента pi), MCP-серверы;
• запуск окружения: дочерний процесс pi с PI_CODING_AGENT_DIR=<путь окружения>, возврат в TUI по выходе;
• редактирование окружения: смена модели, инструментов, пакетов, скиллов, MCP, переименование, удаление с подтверждением;
• управление расширениями: просмотр обновлений (маркеры «↑ latest»), обновление одного/всех пакетов (pi update), удаление (pi remove);
• установка расширений из каталога https://pi.dev/packages: глобально (вкладка «Расширения») и в конкретное окружение (кнопка «Установить» в форме);
• MCP: вкладка со списком серверов, добавление формой (pi mcp add), удаление, живой статус подключения (pi mcp list --json);
• детализация окружения: инфо-панель выбранного (модель, инструменты, скиллы, расширения-пакеты, MCP);
• настройки приложения: «Цветной вывод», «Перепроверка обновлений» (npm outdated при каждом входе во вкладку «Расширения»); сохраняются в <root>/.pi-env.json и переживают перезапуск.

Управление (основные клавиши)

Установка

npm install -g @devmaksi/pi-env   # либо одноразово: npx @devmaksi/pi-env

Все способы установки (включая установку Node.js), удаление и примечания (TTY, Windows) — в docs/installation.md.

Документация

• Установка — Node.js, установка/удаление pi-env
• Разработка — стек, быстрый старт, структура проекта, конвенции
• CHANGELOG.md — история версий
• AGENTS.md — модель окружений, текущий статус, дорожная карта

Для агента pi

Пакет несёт скилл pi-env: если поставить его как pi-пакет (pi install npm:@devmaksi/pi-env), агент сможет сам создавать окружения, запускать их и объяснять, что лежит в settings.json. Ручная настройка — в SKILL.md.