pbi-agent 0.12.1

Multi-provider lightweight local coding agent

pbi-agent

work smart.

pbi-agent is a lightweight, model-agnostic local coding agent for multi-domain work. It combines interactive sessions, reusable project skills and commands, sub-agents, MCP tools, and kanban-style coordination in one workspace-first runtime.

Repository: https://github.com/pbi-agent/pbi-agent

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

Demo

Quick Start

1. Install the CLI:

uv tool install pbi-agent

2. Set your provider credentials:

export PBI_AGENT_API_KEY="sk-..."

3. Open your project workspace:

cd /path/to/my-project

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

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/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 repository."
pbi-agent skills add
pbi-agent skills add --skill openai-docs
pbi-agent commands add
pbi-agent commands add --command execute
pbi-agent agents add
pbi-agent agents add --agent code-reviewer