Universal JAR (CLI)

The CLI distribution is a standalone JAR that runs on any platform with Java 17+.

Build the JAR

From the repository root:

./gradlew :cli:shadowJar

Output:

• cli/build/libs/broxy-cli.jar

Run the proxy

STDIO inbound:

java -jar cli/build/libs/broxy-cli.jar proxy --preset-id <preset-id> --inbound stdio

HTTP inbound:

java -jar cli/build/libs/broxy-cli.jar proxy --preset-id <preset-id> --inbound http --url http://localhost:3335/mcp

CLI options

• --preset-id: required; selects the preset to expose.
• --inbound: stdio or http (aliases: local, remote, sse).
• --url: HTTP listen URL when --inbound http is used.
• --config-dir: custom config directory (defaults to ~/.config/broxy).

When to use the JAR

• Running Broxy on a server or CI machine.
• Integrating with process managers (systemd, launchd).
• Environments without the desktop UI.