Broski

CLI Reference

Core commands for the Broski binary.

Basic Usage

bash
broski [command] [options]

Core Commands

bash
# Start bridge (default)
broski

# Setup / config
broski setup
broski configure

# Diagnostics
broski doctor
broski doctor --fix
broski doctor --profile pairing
broski doctor --export

# Guided troubleshooting
broski troubleshoot

# Logs
broski logs
broski logs --follow
broski logs --export

# Pairing
broski qr
broski qr --new-token

# Background service
broski install
broski status
broski stop
broski restart
broski uninstall

Doctor Options

bash
# Full diagnostic run
broski doctor

# Apply safe automatic fixes
broski doctor --fix

# Focused profiles
broski doctor --profile network
broski doctor --profile pairing
broski doctor --profile agents
broski doctor --profile daemon
broski doctor --profile security

# Deep checks + machine-readable output
broski doctor --deep
broski doctor --json

# Export redacted diagnostics bundle
broski doctor --export

Logs Options

bash
# Show recent logs
broski logs

# Stream logs live
broski logs --follow

# JSON output (for tooling)
broski logs --json --follow

# Include only latest N lines
broski logs --lines 300

# Export redacted diagnostics bundle
broski logs --export

# Power-user controls
broski logs --no-errors
broski logs --redact
broski logs --no-redact

Serve Options

bash
# Custom bridge port
broski --port 8080

# Tailscale Funnel public URL
broski --funnel

# Hotspot-friendly IP prioritization
broski --hotspot

# OpenCode attach/manual modes
broski --attach
broski --manual --opencode-url http://localhost:4096

Related

Troubleshooting

Fix connection, pairing, backend, and daemon issues

Bridge Configuration

Service, network, and runtime behavior