The cockpit is the terminal UI you get when you run prevail. It’s keyboard-first, with three zones: a sidebar on the left, a workspace on the right, and the ConfigBar along the bottom.
Navigating domains and tabs in the live cockpit. ┌─ prevAIl ─────────────────────────────────────────────────────────────────┐
│ domains │ [chat] · state · quick start · prompts · skills │
│ ─────────────── │ ─────────────────────────────────────────────── │
│ ▸ wealth ● │ council ● ON framework ◆ BLUF │
│ health · │ ─ chat ────────────────────────────────────────── │
│ tax · │ you › what's new in tax this quarter? │
│ career · │ ai › Three deltas worth pulling forward … │
│ ─────────────── │ ─ ConfigBar ───────────────────────────────────── │
│ 1password ✓ │ Council·Framework·Lens·Web·Save·Serendipity·Auto │
└─────────────────────┴─────────────────────────────────────────────────────┘
Sidebar — two stacked lists: your domains (with ● active / · idle markers) and your apps /connectors below (✓ connected, ! needs attention, · not configured). Press sTab strip — every domain has the same tabs: chat · state · quick start · prompts · skills . Press e$EDITOR.ConfigBar — the per-turn dials along the bottom (see below).
The ConfigBar carries everything that can change turn-to-turn, so you never dig through menus:
Dial What it controls Council Fan this turn out to every model, or use a single one. → The council Framework The answer’s structure — BLUF, SCQA, pros/cons, steelman… → Frameworks Lens The angle the panel takes. → Lenses Web Allow this turn to reach the internet (default: off). Save Whether the turn is written to the domain’s log. Serendipity Inject a cross-domain wildcard for lateral ideas. Auto Let Prevail pick sensible dials for the question.
Each domain remembers its own ConfigBar settings.
Key Action ↑ / ↓Move between domains (or apps, depending on focus) sSwap focus between the domains and apps lists eEdit the active markdown tab in $EDITOR nScaffold a new domain folder rRescan the vault and re-probe models /Start a slash command q / Ctrl-CQuit (Ctrl-C also aborts an in-flight turn)
$EDITOR is whatever your shell exports — vim, nano, code -w, hx. Set it in your shell profile so e opens your editor of choice.
Inside the chat pane, anything starting with / is a command. Type /help to list them all; most have short aliases.
Command Aliases What it does /helpList every slash command /clearReset the conversation (keeps your config) /exit/quit, /qReturn to the cockpit /claude · /codex · /antigravity · /ollama [model]/agySwitch this chat to that model /model <name>Set the model on the current CLI; /model default clears it
Command What it does /council [prompt]Fan the question to every available model; the chair synthesizes a verdict /council use <cli> …Set which models sit on the council /council chair [cli] [model]Pin which model acts as the chair /council configShow the current council configuration /gut <text>Capture your gut take before synthesis — the chair weighs it in
Command Aliases What it does /framework <id>/fwApply a framework: bluf, win, scqa, sbar, ooda, proscons, steelman /web [on|off|status]Toggle web access for the turn (default: off)
Command Aliases What it does /distill/skillSynthesize this conversation into a reusable SKILL.md draft /search <query>/sFull-text search across every past chat, any domain /history [n]/hRecall your last n prompts in this domain
Command Aliases What it does /connectors [test|oauth] <id>/connList connectors or run a connector’s auth flow /telegram [sub]/tgManage Telegram from the cockpit /briefing [sub]Manage scheduled briefings /heatmap [days]/heatShow an activity heatmap /watch [limit]/obsMonitor live vault changes
The cockpit needs a UTF-8, true-color terminal. It’s tested on iTerm2, kitty, alacritty, WezTerm, Ghostty, and GNOME Terminal. If the banner or chips look broken, your terminal probably isn’t in xterm-256color mode. → Platform support
