CLI Reference
pct
The TUI launcher and server manager.
pct [OPTIONS] [SUBCOMMAND]
Options
| Option |
Description |
--no-server |
Launch TUI without auto-starting the server |
--version, -v |
Show version |
--help, -h |
Show help |
Subcommands
| Command |
Description |
pct |
Launch TUI (auto-starts server if not running) |
pct server start |
Start the server in the background |
pct server stop |
Stop the server |
pct server restart |
Restart the server |
pct server status |
Check if the server is running |
pct clear-state |
Delete ~/.perceptron/state.json |
TUI Controls
| Key |
Action |
Tab / Shift+Tab |
Cycle 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 |
Enter |
Select view, edit field, confirm |
Esc |
Stop editing, cancel, dismiss overlays |
Space |
Toggle feeds subscription |
? |
Toggle help overlay |
q / Ctrl-C |
Quit |
Runtime Paths
| Path |
Contents |
~/.perceptron/ |
All runtime data |