← Back to Home

No published plugins yet — Forge OS is in alpha.

Built a plugin? Open a pull request or file an issue on GitHub and we'll feature it here.

How Plugins Work

Install from file

Drop a .fp or .zip file onto the Plugins screen. The new tool is callable on the next agent turn.

Generate mid-loop

The agent can call plugin_create with an id, name, description, tool name, and Python code. No restart needed.

Survive upgrades

Plugins are exported and re-imported across app upgrades. Your custom tools don't disappear when you update.

Sandboxed execution

Plugin code runs inside the same sandboxed Python 3.11 runtime as regular scripts — same timeouts, same import filtering, same security policy.

Plugin Structure

A minimal plugin needs an id, a name, a description, a tool name, a tool description, and a Python function body. The agent calls the tool by name and receives the return value as a string.

See the plugin documentation or the GitHub repo for full details.