PBIR Tools v0.9.9

Important: This tool works best for targeted, iterative changes to existing reports -- formatting, property adjustments, field binding, theme changes, validation. It's not designed to replace your thinking or design, and it's also constrained by the brittle limitations of Power BI reports, themselves.

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills (v0.26.0): Get skills from the
power-bi-agentic-development
marketplace. For Claude Code: claude plugin add marketplace data-goblin/power-bi-agentic-development

---

New

• Error bars -- pbir visuals error-bars add/list/remove for bullet chart patterns using upper/lower bound measures on chart series
• Reference lines -- pbir visuals reference-line add/list/remove for constant or measure-driven reference lines on chart axes
• CF dot-path syntax -- read and write conditional formatting via pbir get/set using .cf.gradient, .cf.rules, .cf.measure paths
• Model schema disk cache -- pbir set with field() selectors now caches model definitions to disk, cutting repeated calls from ~23s to ~0.4s
• pbir model --clear-cache -- invalidate cached model definitions after schema changes

Bug Fixes

• Field names with parentheses (e.g. OTD % (Lines)) now work correctly in field() selectors
• pbir pages rename --to now updates both folder name and displayName (previously only renamed the folder)
• .pbi runtime-state files no longer cause schema validation crashes

Deprecated

• pbir setup -- replaced by native plugin marketplaces; run pbir setup for instructions
• pbir visuals format-field -- use pbir set "Visual.component.field(Table.Field).property" instead
• pbir visuals format-state -- use pbir set "Visual.component.hover.property" instead

PBIR Tools v0.9.8

Important: This tool works best for targeted, iterative changes to existing reports -- formatting, property adjustments, field binding, theme changes, validation. It's not designed to replace your thinking or design, and it's also constrained by the brittle limitations of Power BI reports, themselves.

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills (v0.22.4): Run pbir setup after installing, or get skills from the
power-bi-agentic-development
marketplace.

---

New

• Auto-upgrade schemas on validate -- pbir validate now silently upgrades outdated $schema references to the latest bundled versions before validation, enabling full visual-type-specific checks without a separate step
• Per-series/field/state selector syntax for get_property / set_property paths (e.g. set formatting per data series)
• Thick PBIX graceful error -- converting a thick PBIX now shows clear steps (open in Desktop, Save As PBIP) instead of a cryptic module error
• Schema provenance tracking -- pbir validate -v now shows exactly which schema was used, where it came from (bundled/cached/fetched), and whether it's authoritative

Bug Fixes

• pbir cat no longer crashes with "No module named pygments" in the binary installer (fixes #11, #13)
• Field resolver now correctly detects measures vs columns using the connected model, replacing broken DMV queries (fixes #7 measure binding)
• active: true no longer emitted on query projections, preventing Desktop crashes when adding fields to tables (fixes #7 active property)
• camelCase data role names (e.g. smallMultiples) now resolve correctly via visual-type-aware matching
• New reports now use the latest bundled schema versions instead of hardcoded old ones

Changes

• Pygments dependency fully removed -- JSON output uses console.print_json instead of syntax highlighting
• Schema validation now tracks three separate families (report, semantic model, theme) with explicit provenance states
• pbir validate --update-schemas flag deprecated -- auto-upgrade happens automatically

PBIR Tools v0.9.7

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills (v0.21.0): Run pbir setup after installing, or get skills from the
power-bi-agentic-development
marketplace.

---

Bug Fixes

• Setting font colors and other color properties on table/matrix containers (rowHeaders, columnHeaders, values, etc.) now works correctly
• Visuals created via --from-json no longer silently bind measures as Columns
• Table visuals no longer emit active: true on projections, which caused Desktop crashes when adding new fields
• Page background --image and --clear no longer crash
• Visual group changes (group name, mode) are now persisted on save
• Per-field formatting colors now use the correct format
• Boolean properties (e.g. keepLayerOrder) are now serialized correctly
• Filter creation with values no longer silently drops the filter values
• Copying filters between reports no longer shares internal references

New

• pbir bookmarks page -- set which page a bookmark navigates to
• pbir pages rename -- rename page folders with pattern support
• pbir visuals rename -- rename visual folders with sanitization

PBIR Tools v0.9.5

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills (v0.18.1): Run pbir setup after installing, or get skills from the
power-bi-agentic-development
marketplace. Without skills, your agent won't know how to use the CLI.

---

Bug Fixes

• fields rename and other mutations via report.save() now actually write to disk -- previously changes were applied in memory but the visual JSON files were never updated (#5)
• pbir setup now works in native installer builds, not just the pip/uv install (#6)
• Windows users with non-ASCII characters in their username (e.g. Polish, Japanese) no longer crash on pbir setup
• model -d picks up the active connection so you don't have to re-type the report path
• Shell tab completion gives correct paths for PBIP projects
• Theme changes are no longer silently dropped during save
• Security: fastmcp 3.1.1 -> 3.2.0

New

• pbir ls --all now supports: fields, filters, measures, viscalcs, bookmarks, annotations

PBIR Tools v0.9.4

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills: Run pbir setup after installing, or get skills from the
power-bi-agentic-development
marketplace. Without skills, your agent won't know how to use the CLI.

---

pbir -- a command-line tool for Power BI reports

A filesystem paradigm for Power BI reports. Navigate, manipulate, and query reports using
familiar commands like ls, cat, tree, and cp. Built for humans, optimized for agents.

Browse & Query

• pbir ls / pbir tree -- list and explore reports, pages, visuals, and fields
• pbir find -- glob-based search across reports (**/*.Visual, **/card*.Visual)
• pbir get / pbir set -- read and write any property by dot notation
• pbir cat -- raw JSON output (pipe to jq for processing)
• pbir model -- query the connected semantic model (schema, DAX queries, field discovery)
• pbir fields -- list, find, replace, and rename field references across reports
• pbir schema -- discover visual types, containers, properties, data roles, and value ranges

Create & Edit

• pbir new report -- create reports with theme, page, and model connection
• pbir add -- add pages, visuals (38+ types), filters, bookmarks, annotations, and images
• pbir cp / pbir mv / pbir rm -- copy, move, rename, and remove any report object
• pbir visuals bind -- bind fields to visual data roles with Column/Measure auto-detection
• pbir dax -- extension measures and visual calculations (RUNNINGSUM, RANK, etc.)

Format & Style

• pbir visuals -- title, subtitle, background, border, shadow, padding, spacing, divider,
  header, legend, axis, labels, tooltip, position, resize, align, z-order, snap, preset
• pbir visuals cf -- conditional formatting (gradient, measure-driven, rules-based)
• pbir visuals clear-formatting -- reset to theme defaults
• pbir theme -- colors, fonts, text-classes, set-colors, set-formatting, push-visual,
  serialize/build, templates, validate

Bulk Operations

• Glob patterns: pbir set "Report.Report/**/*.Visual.title.fontSize" --value 14 -f
• --where filtering: target by visual type, size, or position
• --dry-run to preview changes before applying
• pbir batch -- declarative multi-step automation with schema validation

Filters & Bookmarks

• Categorical, TopN, RelativeDate, and Advanced filters at report, page, or visual level
• Filter pane management (hide, collapse, style)
• Bookmarks with data/display/page capture and visual targeting

Reports & Workflow

• pbir connect / pbir profile -- connection management and saved profiles
• pbir download / pbir publish -- Fabric workspace integration
• pbir backup / pbir restore -- safety net before edits
• pbir validate -- structure, schema, field, and quality checks
• pbir report -- rename, rebind, convert (PBIR/PBIP/PBIX), merge, split

Agent Integration

• pbir setup -- auto-detects Claude Code, Copilot, Cursor, Gemini, Codex
• Installs skills from power-bi-agentic-development
• Skills teach agents the CLI commands, patterns, and best practices
• --quiet mode for agent-friendly output

PBIR Tools v0.9.1

Run pbir --help for usage.
Feedback: https://github.com/maxanatsko/pbir.tools/issues

PBIR Tools v0.9.0

Run pbir --help for usage.
Feedback: https://github.com/maxanatsko/pbir.tools/issues