pbir.tools

PBIR Tools

CLI tools for Power BI report automation; built for humans, optimized for agents

Browse, edit, validate, and publish PBIR reports from the terminal, or let Claude Code, Codex, or Copilot drive the CLI.

---

Install

PyPI (recommended)

uv tool install pbir-cli

Or with pip: pip install pbir-cli

Native installers (macOS / Windows)

Download the latest macOS or Windows installer from GitHub Releases.

macOS

1. Download the installer from Releases and try to open it once.
2. If macOS blocks it because the installer is unsigned or not notarized, open: System Settings => Privacy & Security
3. Scroll down to the Security section. You should see a message about the blocked installer there.
4. Click Open Anyway.
5. When macOS asks again, click Open and finish the installation.

Windows

1. Download the installer from Releases and run it.
2. If Windows Defender SmartScreen shows Windows protected your PC, click More info.
3. Confirm the installer name, then click Run anyway.
4. Finish the installation.

After installation, open a new terminal and verify:

pbir --version

Quick Start

pbir ls                                                                # List reports
pbir tree "Sales.Report" -v                                            # Full structure with fields
pbir model "Sales.Report" -d                                           # Model schema
pbir add visual card "Sales.Report/Overview.Page" --title "Revenue"    # Add a visual
pbir set "Sales.Report/**/*.Visual.title.fontSize" --value 14 -f      # Bulk formatting
pbir validate "Sales.Report"                                           # Health check
pbir publish "Workspace.Workspace/Sales.Report"                        # Deploy to Fabric

pbir works with PBIR-format reports stored as folders, using paths like:

Report.Report/Page.Page/Visual.Visual

Agents & Plugins

pbir is built for humans but optimized for agents. Install the Power BI plugins from the power-bi-agentic-development marketplace to give your agent skills for reports, semantic models, themes, DAX, and Fabric.

Follow the instructions at power-bi-agentic-development to install the full marketplace plugin with all skills, agents, and hooks. After installing, run /plugin in your agent to enable auto-update and install plugins.

Claude Code:

claude plugin marketplace add data-goblin/power-bi-agentic-development

GitHub Copilot CLI:

copilot plugin install data-goblin/power-bi-agentic-development

After installing, your agent can create reports, format visuals, bind fields, manage themes, filters, bookmarks, and publish to Fabric – all driven by pbir commands.

Documentation

Area	What it covers
Getting Started	Install, terminal basics, first 5 minutes
CLI Docs	Command groups and task-based CLI reference
CLI Workflows	End-to-end report workflows

Safety

• We recommend you take a manual backup (copy + paste) of your report folder before using pbir for the first time.
• Run pbir backup "Report.Report" before larger edits.
• Run pbir validate "Report.Report" after every mutation.
• Use -f only when you intend bulk or destructive operations.
• Treat publish, convert, merge, and split commands as higher-risk workflows.

Disclaimer

This software is provided “as is”, without warranty of any kind, express or implied. The authors are not responsible for any data loss, report corruption, or other damages resulting from the use of this tool. You use pbir at your own risk. Always maintain independent backups of your reports before making changes, especially with bulk operations, format conversion, merge, and publish workflows.

Support

• Run pbir --help for the top-level CLI surface.
• Run pbir <command> --help for command-specific usage.
• Report issues

---

Kurt Buhler & Maxim Anatsko