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
/	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 — 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)

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 bring the connected GUI to the originating project, task, or digest. See the GUI doc for the underlying flow.