promethios-bridge

Run Promethios agent frameworks locally on your computer — with full access to your files, terminal, and browser.

Quick Start

npx promethios-bridge --token <your-setup-token>

Get your setup token from Promethios → Settings → Local Bridge → Generate Setup Token.

What it does

The bridge connects your computer to Promethios so that agent frameworks can execute tools locally instead of (or in addition to) the cloud sandbox.

Once running, open any thread in Promethios and use the Cloud / My Computer / Hybrid toggle in the thread header.

| Mode | What runs where | |---|---| | ☁️ Cloud | All tools run in Promethios cloud sandbox (default) | | 💻 My Computer | All tools run on your machine via this bridge | | ⚡ Hybrid | Agent decides per-tool — local for files/terminal, cloud for APIs |

Permissions

The first time a framework requests local execution, Promethios shows you exactly what it wants access to. You approve or deny each capability before anything runs.

Capabilities the bridge supports:

• filesystem.read — Read files on your machine
• filesystem.write — Write files on your machine
• terminal.execute — Run shell commands
• terminal.readonly — Run read-only commands (ls, cat, etc.)
• browser.open — Open URLs in your browser
• network.http — Make HTTP requests (useful for localhost APIs)

Options

--token <token>   Setup token from Promethios (required on first run)
--api <url>       Promethios API base URL (default: https://api.promethios.ai)
--port <port>     Local port for the bridge server (default: 7823)
--dev             Verbose debug logging

Security

• The bridge only listens on 127.0.0.1 (localhost) — it is not accessible from the internet.
• All tool calls are authenticated and signed by the Promethios cloud.
• Destructive commands (rm -rf /, mkfs, etc.) are blocked at the executor level.
• You can disconnect at any time with Ctrl+C.

License

MIT