pbir-cli

Create, format, validate, and publish Power BI reports through the pbir CLI.

6|3|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbir-cli-insightfulanalytics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pbir-cli
Source: https://github.com/InsightfulAnalytics/PBI_Agentic_Dev/tree/main/plugins/reports/skills/pbir-cli
Command: npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbir-cli-insightfulanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pbir-cli, and includes references (resource) components.

What problem does it solve? Editing Power BI report JSON by hand is error-prone and unsafe, and verifying that changes actually render correctly in Power BI Desktop is slow. This Skill gives an agent a safe, CLI-driven workflow for exploring, building, formatting, validating, and publishing Power BI reports without ever hand-editing report files. ## Core Features & Use Cases - Report exploration and mutation via CLI: Inspect reports, pages, and visuals with pbir ls, tree, get, and cat, then make changes with pbir set, add visual, and theme commands instead of editing JSON directly. - Theme-first formatting and validation: Discover valid properties with pbir schema describe, apply formatting at the theme level, and run pbir validate plus the Best Practice Analyzer to catch structural and design issues. - Desktop integration and visual verification: Refresh the open report in Power BI Desktop and capture page screenshots with pbir desktop refresh and pbir desktop screenshot to confirm changes render as intended. - Use Case: A user asks to rebrand a sales report. The agent audits the theme, updates colors and fonts at the theme level, clears bespoke visual overrides, validates the report, refreshes it in Desktop, and screenshots each page to verify the result. ## Quick Start Ask the agent to explore the open Power BI report with pbir, then add a revenue card visual to the first page and verify it with a Desktop screenshot.

Frequently Asked Questions about pbir-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit Power BI report files without breaking the JSON?▼

Use the pbir CLI instead of editing report JSON directly. Commands like pbir set, pbir add visual, and pbir theme set-formatting mutate reports safely, and mutating commands validate their own writes automatically.

How do I verify Power BI report changes render correctly?▼

When the report is open in Power BI Desktop on Windows, run pbir desktop refresh followed by pbir desktop screenshot and inspect the PNG. On macOS, publish to a sandbox Fabric workspace with pbir publish and inspect the rendered report in a browser.

Does pbir-cli work on Linux?▼

No. pbir-cli publishes only macOS arm64 and Windows x64 wheels, so pip and uv installs fail on Linux. The documented fallback is hand-authoring PBIR JSON, checking it with jq, and publishing via the Fabric CLI with fab import.

How do I find the correct property names before formatting a Power BI visual?▼

Run pbir schema describe with the visual type to list its objects, then describe a specific object to see property names, types, ranges, and enums. Never guess property names, since pbir set enforces the core visual catalog.

How do I install or upgrade the pbir CLI?▼

Install with uv tool install pbir-cli or pip install pbir-cli. To upgrade, first resolve the binary path with which pbir, then use uv tool upgrade pbir-cli for uv installs or pip install --upgrade pbir-cli for pip installs.

When should formatting go in the theme instead of on individual visuals?▼

Prefer theme-level formatting with pbir theme set-formatting whenever a change applies to all visuals of a type. Reserve per-visual commands like pbir visuals title or border for genuine one-off overrides, and check the theme cascade first with pbir visuals format.