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 |