pbi-agent 0.0.25

Multi-provider LLM CLI agent for editing Power BI reports

PBI AGENT

Transform data into decisions.

pbi-agent is a local CLI agent that creates, edits, and audits Power BI PBIP reports through natural language.

Full documentation lives at nasirus.github.io/pbi-agent.

Demo

Quick Start

pbi-agent works with PBIP projects, not .pbix files.

1. Install the CLI:

uv tool install pbi-agent

2. Set your API key:

export PBI_AGENT_API_KEY="sk-..."

3. Open an existing PBIP project, or scaffold a new one:

# existing PBIP project
cd /path/to/my-report

# or create a new project
pbi-agent init --dest .

4. Start the app:

pbi-agent

Running pbi-agent with no command launches the browser UI on http://localhost:8000.

Docs

• Installation
• Provider Setup
• CLI Reference
• Environment Variables
• Customization
• Audit System

Customization

pbi-agent supports a few workspace-level customization points:

• INSTRUCTIONS.md replaces the default system prompt for the workspace.
• AGENTS.md adds project-specific rules on top of the active prompt.
• .agents/skills/<skill-name>/SKILL.md adds project-local skills that are advertised to the model.
• .agents/<agent-name>.md adds project-local sub-agents that can be selected through the sub_agent tool.
• .agents/mcp.json declares MCP servers whose tools are exposed to the model at startup.

See the full Customization guide for examples and behavior details.

Common Commands

pbi-agent
pbi-agent web
pbi-agent run --prompt "Summarize this PBIP project."
pbi-agent audit --report-dir .