CLI Reference

Usage

moqtap <command> [options]

Global options

Flag	Description
--json	Output as JSON (where supported)
--insecure	Accept invalid TLS certificates
--draft <VERSION>	Force a specific MoQT draft version
--timeout <MS>	Connection timeout in milliseconds
--strict	Reject non-conformant messages
-v, --verbose	Increase log verbosity

Commands

peek [URL]

Lightweight MoQT client for probing relays. Auto-detects transport (QUIC or WebTransport) and draft version.

# Show relay info and draft version
moqtap peek moqt://relay.example.com

# Discover published namespaces
moqtap peek moqt://relay.example.com namespaces

# List tracks in a namespace
moqtap peek moqt://relay.example.com tracks <NAMESPACE>

# Fetch data from a track
moqtap peek moqt://relay.example.com data <NAMESPACE> <TRACK>

# Fetch only the latest group
moqtap peek moqt://relay.example.com data <NAMESPACE> <TRACK> latest

intercept -u <RELAY>

Transparent intercepting proxy. Sits between a MoQT client and an upstream relay, forwarding traffic unmodified while parsing every frame inline.

# QUIC listener (default 127.0.0.1:4443) proxying to upstream relay
moqtap intercept -u moqt://relay.example.com

# WebTransport listener
moqtap intercept -u moqt://relay.example.com --listen-wt

# Record session to a .moqtrace file
moqtap intercept -u moqt://relay.example.com --output session.moqtrace

# Filter to control messages only
moqtap intercept -u moqt://relay.example.com --filter ctrl

# JSON output
moqtap intercept -u moqt://relay.example.com --format json

Flag	Description
-u, --upstream <URL>	Upstream relay URL (required)
--listen-wt	Listen for WebTransport connections instead of QUIC
--output <PATH>	Save session to a .moqtrace file
--filter <TYPE>	Filter output: ctrl (control messages only), data (data streams only)
--session <ID>	Filter to a specific session ID
--cert <PATH>	Custom TLS certificate
--key <PATH>	Custom TLS private key
--format <FMT>	Output format: text (default) or json

trace <FILE>

Replay and inspect recorded .moqtrace files.

# Replay a trace file
moqtap trace session.moqtrace

# JSON output
moqtap trace session.moqtrace --format json

# Hex dump mode
moqtap trace session.moqtrace --hex

completions <SHELL>

Generate shell completions.

moqtap completions bash
moqtap completions zsh
moqtap completions fish
moqtap completions powershell
moqtap completions elvish

Configuration

moqtap resolves configuration in this order (first match wins):

1. Inline URL argument
2. MOQTAP_RELAY environment variable
3. .moqtap.toml in the current directory or any parent (walks up like .gitignore)
4. ~/.config/moqtap/config.toml (Linux/macOS) or %APPDATA%\moqtap\config.toml (Windows)

URL schemes

Scheme	Transport
moqt://	Auto-detect (tries QUIC, falls back to WebTransport)
https://	Auto-detect (tries QUIC, falls back to WebTransport)
quic://	QUIC only
wt://	WebTransport only

Exit codes

Code	Meaning
0	Success
1	Error
2	Connection error