Skip to main content
Dex uses a consistent set of keybindings across all command centers. This reference documents every keyboard shortcut organized by danger level and command center.

Danger Levels

Dex operations are classified by their potential impact:

SAFE

Read-only operations. No file modifications or side effects.

EDIT

Local file mutations. Changes workspace files but doesn’t publish.

PUBLISH

Live publish/deploy operations. Triggers production side effects.
Always verify the danger level before executing commands. PUBLISH operations affect live production systems.

Global Keybindings

These shortcuts work in all TUI command centers:
KeyActionDanger Level
Ctrl+QQuit Dex completelySAFE
EnterRun selected command or continue to next stepVaries
/ Move cursor up/downSAFE
?Open command palette (Dashboard only)SAFE
EscBack/exit current manager or previous stepSAFE
Esc provides safe navigation backward through wizards and managers. Use it to cancel operations before committing changes.

Dashboard

Main menu navigation for accessing all Dex commands.
KeyActionDanger Level
EnterOpen selected menu commandSAFE
/ Menu navigationSAFE
?Open/close command paletteSAFE

Command Palette Mode

KeyActionDanger Level
TypeFilter commands by querySAFE
/ Navigate filtered resultsSAFE
Backspace / DeleteEdit search querySAFE
EnterRun selected commandSAFE
EscClose paletteSAFE

Init Wizard

Create new entries with guided step-by-step interface.

Global Wizard Controls

KeyActionDanger Level
EnterNext stepEDIT
EscPrevious step or cancelSAFE
Ctrl+QQuit DexSAFE

List-Style Fields

KeyActionDanger Level
Ctrl+AAdd item to listEDIT
Ctrl+DRemove last item from listEDIT

Download Step

Recording download and source configuration.
KeyActionDanger Level
Ctrl+IRecording index import modeEDIT
Ctrl+PPaste modeEDIT
Ctrl+GCycle channel view (mono/stereo/multichannel)SAFE
TabCycle focus between panes (rows/pdf/bundle/source/segments)SAFE
/ Navigate segments and rowsSAFE

Tags Step

Select entry tags with keyboard-driven interface.
KeyActionDanger Level
TypeFilter available tagsSAFE
SpaceToggle tag selectionEDIT
/ Move tag cursorSAFE

Update Wizard

Rehydrate and edit existing entry metadata.

Checklist Stage

KeyActionDanger Level
SpaceToggle section completionEDIT
EnterContinue to edit stageSAFE
EscCancel and return to dashboardSAFE

Edit Stage

KeyActionDanger Level
TypeEdit current fieldEDIT
/ Switch between fieldsSAFE
Ctrl+IImport recording index from source URLEDIT
EnterContinue to review stageSAFE
EscReturn to checklistSAFE

Review Stage

KeyActionDanger Level
Ctrl+SSave and regenerate entry HTMLEDIT
EscReturn to edit stageSAFE

Doctor

Scan and repair entry health issues.
KeyActionDanger Level
/ Select entry reportSAFE
TypeFilter entries by slugSAFE
Ctrl+SRepair selected entryEDIT
EscReturn to dashboardSAFE
Doctor operations scan for drift between entry metadata and generated HTML. Repair operations regenerate files safely.

Entry Audit

Inspect entry inventory and download tree coverage.
KeyActionDanger Level
/ Select inventory rowSAFE
rRerun auditSAFE
EscReturn to dashboardSAFE
Right Pane: Shows download tree and coverage model for selected entry.

Catalog Manager

Manage catalog manifest, spotlight, and publication workflow.
KeyActionDanger Level
mToggle view mode (full/staged)SAFE
aStage manifest entryEDIT
sSet spotlight entryEDIT
vValidate and snapshotEDIT
dDiff against test environmentSAFE
fDiff against prod environmentSAFE
pPublish to testPUBLISH
oPublish to prod (requires confirmation)PUBLISH
lPull from testEDIT
kPull from prodEDIT
rReload catalog dataSAFE
EscReturn to dashboardSAFE
Publishing to prod (o) requires typing the confirmation phrase PUBLISH PROD to prevent accidental production changes.
Manage featured entries on the home page.
KeyActionDanger Level
aSet featured entries listEDIT
eReorder featured entriesEDIT
vValidate and snapshotEDIT
dDiff against testSAFE
fDiff against prodSAFE
pPublish to testPUBLISH
oPublish to prod (requires confirmation)PUBLISH
lPull from testEDIT
kPull from prodEDIT
rReload home dataSAFE
EscReturn to dashboardSAFE

Protected Assets Manager

Validate and publish protected asset lookup mappings.
KeyActionDanger Level
vValidate coverageSAFE
dDiff against testSAFE
fDiff against prodSAFE
pPublish to testPUBLISH
oPublish to prodPUBLISH
bEnsure bucket exists (test)PUBLISH
nEnsure bucket exists (prod)PUBLISH
rReload assets dataSAFE
/ Navigate lookup entriesSAFE
EscReturn to dashboardSAFE

Polls Manager

Create, edit, and publish polls.
KeyActionDanger Level
nCreate new pollEDIT
eEdit selected pollEDIT
oOpen poll for votingEDIT
cClose poll votingEDIT
rRefresh selected poll metricsSAFE
Shift+RReload polls fileSAFE
mRefresh all poll metricsSAFE
tPublish to testPUBLISH
pPublish to prodPUBLISH
EscReturn to dashboardSAFE

Poll Editor Mode

KeyActionDanger Level
/ Move between fieldsSAFE
EnterEdit text fieldEDIT
/ Cycle enum valuesEDIT
SpaceToggle boolean fieldEDIT
S or Ctrl+SSave changesEDIT
EscClose editor (cancel)SAFE

Newsletter Manager

Manage newsletter campaigns, templates, and sending.
KeyActionDanger Level
nCreate draft campaignEDIT
aCycle audience segmentEDIT
sSchedule campaign (+5 minutes)PUBLISH
xSend campaign nowPUBLISH
tTest send to emailPUBLISH
gFetch campaign statsSAFE
pPreview campaignSAFE
kCycle template seedEDIT
rRefresh campaigns listSAFE
/ Select campaignSAFE
EscReturn to dashboardSAFE
Newsletter sending (x) and scheduling (s) operations immediately affect production email campaigns.

Dex Notes Manager

Manage markdown blog posts and editorial workflow.
KeyActionDanger Level
aAdd new post draftEDIT
eEdit selected post in $EDITOREDIT
tSet post titleEDIT
bBuild notes bundleEDIT
vValidate notesSAFE
rReload notes listSAFE
/ Select postSAFE
EscReturn to dashboardSAFE
The e command opens your configured $EDITOR environment variable. Changes are saved when the editor exits.

Status Manager

Manage status incidents and generate incident pages.
KeyActionDanger Level
nCreate new incidentEDIT + PUBLISH
rResolve selected incidentEDIT + PUBLISH
gRegenerate incident pageEDIT
uReload runtime status dataSAFE
EscReturn to dashboardSAFE

Incident Editor Mode

KeyActionDanger Level
/ Move between fieldsSAFE
EnterEdit text fieldEDIT
/ Cycle enum valuesEDIT
S or Ctrl+SSave incidentEDIT + PUBLISH
EscClose editor (cancel)SAFE
Creating and resolving incidents trigger publish events that update the live status page.

Input Behavior

Text Entry

  • Printable characters - Appended to current field
  • Paste - Large clipboard content handled via paste mode
  • Special chars - Control characters filtered except allowed shortcuts

Backspace Handling

Dex recognizes multiple backspace representations:
  • \x7f (standard)
  • \x08 (legacy)
  • key.backspace flag
Arrow keys (, , , ) provide consistent navigation:
  • Vertical - List/menu navigation, field switching
  • Horizontal - Enum value cycling, tab panel focus

Tips for Effective TUI Usage

Esc safely cancels operations and navigates backward. It never commits changes until you explicitly save.
Always verify the danger level indicator before executing commands. PUBLISH operations affect production.
Press ? in the dashboard to quickly filter and run commands without menu navigation.
Wizards show a review stage before committing changes. Use this to verify all data is correct.
Minimum 80×24 recommended. Larger terminals provide better visibility for complex managers.

Build docs developers (and LLMs) love