pi-fabric — плагин
Расширение для агента Pi: один программируемый инструмент fabric_exec вызывает инструменты, MCP, агентов и воркфлоу кодом
- 304 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Программы агента выполняются от имени сессии и вызывают инструменты Pi, включая запись файлов и команды
- Выбор CPython и режимы Node или Bun снимают песочницу и дают коду права ОС
- Рои агентов и рекурсия умножают расходы на модель, поэтому важны бюджеты и глубина
Установка
Ручная установка
pi install npm:pi-fabricНужны Node.js 24 или новее и Pi 1.0.0 или новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Программы агента выполняются от имени сессии и вызывают инструменты Pi, включая запись файлов и команды
- Выбор CPython и режимы Node или Bun снимают песочницу и дают коду права ОС
- Рои агентов и рекурсия умножают расходы на модель, поэтому важны бюджеты и глубина
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pi-fabric — расширение для кодингового агента Pi, которое заменяет набор отдельных инструментов одним программируемым инструментом fabric_exec. Модель пишет короткую программу, а в ней вызывает инструменты Pi, MCP-серверы, дочерних агентов и воркфлоу. Ветвления, циклы и параллельные вызовы описаны в коде, промежуточные результаты остаются в песочнице и в контекст модели не попадают. По умолчанию программа пишется на TypeScript и выполняется в изолированном QuickJS после статической проверки типов. В файле настроек вместо него можно выбрать песочницу Python (Monty). Агентов можно запускать разовыми работниками, держать постоянными или собирать в совет из нескольких ревьюеров. Общие задачи и состояние хранятся в сети mesh. Расходы ограничивают таймауты, глубина рекурсии и общий бюджет, а опасные шаги ждут утверждения. Готовые приемы лежат в скиллах: `fabric-workflow` для параллельных аудитов, `fabric-rlm` для задач больше контекста и `fabric-council` для ревью. В интерфейсе Pi появляются панель активности, команда `/fabric` с дашбордом и настройками и диалог с дочерним агентом.
Для кого. Для пользователей Pi, которые запускают большие многошаговые задачи: аудиты по десяткам файлов, миграции и ревью несколькими агентами.
Подходит, если
- Нужно проверить все файлы авторизации в репозитории параллельно и свести проверенные находки в один отчет
- Задача не помещается в окно контекста, и агент должен разбить ее рекурсивно, как в скилле `fabric-rlm`
- Дизайн нужно показать нескольким независимым ревьюерам и получить единое решение скиллом `fabric-council`
- Шаги миграции должны переживать перезапуск, а перед релизом нужно согласование человека, и для этого подойдет скилл `fabric-graph`
- Потребуется один инструмент вместо десятка: fabric_exec вызывает MCP-серверы и инструменты Pi из одной программы
Не подходит, если
- Вы работаете в Claude Code или Cursor: расширение написано только для агента Pi
- Задача простая и укладывается в пару обычных вызовов инструментов: слой программ и агентов будет лишним
- На машине нет Node.js 24 и Pi 1.0, а поставить их нельзя: это минимальные версии
Пример запроса к агенту
Проверь все файлы в src/auth параллельно на небезопасную работу с токенами и дай один отчет с проверенными находкамиОграничения
Нужны Node.js 24 или новее и Pi 1.0.0 или новее, в других агентах расширение не работает. Песочница Python (Monty) ограничена: произвольные импорты и сторонние пакеты недоступны. Полноценный CPython включается отдельной настройкой `executor.pythonRuntime` и работает с правами ОС, для него нужны `sandbox-exec` на macOS или `bwrap` на Linux.
Вместе с расширением идет провайдер Coral Bricks со входом через `/login coralbricks`. Сопровождающие проекта работают в этой компании, провайдера можно исключить фильтром пакета. Для отдельных MCP-серверов Pi использует mcporter, нативный MCP Pi подключается опцией `mcp.nativeServers`.
Как отключить. Удалите пакет из Pi командой удаления пакетов или уберите его из списка установленных. Файл настроек ~/.pi/agent/fabric.json можно удалить вручную, после перезапуска Pi вернется к обычным инструментам.
Частые вопросы
Как поставить pi-fabric?
Выполните `pi install npm:pi-fabric`. Ставить можно и прямо из репозитория: `pi install git:github.com/fabric-runtime/pi-fabric`. Для локальной проверки есть `pi -e /абсолютный/путь/к/pi-fabric`.
Что делает fabric_exec?
Это единственный инструмент, который расширение выставляет модели. Модель присылает программу, а Fabric выполняет ее в песочнице и вызывает по пути ядро Pi, MCP-серверы и агентов. Независимые вызовы идут параллельно, а в разговор возвращается только итоговый объект.
Как переключиться на Python вместо TypeScript?
Добавьте в `~/.pi/agent/fabric.json` или в `.pi/fabric.json` доверенного проекта настройку `{ "executor": { "kernel": "python" } }`. По умолчанию Python работает в песочнице Monty без доступа к файлам и сети.
Какие скиллы идут с pi-fabric и как их вызвать?
Например `fabric-guide`, `fabric-workflow`, `fabric-rlm`, `fabric-council`, `fabric-fusion`, `fabric-swarm` и `fabric-graph`. Их вызывают явно командой вида `/skill:fabric-workflow` с описанием задачи, и модель подгружает скилл после такого запроса.
Как следить за агентами и менять настройки?
Команда `/fabric` открывает панель активности и топологии, `/fabric settings` показывает настройки и сохраняет их в fabric.json, а `/fabric chat <агент>` или Ctrl+Shift+A открывает диалог с дочерним агентом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныОткрытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Система для кодовых агентов: 68 агентов, 292 скилла, хуки, память, правила и сканер безопасности AgentShield
DeepSeek Harness — открытый ИИ-агент от DeepSeek, в котором все функции устроены как плагины. Работает в браузере, на macOS и Windows.
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Ollama запускает открытые нейросети на вашем компьютере и отдает их агентам через локальный API, совместимый с OpenAI и Anthropic.
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| pi-fabric (эта запись) | нет | 304 | |
| pi-subagents | нет | 1 353 | субагенты и оркестрация в стиле Claude Code для Pi; Fabric добавляет код-режим с одним инструментом, воркфлоу, mesh и бюджеты |
| pi-extensions | нет | 731 | набор отдельных расширений для Pi: цели, режим плана, LSP; Fabric строится вокруг одного программируемого инструмента |
Коротко о README
README подает проект как программируемый рантайм инструментов и агентов для Pi и объясняет разницу между ядрами TypeScript и Python. Дальше идут установка, таблица скиллов с примерами запросов и ссылки на документацию.