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
F6to move to the next visible region. - Press
Shift+F6to move to the previous visible region. - On Apple keyboards where the function row controls hardware features, hold
Fnwhile pressingF6unless 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+F10on 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, andEndinside Chukke menus, thenEnterorSpaceto choose an action. - Press
Escapeto close a menu or cancellable dialog and return focus to its opener. TabandShift+Tabstay 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.