v3.10.10

Documentation

• Added --no-sync batching guide to report, pages, visuals, and filters skills
• Each skill now documents the pattern: suppress per-command Desktop reloads with --no-sync, then call pbi report reload once at the end

v3.10.9

Documentation

• Added --no-sync batching guide to report, pages, visuals, and filters skills
• Each skill now shows the BAD (per-command reload) vs GOOD (batch with single pbi report reload) pattern

v3.10.8

fix: apply ruff format to desktop_reload.py (CI formatting check)

v3.10.7

Bug Fixes

• pbi report reload now works on newer Power BI Desktop versions -- window detection in the pywin32 path now falls back to matching by process name (PBIDesktop.exe) when the title does not contain "Power BI Desktop" (newer versions title the window with just the report file name)
• PowerShell fallback now actually runs -- _try_pywin32 was returning an error dict instead of None when the window was not found, blocking the fallback chain; fixed to return None so _try_powershell is reached as intended

Internal

• Synced __init__.py version (was stale at 3.10.5)

v3.10.6 - PBIR report-layer fixes

Fixed

• visual bind -- removed legacy Commands/SemanticQueryDataShapeCommand block. PBIR 2.7.0 uses additionalProperties: false on the query object; writing Commands was a hard schema violation that caused Desktop to reject the file.
• visual bind -- added active: true to column (category/row/detail) projections. Desktop requires this flag to treat the field as the active axis; without it the visual renders with no data on the axis.
• visual add -- removed empty "objects": {} from all 32 visual templates. Desktop strips it on save and strict schema validators reject it.
• visual add -- position coordinates are now written as integers, not floats (320 not 320.0). Desktop normalises to integers; the float form was an inconsistency.
• report set-background -- always writes transparency: 0 alongside the color. Power BI Desktop defaults a missing transparency to 100 (fully invisible), making the color silently unrendered. New --transparency flag (0-100, default 0) allows semi-transparent backgrounds.
• report validate -- dropped false-positive layoutOptimization required error. The actual Microsoft 3.2.0 schema does not list this field as required.

Added

• --no-sync flag on report, visual, filters, and bookmarks command groups. Suppresses the per-command Desktop auto-sync for scripted multi-step builds. Use pbi report reload for a single explicit sync at the end:

pbi report --no-sync add-page --display-name "Financials"
pbi visual --no-sync add --page financials --type card --name rev_card
pbi visual --no-sync bind rev_card --page financials --field "Sales[Revenue]"
pbi report reload  # one reload at the end

v3.10.5 -- ASCII Banner Fix

Fixed

• ASCII banner now uses the official art from assets/banner.svg. The I in PBI renders correctly as a narrow column (not an L), and a small block separator makes the - between PBI and CLI clearly visible.

v3.10.4 -- ASCII Banner on First Run

What's New

Added

• ASCII banner displayed in terminal when pbi is invoked with no subcommand. Renders in Power BI yellow on color terminals, plain text fallback on legacy terminals without Unicode support. Skipped when --json flag is used.

Install

pipx install pbi-cli-tool

Then run pbi to see the banner.

v3.10.3 -- Opt-in Claude integration, DLL licensing compliance

What's new in 3.10.3

Claude Code integration is now fully opt-in

pbi connect no longer writes to ~/.claude/ automatically. The new setup flow is:

```bash
pipx install pbi-cli-tool # 1. Install
pbi-cli skills install # 2. Register Claude Code skills (shows what will be written, asks y/N)
pbi connect # 3. Connect to Power BI Desktop
```

A new pbi-cli entry point handles Claude Code setup. pbi-cli skills install/uninstall/list are the explicit management commands. pbi connect prints a one-line tip if skills are not yet installed, but never writes anything.

DLL licensing compliance

The Microsoft Analysis Services client library DLLs bundled in src/pbi_cli/dlls/ are now correctly attributed under Microsoft's own license terms — not sublicensed under MIT. The wheel now ships:

• THIRD_PARTY_LICENSES.md — full verbatim Microsoft Software License Terms (EULA)
• NOTICE — short-form attribution for the 5 bundled DLLs
• src/pbi_cli/dlls/README.md — in-directory sentinel

pyproject.toml uses the PEP 639 SPDX expression MIT AND LicenseRef-Microsoft-AS-Client-Libraries.

SECURITY.md rewrite

• Supported versions table updated to 3.10.x
• Architecture section: accurate description of direct pythonnet/.NET interop (no MCP server, no subprocess)
• Global Configuration Modifications section updated to reflect the opt-in model

Upgrading

```bash
pipx upgrade pbi-cli-tool
```

If you had skills installed from a previous version, they remain in ~/.claude/skills/. Run pbi-cli skills install --force to refresh them to the latest versions.

Full changelog

See CHANGELOG.md for the complete history.

v3.10.1 -- Improved setup UX + visual marketing assets

Improved Setup UX + Visual Marketing Assets

UX Improvement

• pbi connect now shows skill installation progress before attempting connection. If Power BI Desktop is not running, users see that skills and CLAUDE.md were successfully installed before the connection error. Previously the error could make it seem like the entire command failed.

New Visual Assets

• 4 new SVG marketing assets: layers.svg, commands.svg, stats.svg, workflow.svg
• Enhanced banner.svg and before-after.svg with visual-first redesign
• All assets use drawn SVG icons, PBI-CLI block art, and dark GitHub theme
• README updated to reference new assets

Install

pipx install pbi-cli-tool
pbi connect

v3.10.0 -- The First CLI for Both Power BI Modeling and Reporting

The First CLI for Both Power BI Modeling and Reporting

pbi-cli v3 adds a complete report layer alongside the existing semantic model layer -- 32 visual types, pages, themes, filters, bookmarks, and Desktop auto-sync.

Highlights

• Report Layer (no connection needed): pbi report, pbi visual, pbi filters, pbi format, pbi bookmarks
• 32 Visual Types: bar, line, card, KPI, gauge, scatter, combo, table, matrix, slicer, map, and 21 more
• 12 Claude Skills (was 7): 5 new report-layer skills (visuals, pages, themes, filters, report)
• Desktop Auto-Sync: after any report write, pbi-cli saves Desktop state, re-applies changes, and reopens -- no manual close/reopen
• TMDL Diff: pbi database diff-tmdl compares two exports for CI/CD
• 488 tests, all CI green

Numbers

Metric	v2.2.0	v3.10.0
Command groups	22	27
Subcommands	~80	125+
Skills	7	12
Visual types	0	32
Tests	~260	488

Bug Fixes

• TopN filter cross-table subquery fix
• Theme resourcePackages Desktop compatibility
• Card/multiRowCard queryState role corrected (Fields -> Values)
• KPI TrendLine and gauge MaxValue roles added
• Filter integer literals (2014L not '2014')
• 5 command groups were implemented but not registered in CLI

Install

```bash
pipx install pbi-cli-tool
pbi connect
```

Full Changelog

See CHANGELOG.md for v3.0.0 through v3.10.0.