> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/protobot/overview.md).

# ProtoBot overview

What ProtoBot is, where to find it in the editor, what it can do on your board and how it fits next to external agents

## Goal

Know what ProtoBot does and when to use it.

**ProtoBot** is the agent built into Protoboard. You describe what you want in plain language, and it searches the parts library, places and wires parts, allocates pins, runs DRC, edits Board Identity and works on the BOM, on the board you have open. You review every change and can undo it.

## Where to find it

* **In the editor:** click the robot icon at the top of the left rail. The **Agents** panel opens with two tabs: **ProtoBot** (the chat) and **External** (agents connected through MCP).
* **On Home:** the **PROTOBOT** prompt creates a new board and starts ProtoBot on it. See [Home and prompt-to-board](https://docs.protoboard.xyz/organize/home-and-prompt-to-board.md).

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-f4142c469ce91f2e97ef04709172490df62a2628%2Fprotobot-panel-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-babc8b3dadde6e32246841a009e5754b7c8a945c%2Fprotobot-panel-light.png?alt=media" alt="The Agents panel with the ProtoBot tab selected, the session history and new chat buttons, the battery indicator and the message box with model, reasoning effort and mode controls"></picture><figcaption><p>The ProtoBot panel.</p></figcaption></figure>

## What you control

| Control              | What it sets                                                                                                                                     |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Mode**             | How much ProtoBot may change: **Plan**, **Concept** or **Integrate**. See [Modes](https://docs.protoboard.xyz/protobot/modes.md)                 |
| **Model**            | Which AI model answers. See [Models and reasoning effort](https://docs.protoboard.xyz/protobot/models-and-reasoning.md)                          |
| **Reasoning effort** | How long it thinks before acting                                                                                                                 |
| **Battery**          | Your remaining ProtoBot Energy. See [Energy and usage](https://docs.protoboard.xyz/protobot/usage-and-energy.md)                                 |
| **Sessions**         | Each board keeps its own chat history. See [Plans, approvals and sessions](https://docs.protoboard.xyz/protobot/plans-approvals-and-sessions.md) |

## Good uses

* Turn a description into a first board: "A battery-powered CO2 monitor with a display and BLE".
* Do repetitive wiring: "Connect all five sensor outputs to free analog pins".
* Explain and fix DRC issues: "Why is the Left motor control harness yellow?"
* Keep the plan current: "Add a requirement that it runs 30 minutes on one charge".
* Price the board: "Fetch prices and tell me the three most expensive parts".

## ProtoBot or an external agent?

{% columns %}
{% column %}

### ProtoBot

* No setup; works in the browser
* Plan approval and part-request confirmation in the chat
* Uses ProtoBot Energy
  {% endcolumn %}

{% column %}

### External agent (MCP)

* Claude Code, Cursor, Codex and other MCP clients
* Your own model and subscription
* Doesn't use ProtoBot Energy
  {% endcolumn %}
  {% endcolumns %}

Both use the same tools. See [Agent Bridge overview](https://docs.protoboard.xyz/agent-bridge/overview.md).

## Privacy

ProtoBot sends your board data and conversation to its AI model provider to answer. Don't paste credentials or regulated data into the chat. See [Energy and usage](https://docs.protoboard.xyz/protobot/usage-and-energy.md#data-and-privacy).

## Related pages

* [Design with ProtoBot](https://docs.protoboard.xyz/tutorials/design-with-protobot.md): the end-to-end walkthrough
* [What ProtoBot can change](https://docs.protoboard.xyz/protobot/what-protobot-can-change.md)
* [Prompt patterns](https://docs.protoboard.xyz/protobot/prompt-patterns.md)
