MarketDeck docs

dashboard

Print the marketdeck-webui URL and (on a local desktop) open it in the default browser.

marketdeck dashboard is the shortcut for "show me the web UI". It resolves the marketdeck-webui plugin's bound address, prints the URL, and — on a local desktop session — pops it open in your default browser. Designed to stay scriptable: no plugin, no URL, exit 0 with a clear hint.

Usage#

marketdeck dashboard [--start] [--no-open]

Flags#

FlagWhat it does
--startIf the webui server isn't running, spawn marketdeck webui start --background first, wait for the port to come up, then continue.
--no-openPrint the URL but do not launch a browser — even on a local desktop. Useful in scripts that just want the address.

Behaviour#

  • Server up + local desktop → URL printed, browser opens.
  • Server up + headless / SSH → URL printed, browser open skipped (no display). --start still works there — handy for "boot the server so my LAN browser can hit it".
  • Server down + no --start → URL + start hint printed; no browser tab is opened. We refuse to pop a tab that would immediately hit ERR_CONNECTION_REFUSED.
  • marketdeck-webui plugin missing or disabled → no URL is shown; the command prints the install/enable hint and exits 0 so a wrapper script keeps working.

Examples#

marketdeck dashboard                # print URL + open in browser
marketdeck dashboard --no-open      # just print the URL
marketdeck dashboard --start        # bring up the server first
marketdeck dashboard --start --no-open
marketdeck dashboard --format json  # scriptable shape: {url, started, opened, ...}