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.

11 plugins

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

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
Source ↗ Docs ↗

Publish your own

A plugin is a public repo with a protoagent.plugin.yaml manifest. Anyone can install it from its git URL. To get it discovered + listed here:

  1. 1. Tag your repo with the protoagent-plugin GitHub topic — that makes it discoverable across GitHub.
  2. 2. Open a PR adding it to plugins.json (with a category) to feature it on this page.
Publishing guide Browse the topic ↗