Plugins

Drop-in packages that extend a running agent without touching core — tools, skills, subagents, workflows, FastAPI routes, console dashboards, managed MCP servers, memory backends, and their own config + secrets.

A plugin is just a repo — install one with python -m server plugin install <git-url> (pinned in plugins.lock). The first-party ones below ship with protoAgent.

20 plugins

Delegate Registry

Official Orchestration

A hot-swappable registry of the agents and endpoints your agent can talk to — fleet A2A agents, OpenAI-compatible endpoints, ACP coding agents — managed from the console.

toolsettings
Bundled · enable delegates in plugins.enabled

Discord

Official Communication

Run your agent as a Discord bot — an inbound DM/channel gateway plus outbound posting tools.

surfacetoolsecrets
Bundled · enable discord in plugins.enabled

GitHub (read tools)

Official Integrations

Read-only GitHub over the gh CLI — fetch a PR, an issue, list issues, a commit diff. Opt-in; not every agent needs GitHub.

tool
Bundled · enable github in plugins.enabled

Google (Gmail + Calendar)

Official Integrations

Gmail + Calendar via a managed MCP server, connected in-app with an OAuth consent flow — no credentials.json to wrangle.

mcpsecrets
Bundled · enable google in plugins.enabled

Hello (example)

Official Examples

A minimal starting point — one tool, one bundled skill, and a console view. Copy it to scaffold your own plugin by hand.

toolskillview
Bundled · enable hello in plugins.enabled

Notes

Official Built-in

A single shared markdown note the agent and the operator both read and write. The flagship reference plugin (ADR 0034 S4) — it owns its storage, its agent tools, and a sandboxed-iframe editor it serves itself (ADR 0038). Replaces the legacy native Notes surface.

networkfilesystem
Bundled · enable notes in plugins.enabled

Plugin Devkit

Official Authoring

Build your own plugins — the authoring kit + reference plugin. A scaffold tool, an architect subagent, the building-plugins skill, and a console guide, in one bundle.

toolsubagentskillworkflowview
Bundled · enable plugin-devkit in plugins.enabled

Slack

Official Communication

Run your agent as a Slack app over Socket Mode (no public URL) — inbound messages, replies back out.

surfaceconfig
Bundled · enable slack in plugins.enabled

Telegram

Official Communication

Run your agent as a Telegram bot — inbound DMs and groups, replies back out. A tiny reference communication plugin.

surfaceconfig
Bundled · enable telegram in plugins.enabled

Workflows

Official Built-in

Declarative, multi-step subagent workflows (ADR 0002) — chain subagent steps (some in parallel) into repeatable recipes. Extracted from core to an opt-in plugin (lean core); the engine taps core via the plugin SDK (graph.sdk.run_subagent), never core internals.

networkfilesystem
Bundled · enable workflows in plugins.enabled

projectBoard-plugin

Official Orchestration

Board-driven coding-orchestration plugin for protoAgent: beads board + ACP spawn loop + planning layer + console view. Install via plugin install <git-url>.

beadscoding-orchestrationkanban
plugin install https://github.com/protoLabsAI/projectBoard-plugin

terminal-plugin

Official Pty

A full terminal (xterm.js + a real PTY over WebSocket) as a protoAgent console plugin — themed from the protoAgent design system.

ptyterminalxterm
plugin install https://github.com/protoLabsAI/terminal-plugin

artifact-plugin

Official Ecosystem

Generative-UI plugin for protoAgent — the agent renders HTML/SVG/Mermaid/React into a sandboxed iframe (show_artifact). The reference external plugin.

plugin install https://github.com/protoLabsAI/artifact-plugin

doom-plugin

Official Games

But can it run DOOM? A protoAgent console plugin — play shareware DOOM in a console view via WebAssembly (prboom). No DOS layer.

doom
plugin install https://github.com/protoLabsAI/doom-plugin

pm-stack

Official Bundle

Project Manager Stack — a protoAgent plugin bundle (ADR 0040): board orchestration + browser + delegates. Install: plugin install <git-url>.

plugin install https://github.com/protoLabsAI/pm-stack

agent-browser-plugin

Official Automation

Browser-automation plugin for protoAgent, backed by vercel-labs/agent-browser: tools + skill + workflows + a live browser panel. plugin install <git-url>.

agent-browserbrowser-automation
plugin install https://github.com/protoLabsAI/agent-browser-plugin

spacetraders-plugin

Official Framework

Autonomous SpaceTraders fleet commander — a protoAgent full-bundle plugin (tools, crew, workflows, skills, console dashboard). Install via plugin install <git-url>.

langgraph
plugin install https://github.com/protoLabsAI/spacetraders-plugin

protoTrader Finance

Official Finance

Trading research as a full bundle — market data, backtesting, factor IC, a behavioral journal, a gated paper broker, the research desk, and a Quant Desk dashboard.

toolsubagentworkflowview
plugin install https://github.com/protoLabsAI/prototrader-finance

CLI Coding Agent (ACP)

Official Orchestration

Let the lead agent spawn a CLI coding agent — protoCLI, Claude Code, Codex, or Gemini CLI — and hand it a real coding job over the Agent Client Protocol.

tool
Bundled · enable coding_agent in plugins.enabled

SpaceTraders

Official Examples

An autonomous SpaceTraders fleet commander — crew subagents, navigation/mining/trading tools, workflows, and a Fleet dashboard. The reference full-bundle plugin.

toolsubagentworkflowskillview
plugin install https://github.com/protoLabsAI/spacetraders-plugin

Publish your own

A plugin is a public repo with a protoagent.plugin.yaml manifest — anyone can install one from its git URL with plugin install <git-url>.

For safety, this page only auto-lists plugins from the protoLabsAI org — tagging an outside repo never links it here on its own.

  1. 1. First-party (in our org): tag the repo with the protoagent-plugin topic and it lists itself on the next deploy.
  2. 2. Community: tag the topic so it's discoverable across GitHub, then open a PR adding it to plugins.json — we review it before it's listed here.