CLI Reference

pct

The TUI launcher and server manager.

pct [OPTIONS] [SUBCOMMAND]

Options

OptionDescription
--no-serverLaunch TUI without auto-starting the server
--version, -vShow version
--help, -hShow help

Subcommands

CommandDescription
pctLaunch TUI (auto-starts server if not running)
pct server startStart the server in the background
pct server stopStop the server
pct server restartRestart the server
pct server statusCheck if the server is running
pct clear-stateDelete ~/.perceptron/state.json

TUI Controls

KeyAction
Tab / Shift+TabCycle panel focus (Sidebar / Center / QuickPanel)
Up / Down (or k / j)Navigate within focused panel
Left / Right (or h / l)Change selections, cycle quick panel views
EnterSelect view, edit field, confirm
EscStop editing, cancel, dismiss overlays
SpaceToggle feeds subscription
?Toggle help overlay
q / Ctrl-CQuit

Runtime Paths

PathContents
~/.perceptron/All runtime data