CLI Reference

pals dash

Live read-only TUI dashboard: peers, invites, and status.

$ pals dash [OPTIONS]

What it does

Opens a terminal-based dashboard that shows three things side by side: the current peer list, your active invites, and the overall swarm status. The view refreshes automatically.

pals dash is read-only. To change anything, use the underlying commands: pals invite create/revoke/resend, pals peers kick.

Options

--refresh

FLOAT

Seconds between auto-refresh cycles. Bounded between 2 and 300. The default of 30 matches the server’s allow-list poll cadence — the dashboard is at most one cycle stale relative to what your servers actually enforce.

Default: 30.0

--config-dir

TEXT

Read config from this directory.

Examples

dash

$pals dash

Faster refresh while debugging:

fast dash

$pals dash --refresh 5

Press Ctrl-C to exit. The terminal’s alt-screen is restored on clean exit.