mdp

Starts the orchestrator with an interactive TUI. Manages all proxy instances and shows their registered services.

Keys: ↑/↓ (or j/k) navigate, Enter switch active server, Tab / h / l switch tabs, d detach (leave daemon running), q quit (stop daemon). Mouse clicks are supported.

mdp
mdp --control-port 13100

A web dashboard is also served on --dashboard-port (default 6370) — open http://localhost:6370 if you prefer a browser UI to the TUI.

mdp --daemon / mdp -d

Starts the orchestrator as a background daemon (no TUI). Useful for CI or when you don't need the interactive interface.

mdp -d
# prints: mdp orchestrator started (PID 12345, ctrl :13100)

mdp run

Wraps a dev command. Picks a free port, sets it as an environment variable in the child process, and registers with the orchestrator. When the process exits, it deregisters automatically.

mdp run -- npm run dev
mdp run -P 4000 -- go run ./cmd/server
mdp run --env API_PORT -- docker compose up

Without a command, reads mdp.yaml and batch-starts all configured services:

mdp run                        # uses current git branch as group
mdp run --group feature-auth   # override group name

When a command is given, mdp run picks its mode in this order:

1. Orchestrator mode — if an orchestrator is running on --control-port, register with it.
2. Standalone proxy mode — otherwise, probe --proxy-port for a bare mdp proxy (no orchestrator) and register with it if found.
3. Solo mode — otherwise, run the command directly with no proxy.

Batch mode (mdp run with no command) requires an orchestrator — it errors out if one isn't running.

mdp register

Manually registers an already-running service.

mdp register myapp/main --port 4000 -P 3000
mdp register myapp/main --port 4000 --pid 12345
mdp register --list

mdp deregister

Remove a server from all proxies. Useful when an externally managed service (e.g. Docker) stops without notifying the orchestrator.

mdp deregister myapp/main

mdp switch

Switch active upstream service or group from the command line. See how switching works for the resolution order.

mdp switch app/main -P 3000          # switch individual server
mdp switch --group main              # switch all services in a group
mdp switch --clear -P 3000           # clear default

mdp status

Print daemon status, proxies, registered servers, and groups. Add --json for machine-readable output.

mdp status
mdp status --json

mdp logs

Show the daemon's log output. Defaults to the last 50 lines; use -f to follow.

mdp logs
mdp logs -n 200
mdp logs -f

mdp --stop

Stop the background orchestrator.

mdp --stop

Configuration

Environment variables:

**mdp flags:**

**mdp run flags:**

**mdp register flags:**

**mdp switch flags:**

← Back to docs index