Musketeer logo Musketeer

Install Bridge

musketeer-bridge is the optional local daemon for bounded tool execution in a Musketeer workspace.

You do not need the bridge for normal Musketeer CLI usage. Install it when you want a local HTTP daemon that can execute allowlisted tools with strict JSON contracts and on-disk run logs.

What it is for

  • local HTTP execution of allowlisted tools
  • deterministic JSON tool calls
  • on-disk bridge logs and audit trails
  • a clean boundary between a client and local tool execution

It is not the core Musketeer product. The core product is the musketeer CLI.

Requirements

  • Go 1.25.1+

From source

git clone https://github.com/justynclarknetwork/musketeer-bridge.git
cd musketeer-bridge
go build -o target/musketeer-bridge ./cmd/musketeer-bridge

Configure

cp bridge.json.example ~/.musketeer/bridge.json

Then edit ~/.musketeer/bridge.json and set allowlisted_roots to the directories the bridge is allowed to execute tools in.

Run

./target/musketeer-bridge serve

Verify health:

curl -s http://127.0.0.1:18789/v1/health

Expected response:

{"exit_code":0,"ok":true}

Next steps