                                                                               
 Usage: pbir [OPTIONS] COMMAND [ARGS]...                                       
                                                                               
 Agent-first CLI for Power BI report manipulation (local PBIR format)          
                                                                               
 Fabric CLI: ? Status unavailable - Run fab auth status                        
 Run pbir setup to get started                                                 
                                                                               
 Prerequisites: Reports must be local and in PBIR format                       
   Use pbir download to get remote reports from Fabric                         
                                                                               
 IMPORTANT: Discover properties before setting them                            
   pbir schema types                List visual and entity types               
   pbir schema describe card        List a type's objects + counts             
   pbir schema describe card title  Show an object's properties, values,       
 ranges                                                                        
                                                                               
 Path syntax: Report.Report/Page.Page/Visual.Visual                            
   Type suffixes (.Report, .Page, .Visual) are required                        
   Active report: pbir connect "Report.Report", then pbir get settings         
   Glob patterns: **/*.Visual (all visuals), **/card*.Visual (fuzzy match)     
   Properties: Visual.Visual.title.fontSize (dot notation after path)          
                                                                               
 Made by Kurt Buhler & Maxim Anatsko - version 0.9.25                          
                                                                               
┌─ Options ───────────────────────────────────────────────────────────────────┐
│ --interactive         -i            Launch interactive browser mode (arrow  │
│                                     keys to navigate, q to quit)            │
│ --show-legacy                       Show legacy format reports that need    │
│                                     conversion to PBIR                      │
│ --install-completion                Install shell completion for current    │
│                                     shell (human users only, not agents)    │
│ --show-completion                   Show completion script for current      │
│                                     shell (human users only, not agents)    │
│ --version             -V            Show version and exit.                  │
│ --quiet               -q            Reduce output (suppress animations,     │
│                                     tips, and spinners)                     │
│ --debug                             Enable debug logging to stderr          │
│                                     (tracebacks, timing, resolution)        │
│ --rawdog                            Skip every validation check (umbrella   │
│                                     for --skip all)                         │
│ --skip                        TEXT  Skip a validation category (repeatable, │
│                                     comma-separated): structure, schema,    │
│                                     schema-version, fields, enums, qa       │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ Getting Started ───────────────────────────────────────────────────────────┐
│ setup          Install Power BI agent plugins                               │
│ config        View and manage CLI configuration                             │
│ connect       Start here; set the active connection for report (local       │
│               report in PBIR format or remote report in Fabric or Power BI  │
│               workspace)                                                    │
│ profile       Manage saved connection profiles                              │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ Browse & Query ────────────────────────────────────────────────────────────┐
│ ls            List reports, pages, or visuals; use --tree for tree view and │
│               -v for fields used in each                                    │
│ model         Identify the model a report connects to and its fields to use │
│               them in visuals or query it for more information              │
│ find          Find reports, pages, or visuals using glob patterns           │
│ get           Get properties from report, page, or visual                   │
│ set           Set properties on report, page, or visual                     │
│ cat           Output raw JSON for a page, visual, annotations, or theme     │
│               (pipe to jq for processing)                                   │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ Create & Edit ─────────────────────────────────────────────────────────────┐
│ add           Add pages, visuals, filters, and annotations to existing      │
│               reports                                                       │
│ mv            Move or rename a page or visual between reports/pages         │
│ cp            Copy reports, themes, pages, visuals, filters, bookmarks,     │
│               measures, or visual calculations                              │
│ rm            Remove page, visual, filters, bookmarks, measures, viscalcs,  │
│               fields, or theme                                              │
│ new           Create a new report                                           │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ Workflow ──────────────────────────────────────────────────────────────────┐
│ download      Start here for remote reports; download from Fabric workspace │
│               to work with locally                                          │
│ batch         Declarative multi-step automation for repeatable report       │
│               changes                                                       │
│ validate      Validate report structure and schemas                         │
│ publish       Publish local report to Fabric workspace                      │
│ open          Open report in Power BI Desktop                               │
│ desktop       Drive a running Power BI Desktop instance (Windows, preview   │
│               feature)                                                      │
│ backup        Create a backup of a report before making changes             │
│ bpa           Best Practice Analyzer -- analyze reports and manage rules    │
│ capabilities  Discover visual properties and manage PBIR schemas            │
│ restore       Restore a report from a backup                                │
│ schema        Discover visual properties and manage PBIR schemas            │
│ usage         Report usage metrics from Power BI (views, viewers, pages,    │
│               load times)                                                   │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ Object Commands ───────────────────────────────────────────────────────────┐
│ report        Report-level operations (rename, rebind, convert, merge,      │
│               split-pages, split-from-thick)                                │
│ pages         Page operations (rename, resize, type, background, wallpaper, │
│               move)                                                         │
│ visuals       Visual operations (position, resize, align, format, deneb,    │
│               python, r)                                                    │
│ fields        Field operations (list, find, replace, rename, add)           │
│ filters       Filter operations (list, set, clear, hide, lock) and filter   │
│               pane management                                               │
│ bookmarks     Bookmark operations (list, rename, data, display,             │
│               current-page, visuals, json)                                  │
│ annotations   Annotation operations (list, update, rename)                  │
│ dax           DAX operations (extension measures, visual calculations)      │
│ theme         Theme operations (colors, fonts, background, serialize,       │
│               build, validate)                                              │
│ color         Find, audit, and replace colors across a whole report and its │
│               theme                                                         │
│ fonts         Find, audit, and replace fonts across a report and its theme  │
└─────────────────────────────────────────────────────────────────────────────┘
