foxglove-wizard

A scaffold-free Foxglove quickstart. One command authenticates you, streams an existing MCAP recording live into Foxglove when a viewer connects, then uploads that same recording and creates a searchable event=takeoff event.

No robot or existing stack required — just an MCAP file to replay.

What it does

1. Auth — browser device flow → session bearer token (held in memory; no API key is created, nothing is written to disk).
2. Stream — starts a WebSocket server on ws://localhost:8765, mirrors the input MCAP's channels/schemas, and replays its messages at their recorded cadence once a Foxglove viewer subscribes.
3. Upload — registers the recording (under a timestamped filename) and PUTs the input MCAP's bytes to the signed URL.
4. Event — creates an event=takeoff event 3 seconds into the recording.

Prerequisites

• uv (installs Python and dependencies for you)

Run it locally

From this directory, during development:

uv run foxglove-wizard --help

Local-only smoke test (no auth, no upload) — just stream a recording:

uv run foxglove-wizard --skip-auth --no-wait

Full flow against an environment (no client id to provision — it defaults):

uv run foxglove-wizard

Run it the way a user will (as a uv tool)

uvx --from . foxglove-wizard

Or install it onto your PATH:

uv tool install --editable .

Options

Notes

• The approval step is intentionally browser-based: the terminal prints a code and opens the verification URL; you sign in or sign up and confirm, then the CLI continues. It is not fully headless.
• --client-id is a free-form device-flow label, not a registered OAuth client: the API accepts any non-empty string and only requires it to match between the device-code and token calls. The default (foxglove-wizard) deliberately differs from the desktop client id so approval does not try to launch the desktop app.