Pi

Pi — минималистичный open-source агент для терминала (TUI) от Earendil. Вместо встроенных под-агентов и plan-режима — расширяемость: skills, расширения на TypeScript, свои промпт-шаблоны. Подключается к Mixen как к OpenAI-совместимому провайдеру через models.json.

Установка

curl -fsSL https://pi.dev/install.sh | sh

или через пакетный менеджер:

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

Конфигурация

Создайте ~/.pi/agent/models.json (Windows: %USERPROFILE%\.pi\agent\models.json) — это agent directory Pi, там же живут auth.json и settings.json:

{
  "providers": {
    "mixen": {
      "baseUrl": "https://api.mixen.ai/v1",
      "api": "openai-completions",
      "apiKey": "$MIXEN_API_KEY",
      "models": [
        { "id": "openai/gpt-6.1-sol" },
        { "id": "google/gemini-3.8-flash" },
        { "id": "z-ai/glm-5.3" }
      ]
    }
  }
}

Ключевые моменты:

• api: "openai-completions" — стиль wire-протокола; Mixen совместим с OpenAI Chat Completions.
• apiKey понимает интерполяцию окружения ($MIXEN_API_KEY, ${MIXEN_API_KEY}), литеральное значение или команду с ведущим !. Команды выполняются при каждом запросе и не кешируются.
• Список models — какие id из каталога показать в Pi; добавляйте свои.

Переменная окружения с ключом mxn-… из кабинета:

export MIXEN_API_KEY="mxn-ваш-ключ"   # добавить в ~/.bashrc или ~/.zshrc для постоянства

Запуск и выбор модели

pi

• /model — поиск и выбор модели; заодно перечитывает models.json после правок.
• Ctrl+S на модели — сделать её дефолтом для новых сессий.
• Ctrl+P — цикл по избранным моделям.
• pi -p "запрос" — print-режим одной командой, для скриптов.

Пока Pi не может прочитать ключ, модели из models.json не появятся в /model — проверьте, что переменная задана в текущей сессии терминала.

Поведение агента

• AGENTS.md в корне проекта — инструкции для конкретного репозитория.
• ~/.pi/agent/SYSTEM.md — полностью заменяет системный промпт, APPEND_SYSTEM.md — дополняет.
• Skills — свои CLI-инструменты с README в ~/.pi/agent/skills/; встроенного MCP нет, инструменты добавляются skills или расширениями.

Рекомендуемые модели

Модель	ID
GPT-6.1 Sol	openai/gpt-6.1-sol
Claude Sonnet 5.5	anthropic/claude-sonnet-5.5
GLM 5.3	z-ai/glm-5.3
DeepSeek V4 Pro	deepseek/deepseek-v4-pro
Kimi K3	moonshotai/kimi-k3

Актуальный список — в каталоге.

Типичные проблемы

• Модели Mixen не появились в /model — Pi не смог прочитать ключ: переменная MIXEN_API_KEY не задана в этой сессии; задайте и переоткройте /model.
• Правки models.json не подхватились — /model перечитывает файл, отдельной команды перезагрузки нет.
• 401 от API — ключ отозван или опечатка; проверьте его запросом curl https://api.mixen.ai/v1/models -H "Authorization: Bearer $MIXEN_API_KEY".