Launch Plugin Badge

Source: launch-plugin-badge/ The OpenHands frontend has a /launch route that anyone can click. It decodes a plugins parameter, shows a confirmation modal, and — after the user confirms — calls POST /api/v1/app-conversations using the user’s own auth. No secrets in the URL. This is the no-code equivalent of Load a Plugin: instead of writing Python to call the API, you construct a URL and put it in a README badge or an HTML button.

The URL Format

https://app.all-hands.dev/launch?plugins=<BASE64>&message=<URL-ENCODED>

Parameter	Format	Purpose
`plugins`	Base64-encoded JSON array of plugin specs	Which plugins to load
`message`	URL-encoded string	Initial message sent to the agent

Building the URL

Define Your Plugin Spec

plugins = [
    {
        "source": "github:your-org/your-repo",
        "ref": "main",
        "repo_path": "path/to/plugin-dir",
    }
]

Base64-Encode It

import base64
import json

encoded = base64.b64encode(json.dumps(plugins).encode()).decode()

URL-Encode the Message

from urllib.parse import quote

message = "/my-plugin:run"
encoded_message = quote(message)

Assemble the URL

url = f"https://app.all-hands.dev/launch?plugins={encoded}&message={encoded_message}"

Turn It Into a Badge

Once you have the URL, wrap it in Markdown or HTML:

Markdown badge
HTML button
Plain link

[![Open with my plugin](https://img.shields.io/badge/Open%20with%20my%20plugin-blue)](YOUR_LAUNCH_URL)

<a href="YOUR_LAUNCH_URL">
  <button>Open with my plugin</button>
</a>

[Open with my plugin](YOUR_LAUNCH_URL)

Use the Generator Script

The example ships a script that builds and prints these for you:

python build_launch_url.py \
    --source github:your-org/your-repo \
    --repo-path path/to/plugin-dir \
    --message "/my-plugin:run" \
    --label "Try my plugin"

No API key needed — this only constructs URLs.

Parameterized Plugins

If your plugin declares parameters in its manifest, they appear as editable inputs in the launch confirmation modal:

plugins = [
    {
        "source": "github:your-org/your-repo",
        "ref": "main",
        "repo_path": "my-plugin",
        "parameters": {
            "environment": "staging",   # Pre-fills the input; user can change it
        },
    }
]

Sandboxes

Conversations

Plugins & Skills

Hooks

The URL Format

Building the URL

Define Your Plugin Spec

Base64-Encode It

URL-Encode the Message

Assemble the URL

Turn It Into a Badge

Use the Generator Script

Parameterized Plugins

See Also

​The URL Format

​Building the URL

​Define Your Plugin Spec

​Base64-Encode It

​URL-Encode the Message

​Assemble the URL

​Turn It Into a Badge

​Use the Generator Script

​Parameterized Plugins

​See Also

The URL Format

Building the URL

Define Your Plugin Spec

Base64-Encode It

URL-Encode the Message

Assemble the URL

Turn It Into a Badge

Use the Generator Script

Parameterized Plugins

See Also