Keyboard Shortcuts

A single-page reference for every keyboard shortcut in the Watchfire CLI/TUI and GUI. The page is designed to print cleanly on US Letter portrait — open the browser print dialog and save as PDF for offline reference.

The detailed prose lives in the CLI/TUI and GUI component pages. This page is the lookup table.

Global TUI

These bindings are active anywhere in the TUI, regardless of which panel is focused.

Shortcut	Action
Ctrl+q	Quit
Ctrl+h	Toggle help overlay
Ctrl+g	Open global settings overlay
Ctrl+f	Open fleet (cross-project) insights overlay
Ctrl+e	Export report (CSV or Markdown)
Ctrl+i	Open integrations overlay
Tab	Switch focus between left and right panel
Shift+drag	Select text (copy)

TUI — task list navigation

Movement and search inside the Tasks tab when the left panel has focus.

Shortcut	Action
j / ↓	Move selection down
k / ↑	Move selection up
Shift+↑	Move selected task up within its status group
Shift+↓	Move selected task down within its status group
/	Start incremental search across tasks
Enter	Confirm search (while searching)
Esc	Cancel search

TUI — task actions

Available when the task list is focused. d is context-sensitive — on a done task it opens the inline diff viewer; on any other task it sets the task to done.

Shortcut	Action
a	Add a new task
e / Enter	Edit the selected task
s	Start agent on the selected task
S	Stop the running agent
w	Start wildfire mode
!	Start all ready tasks sequentially
r	Set selected task to Ready
t	Set selected task to Draft
d	Mark Done · or open the diff overlay if already Done
i	Open per-project insights overlay
x	Soft-delete the selected task

TUI — task form

The Add / Edit Task overlay. The agent field is a cycling selector — Space, Enter, or → cycles forward; ← cycles back.

Shortcut	Action
Tab	Move to next field
Ctrl+s	Save and close
Esc	Cancel and close
Space / Enter	Toggle status · or cycle agent forward
→	Cycle agent forward
←	Cycle agent back

TUI — left panel tabs

Switching between Tasks, Definition, and Settings. Works whenever the left panel is focused.

Shortcut	Action
1	Tasks
2	Definition
3	Settings

Definition tab

Shortcut	Action
e / Enter	Edit definition in $EDITOR
j / ↓	Scroll down
k / ↑	Scroll up

Settings tab

Shortcut	Action
j / ↓	Move down
k / ↑	Move up
Space	Toggle a boolean field
Enter	Edit a text field

TUI — right panel tabs

The right panel hosts Chat (live agent terminal) and Logs (per-task session history). The right panel does not currently expose keyboard tab switching — click a tab in the header to switch. Once a tab is focused, the keys below apply.

Chat / terminal

Shortcut	Action
(type)	Input streams directly to the agent
PgUp / PgDn	Scroll terminal scrollback
R	Resume agent after an issue banner

Logs

Shortcut	Action
j / ↓	Move down in log list
k / ↑	Move up in log list
Enter	Open the selected log
Esc	Back to log list
PgUp / PgDn	Scroll log content
d	Delete the selected log

TUI — integrations overlay

Opened with Ctrl+i. Tab toggles between the Outbound and Inbound tabs.

Outbound list mode

Shortcut	Action
j / ↓	Move down
k / ↑	Move up
a	Add a new adapter
e	Edit the selected adapter
d	Delete the selected adapter
t	Send a synthetic test event
Tab	Switch to the Inbound tab
Esc / q	Close the overlay

Add-adapter form

Shortcut	Action
h / ←	Cycle adapter kind back
l / →	Cycle adapter kind forward
Tab / Enter	Advance to next field / submit
1 / 2 / 3	Toggle event flags (events step)
Esc	Cancel

Inbound tab

Shortcut	Action
j / ↓	Move cursor down
k / ↑	Move cursor up
Enter	Edit the selected field or toggle
Tab	Switch back to the Outbound tab
Esc / q	Close the overlay

Delete confirmation

Shortcut	Action
y	Confirm delete
n / Esc	Cancel

TUI — global settings

Opened with Ctrl+g. The overlay has a categories pane on the left and a fields pane on the right; Tab swaps between them.

Shortcut	Action
j / ↓	Move down
k / ↑	Move up
Tab / Shift+Tab	Swap between categories and fields
/	Open search
Space	Toggle a notification or boolean field
Enter	Drill into category / edit field / cycle default
Esc	Close overlay (or close search if open)

Search overlay (within global settings)

Shortcut	Action
(type)	Update search query
↑ / ↓	Move result cursor
Enter	Activate the selected result
Esc	Close search

GUI — window management

v8 "Inferno" made the GUI multi-window: a persistent home (mission control) window, one window per project, and an optional always-on-top mini-monitor. These bindings live in the app menu and work from any window. The mini-monitor is excluded from the window cycle.

Shortcut	Action
Cmd+N / Ctrl+N	Open or focus the home (mission control) window
Cmd+Shift+] / Ctrl+Shift+]	Cycle focus to the next open window
Cmd+Shift+[ / Ctrl+Shift+[	Cycle focus to the previous open window
Cmd+Shift+M / Ctrl+Shift+M	Open the always-on-top mini-monitor

GUI — dashboard

The dashboard exposes a small set of global shortcuts. Filter chips and the layout toggle are mouse-driven controls, but their selection persists across reloads via localStorage[wf-dashboard-filter] and localStorage[wf-dashboard-layout].

Shortcut	Action
Cmd+, / Ctrl+,	Open Settings

GUI — task workspace

Project View shortcuts. The integrated terminal toggle is global to the project view; the Inspect tab adds vim-style file navigation while it has focus.

Shortcut	Action
Cmd+</kbd> / <kbd>Ctrl</kbd>+<kbd>	Toggle the integrated terminal panel
Esc	Close any modal or slide-out panel

Inspect tab

Shortcut	Action
j	Move to next file in the diff
k	Move to previous file in the diff
/	Open the file filter
r	Refresh the diff
Esc	Close the file filter (when focused)

Markdown editor

The rich markdown editor (project definition, Add Project wizard, and the task modal's prompt / acceptance criteria fields) adds formatting keybindings.

Shortcut	Action
Cmd+B / Ctrl+B	Toggle bold
Cmd+I / Ctrl+I	Toggle italic

Settings search

The Global Settings view has its own keyboard search.

Shortcut	Action
Cmd+F / Ctrl+F	Focus the settings search input
↑ / ↓	Move through search results
Enter	Jump to the selected result
Esc	Clear the query · then blur the input

Beacon notification focus events

Beacon focus events are not keyboard-triggered. Click any OS toast or system tray Notifications submenu entry — the click routes through DaemonService.SubscribeFocusEvents to open or focus the originating project's own window (or the home window for global events and digests). See the GUI doc for the underlying flow.