PBIR Tools CLI
CLI pbir правит отчеты Power BI в формате PBIR из терминала: визуалы, форматирование, проверка и публикация в Fabric для агентов
- 334 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Команды пишут и удаляют файлы отчета, а флаг `-f` включает массовые необратимые правки
- `pbir publish` отправляет отчет в рабочую область Microsoft Fabric и меняет то, что видят коллеги
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/pbir-toolsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команды пишут и удаляют файлы отчета, а флаг `-f` включает массовые необратимые правки
- `pbir publish` отправляет отчет в рабочую область Microsoft Fabric и меняет то, что видят коллеги
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PBIR Tools ставит в терминал команду `pbir` для отчетов Power BI в формате PBIR, то есть в виде папок с файлами. Команды просматривают структуру (`pbir ls`, `pbir tree`, `pbir model`), добавляют визуалы (`pbir add visual card`), массово меняют форматирование (`pbir set ... --value 14 -f`), проверяют отчет (`pbir validate`) и публикуют его в Microsoft Fabric (`pbir publish`). Путь внутри отчета записывают как `Report.Report/Page.Page/Visual.Visual`. Агент, например Claude Code, Codex или GitHub Copilot, вызывает те же команды вместо ручной правки JSON. Для него авторы выпустили отдельный набор скиллов, плагинов и хуков в маркетплейсе power-bi-agentic-development: он учит работе с отчетами, семантическими моделями, темами, DAX и Fabric. Перед крупными правками `pbir backup` сохраняет копию отчета. Проект в бете: разработчик советует копировать папку вручную и запускать `pbir validate` после каждого изменения. Установщики для macOS и Windows лежат на странице релизов.
Для кого. Аналитикам и BI-разработчикам, которые ведут отчеты Power BI в формате PBIR и отдают агенту рутину: форматирование десятков визуалов, проверку, публикацию.
Подходит, если
- За один проход надо выставить размер шрифта заголовков у всех визуалов отчета
- Агент добавляет карточку на страницу отчета, привязывает поля и проверяет результат командой `pbir validate`
- Отчет лежит в Git, и правки удобнее вести скриптом, чем мышью в Power BI Desktop
- Готовый отчет публикуется в рабочую область Fabric из терминала
Не подходит, если
- Отчет хранится в формате PBIX без конвертации в PBIR: CLI работает с папками PBIR
- Нужна коммерческая лицензия: проект распространяется на нестандартных условиях только для некоммерческого использования
- Правки массовые, а резервной копии нет: проект в бете
- Задача про семантическую модель и DAX: для нее авторы советуют скиллы из маркетплейса
Пример запроса к агенту
Через pbir сделай `backup` отчета Sales.Report, выставь размер шрифта заголовков 14 у всех визуалов и прогони `validate`Ограничения
- Проект в бете: массовое форматирование, конвертация, слияние и публикация могут испортить отчет, поэтому копию папки делают заранее.
- Лицензия нестандартная, коммерческое использование не разрешено.
- В репозитории лежит документация, исходный код CLI там не опубликован; программа ставится из PyPI или установщиком.
- Установщик для macOS и Windows может быть не подписан, система при запуске спросит подтверждение.
Как отключить. `uv tool uninstall pbir-cli` или `pip uninstall pbir-cli`. Плагины маркетплейса убирают через `/plugin` в агенте. Нативные установщики удаляются средствами системы.
Частые вопросы
Как установить pbir?
Командой `uv tool install pbir-cli` или `pip install pbir-cli`, затем `pbir --version` в новом терминале. Для macOS и Windows есть установщики на странице релизов.
Какие агенты работают с pbir?
Claude Code, Codex и GitHub Copilot вызывают CLI сами. Скиллы ставят из маркетплейса: `claude plugin marketplace add data-goblin/power-bi-agentic-development` для Claude Code и `copilot plugin install data-goblin/power-bi-agentic-development` для Copilot CLI.
Безопасно ли разрешать агенту pbir `publish`?
Публикация и массовые правки меняют отчет, поэтому разработчик относит `pbir publish`, `convert`, `merge` и `split` к самым осторожным операциям. Пусть агент делает `pbir backup` перед правкой, а `pbir publish` разрешайте отдельно.
Что проверяет pbir `validate`?
Команда выполняет проверку состояния отчета. README называет ее обязательным шагом после каждого изменения.
Как отредактировать много визуалов сразу?
Командой `pbir set` с маской пути и значением: `pbir set "Sales.Report/**/*.Visual.title.fontSize" --value 14 -f` меняет размер шрифта заголовков у всех визуалов отчета. Флаг `-f` включает массовые необратимые правки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и 13 скиллов для Claude Code: модель данных Power BI, меры DAX, безопасность на уровне строк и страницы отчета PBIR прямо из чата
Marketplace плагинов для Claude Code и GitHub Copilot по Power BI и Microsoft Fabric: семантические модели, DAX, TMDL, отчеты
Power BI Skills (Xperiun)
Power BI Skills
Три бесплатных скилла для Power BI: аудит модели с оценкой 0–100, документация в HTML и создание мер DAX по описанию.
Локальный MCP-сервер Microsoft для семантических моделей Power BI: агент создает таблицы, меры DAX и связи в Power BI Desktop, Fabric и файлах PBIP
Плагин Microsoft для Fabric: хранилища и Lakehouse, Spark, Power BI, Eventhouse, потоки событий и миграции для Copilot CLI и Claude Code
Поиск и сбор страниц входят в один сценарий агента, а пользователь видит образцы данных до применения исправлений парсера.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| PBIR Tools (эта карточка) | нет | 334 | ||
| pbi-cli | нет | 487 | CLI и 13 скиллов для модели данных, DAX и страниц отчета из чата Claude Code, pbir работает с папками отчетов PBIR | |
| Power BI Authoring MCP Server | да | OAuth | 1 265 | MCP-сервер Microsoft для семантических моделей, а pbir правит файлы отчетов |
Коротко о README
README начинается с предупреждения о бете и ссылки на маркетплейс скиллов. Затем идут установка, быстрый старт из семи команд, раздел об агентах, таблица документации, правила безопасности и отказ от ответственности.