# summary

Start a local bridge server exposing the setup-agents API for the web UI.

# description

Starts a lightweight HTTP server that exposes the setup-agents service layer as a REST API. The web app (onboarding wizard and dashboard) connects to this server to read project state and apply configurations.

The server runs on localhost and provides CORS headers for browser access.

# flags.port.summary

Port number for the bridge server.

# flags.hostname.summary

Hostname to bind the server to.

# flags.open.summary

Open the browser after starting the server.

# flags.auto-reload.summary

Automatically restart the bridge if a newer plugin version is installed while it's running (GH-753). Off by default.

# examples

- Start the bridge server on the default port (4195):

  <%= config.bin %> <%= command.id %>

- Start on a custom port:

  <%= config.bin %> <%= command.id %> --port 8080

- Start and open the browser:

  <%= config.bin %> <%= command.id %> --open

- Start and auto-restart when a newer version is installed:

  <%= config.bin %> <%= command.id %> --auto-reload

# info.started

Bridge server running at %s
Serving project: %s
Press Ctrl+C to stop.