Chukke documentation

Keyboard Shortcuts

Navigate Chukke windows, controls, documents, and Markdown commands without reaching for the pointer.

Chukke follows a consistent keyboard model across the main, Settings, and Help windows. Tab moves between meaningful controls, while arrow keys move inside a toolbar, tab strip, tree, or navigation list.

Arrow navigation begins when that control has focus. Use Tab or F6 to reach a region, or click one of its items before pressing an arrow key. In Settings, the initial focus is in Search settings, so press Tab once to reach the section list before using Up or Down. When search results are visible, use Tab or F6 to focus the first result; Up and Down then move through the result cards, and Enter or Space opens the focused setting. Clicking a result opens it directly.

Settings search also finds saved recipe names and configured model display names. Named results show their location under Assist → Recipes or Assist → Models. Selecting one scrolls to and focuses that item without running a recipe, switching models, or opening an editor. Names update as you add, rename, or delete items. Matching stays local to the loaded Settings data; recipe instructions, provider endpoints, credentials, and document contents are not searched.

Move between regions

  • Press F6 to move to the next visible region.
  • Press Shift+F6 to move to the previous visible region.
  • On Apple keyboards where the function row controls hardware features, hold Fn while pressing F6 unless macOS is configured to use the keys as standard function keys.
  • Use View → Focus or the Command Palette to focus a specific available region.

The main-window order is Activity Rail, left sidebar, document tabs, document toolbar, editor, Preview, Insights, and status bar. Hidden or unavailable regions are skipped. On Welcome, the Quick Actions region replaces the document surface.

When a workspace is open with no document selected, F6 also reaches the central start actions after the document toolbar. Focus Welcome Quick Actions in the Command Palette reaches either this list or the home page, whichever is visible.

Chukke region navigation works inside the app. The macOS Keyboard Navigation setting controls broader operating-system focus behavior and is separate from Chukke’s F6 navigation.

The teal focus boundary appears while you navigate with the keyboard. An actual mouse or trackpad click returns controls to pointer presentation; moving the pointer alone does not clear keyboard focus. Press Tab, F6, or another navigation key to show the keyboard position again.

Move within controls

Surface Keys Result
File Explorer, document, and selection toolbars Left / Right Move between available controls
Home-page action buttons Left / Right Move between Open Workspace, Open File, and Command Palette
Empty-document start actions Up / Down Move between Quick Actions, New File, New from Template, and Open Workspace
Recent workspaces and recent files on Home Up / Down Move between entries without opening them
Activity Rail Up / Down Move between visible actions
Document, Insights, and Model-ready tabs Left / Right Move to and activate the adjacent tab
File Explorer workspace heading Down Enter the first visible file or folder
File Explorer, Outline, and folder trees Up / Down Move through visible items
Focused File Explorer file or folder Command+C Remember the item for an in-workspace copy
Focused File Explorer folder, file, or workspace heading Command+V Copy into that folder, the file’s parent, or the workspace root
Outside an editor or text field after copying, renaming, moving, or moving an item to Trash Command+Z / Control+Z Run the available eight-second file-operation undo
Trees Right Expand a branch, then enter its first child
Trees Left Collapse a branch, then move to its parent
Settings sections and Help topics Up / Down Move focus without activating
Settings search results Up / Down Move focus without opening a result
Any composite control Home / End Move to the first or last available item

Press Enter or Space to activate the focused toolbar, rail, tree, Settings, or Help item. Tabs activate automatically as arrow focus moves. Tree typeahead is case-insensitive: type the first letters of a visible file, folder, or heading to focus it.

Use Tab or Shift+Tab to enter or leave the File Explorer toolbar. Left and Right move between enabled tools, including the closed Sort dropdown, and wrap at either end. On toolbar buttons, Home and End reach the first and last enabled tools; Enter and Space activate the focused button. Navigation alone does not create, rename, or delete anything.

File Explorer copy and paste use a Chukke-only session reference, not the macOS clipboard. Command+C applies only when a workspace file or folder has focus. Command+V uses a focused folder as the destination, a focused file’s parent folder, or the workspace root when the workspace heading has focus. The same actions are available as Copy, Paste, and Copy to… in File Explorer context menus. Editor and text-field clipboard shortcuts retain priority and continue copying and pasting text normally.

After a copy or Trash move, the success message includes Undo for eight seconds. Copy Undo removes the latest copied item only while its source and complete destination remain unchanged. Trash Undo restores only the exact item macOS moved, refuses to overwrite an occupied original location, and leaves changed or missing Trash items untouched. Finder’s Put Back remains available after the in-app Undo expires.

The native Sort dropdown keeps Up, Down, Home, and End for choosing options, along with its normal activation and cancellation keys. When its menu is open, use its native option-navigation keys. Elsewhere, arrow keys keep their normal meaning inside the Markdown editor, text fields, text areas, selects, editable content, and native menus.

Home and empty-document actions use Home / End for the first or last item and Enter / Space to activate. Tab / Shift+Tab move between groups and remember the last focused item. In a recent-items list, Right or Tab reaches the focused row’s separate Remove button; Left returns to the row, and Up / Down continue between entries. Clear remains a separate Tab stop. Removing a recent item changes only the recent-items list, not the underlying file or folder.

Context menus and dialogs

In the Command Palette, keep typing in the search field and use Up / Down to select a command, then Enter to run it. Keyboard navigation scrolls only the results list as needed to reveal the selected row. Mouse or trackpad scrolling stays where you leave it until the next arrow press. Changing the search or reopening the palette resets results to the top without changing the palette’s opening height.

  • Press Shift+F10 on a focused toolbar, rail, document tab strip, File Explorer workspace heading, file, folder, Outline entry, or status bar to open its context menu.
  • Use Up, Down, Home, and End inside Chukke menus, then Enter or Space to choose an action.
  • Press Escape to close a menu or cancellable dialog and return focus to its opener.
  • Tab and Shift+Tab stay within an open modal until it closes.

Documents and views

Action Shortcut
Previous document Command+Shift+[
Next document Command+Shift+]
Close active document Command+Shift+W
Close main window Command+W
Edit only Command+Control+1
Split view Command+Control+2
Preview only Command+Control+3
Open or close Model-ready Command+Shift+M
Files panel Command+1
Outline panel Command+2
Readiness Review panel Command+3
Hide sidebar Command+0
Toggle Insights Command+\
Command Palette Command+Shift+P

Press Command+Shift+W to close the active document while working in the editor, Preview, or another main-window region. Unsaved documents still ask for confirmation. When a document tab has focus, Delete or Backspace requests the same safe-close flow. Command+W closes the main window while keeping Chukke running; use Command+Q to quit the app.

The view shortcuts use Control (⌃), not Option (⌥), so the existing sidebar and heading shortcuts remain distinct. Document-view switching also works for individually opened files. The new document workflow shortcuts do not act behind an open modal dialog.

Editing and formatting

Action Shortcut
Save Command+S
Save As Command+Shift+S
Find Command+F
Open Settings Command+,
Bold Command+B
Italic Command+I
Link Command+K
Inline code Command+E
Code block Command+Shift+E
Heading 1 / 2 / 3 Command+Option+1 / 2 / 3
Numbered list Command+Shift+7
Bullet list Command+Shift+8
Quote Command+Shift+.

Inline code and Code Block use the same Markdown actions as the Format menu and toolbar. Formatting shortcuts apply in Edit or Split mode.

The Format menu and Command Palette list additional Markdown commands that do not yet have fixed shortcuts. Shortcut remapping is not included in this version.