Metadata-Version: 2.4
Name: pbi-agent
Version: 0.13.0
Summary: Multi-provider lightweight local coding agent
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: aiohttp==3.13.4
Requires-Dist: codetool-explore==0.7.0
Requires-Dist: fastapi==0.135.2
Requires-Dist: lark==1.3.1
Requires-Dist: mcp==1.26.0
Requires-Dist: pandas[excel]==3.0.1
Requires-Dist: pyarrow==23.0.1
Requires-Dist: pypdf==6.10.2
Requires-Dist: python-docx==1.2.0
Requires-Dist: python-dotenv==1.2.2
Requires-Dist: rich==14.3.3
Requires-Dist: uvicorn[standard]==0.43.0
Description-Content-Type: text/markdown

<div align="center">

<img src="src/pbi_agent/web/static/logo.jpg" alt="pbi-agent logo" width="120">

# pbi-agent

*work smart.*

[![Tests](https://github.com/pbi-agent/pbi-agent/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/pbi-agent/pbi-agent/actions/workflows/tests.yml)
[![Release](https://github.com/pbi-agent/pbi-agent/actions/workflows/release.yml/badge.svg)](https://github.com/pbi-agent/pbi-agent/actions/workflows/release.yml)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-gold)](LICENSE)

</div>

`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](https://github.com/pbi-agent/pbi-agent)

Full documentation lives at [pbi-agent.github.io/pbi-agent](https://pbi-agent.github.io/pbi-agent/).

## Demo

[![Watch the demo](https://img.youtube.com/vi/vw3RVwbILbE/maxresdefault.jpg)](https://pbi-agent.github.io/pbi-agent/#demo)

## Quick Start

1. Install the CLI:

```bash
uv tool install pbi-agent
```

2. Set your provider credentials:

```bash
export PBI_AGENT_API_KEY="sk-..."
```

3. Open your project workspace:

```bash
cd /path/to/my-project
```

4. Start the app:

```bash
pbi-agent
```

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

## Docs

- [Installation](https://pbi-agent.github.io/pbi-agent/installation)
- [Provider Setup](https://pbi-agent.github.io/pbi-agent/providers)
- [CLI Reference](https://pbi-agent.github.io/pbi-agent/cli)
- [Environment Variables](https://pbi-agent.github.io/pbi-agent/environment)
- [Customization](https://pbi-agent.github.io/pbi-agent/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](https://pbi-agent.github.io/pbi-agent/customization) for examples and behavior details.

## Common Commands

```bash
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
```
