Keyboard
Shortcuts
Vim-style navigation, jump mode, and shortcut tables for every view.
Keyboard Shortcuts
Taskeract supports configurable keyboard shortcuts for common actions. The default modifier key is Cmd on macOS and Ctrl on Linux/Windows. Both the shortcuts and the modifier key can be customized in Configuration > Keybindings. Below are the default bindings.
Vim-style Navigation
All navigable views (Changes, History, Logs, Git History Viewer, Blame, Issues, PR Review) support vim-style motions with numeric prefixes. Type a number before a motion to repeat it — for example, 5j moves down five rows. Additional motions: gg jumps to the first row (or {n}gg to row n), G jumps to the last row (or {n}G to row n), 0 jumps to the first row, and % jumps to the line containing the matching bracket, parenthesis, or brace (in views with code content). The pending count is shown in the status bar as you type.
Global Shortcuts
| Action | Default Shortcut |
|---|---|
| New session | Mod+S |
| Scroll messages up | Mod+K |
| Scroll messages down | Mod+J |
| Jump mode | Mod+G |
| Open settings | Mod+, |
Jump Mode
Jump mode (Mod+G) acts as a leader key for quick keyboard navigation. Press a key to perform an action, or Esc to cancel. The panel shows which keys are active based on the current session state.
| Key | Action |
|---|---|
1–5 | Switch tab — 1 Chat, 2 Logs, 3 Changes, 4 History, 5 Review. Unavailable tabs appear dimmed. When viewing Issues, 1–9 switch to the corresponding status filter instead. |
0 | Open a system terminal in the session's working directory. |
\ | Toggle the Git History Viewer for the current project's repository. Press again to return to the previous session. |
6–9 | Launch a guest agent. Each configured terminal agent is assigned a number. Only shown when the primary agent is running. |
, | Push the session branch to the remote (hidden when no remote exists). |
. | Create PR (PR mode), Merge & Push (merge mode), or Merge to branch (no remote). |
' | Rebase onto the base branch (when behind). |
/ | Merge from the base branch (when behind). |
` | Switch project group. Opens a sub-picker listing your groups — press a letter to filter the sidebar, then continue in jump mode. Only available when sidebar grouping is enabled. |
; | Toggle the Issues view for the current project. Press again to return to the previous session. |
- | Toggle Project Properties for the current project. Press again to return to the previous session. |
[ | Toggle the PR thread bar sidebar. Only available when the current session is linked to a pull request and the Review tab is not active (the Review tab already shows threads inline). |
] | Toggle the issue sidebar. Only available when the current session is linked to an issue. |
= | Toggle the "Only mine" filter in the Issues view. Only available when viewing Issues. |
a–z | Jump to a session by letter. Letters are assigned to sessions in sidebar order. |
Git keys only appear for git-backed projects and are shown or dimmed based on the current state (e.g., Push is only active when there are commits ahead of the remote, and is hidden entirely for repositories without a remote).
Changes View Shortcuts
| Action | Default Shortcut |
|---|---|
| Navigate up / down | ↑ / k, ↓ / j (prefix with count, e.g. 5j) |
| First / last row | gg / G (or {n}gg / {n}G for row n) |
| Matching bracket | % |
| Focus file tree | ← / h |
| Focus diff viewer | → / l |
| Previous change | , |
| Next change | . |
| Visual mode | v |
| Copy to clipboard | Space / y |
| Find | / or Mod+F |
| Find next | n |
| Find previous | N (Shift+n) |
| Clear find | Escape |
| Exit visual mode | Escape |
History & Logs View Shortcuts
The History tab and Logs tab share the same navigation shortcuts:
| Action | Default Shortcut |
|---|---|
| Navigate up / down | ↑ / k, ↓ / j (prefix with count, e.g. 10j) |
| First / last row | gg / G (or {n}gg / {n}G for row n) |
| Visual mode | v |
| Copy to clipboard | Space / y |
| Find | / or Mod+F |
| Find next | n |
| Find previous | N (Shift+n) |
| Clear find | Escape |
| Exit visual mode | Escape |
| Switch tab (Logs only) | h / l |
Git History Viewer Shortcuts
The Git History Viewer supports vim-style navigation with a two-pane layout (commit graph and commit detail).
| Action | Default Shortcut |
|---|---|
| Navigate up / down | j / k (prefix with count) |
| First / last commit | gg / G |
| Focus graph pane | h |
| Focus detail pane | l |
| Search commits | / |
| Refresh | r |
| Visual mode | v |
| Copy to clipboard | Space / y |
| Close | Escape |
Within the detail pane:
| Action | Default Shortcut |
|---|---|
| Toggle file list / diff focus | Tab or Space |
| Switch Changes / Tree tab | h / l (file focus) |
| Toggle commit message | z |
| Open blame | Enter (file focus) |
| Open file history | Backspace (file focus) |
| Previous / next hunk | , / . (diff focus) |
| Find in diff | Mod+F (diff focus) |
| Matching bracket | % (diff focus) |
PR Review Shortcuts
The PR review view (standalone or embedded in the session Review tab) supports full keyboard navigation across its three panes.
| Action | Default Shortcut |
|---|---|
| Switch pane left / right | h / l (file list ↔ diff ↔ checklist) |
| Navigate files (file pane) | j / k (prefix with count, e.g. 5j) |
| First / last file | gg / G |
| Select file & open diff | Enter (file pane) |
| Scroll diff | j / k (diff pane) |
| Previous / next hunk | , / . (diff pane) |
| Toggle PR description | d (diff pane) |
| Navigate threads (checklist pane) | j / k (prefix with count) |
| First / last thread | gg / G |
| Open thread detail | Enter (checklist pane) |
| Mark thread as ready | r (checklist pane, open threads) |
| Resolve / sign off thread | o (checklist pane, open or ready threads) |
| Reject thread | x (checklist pane, ready threads) |
| Cycle filter tab | f (checklist pane, cycles All → Open → Ready → Done) |
| Submit comment or reply | Ctrl+Enter / Cmd+Enter |
| Close thread detail / description / view | Escape |
Issues View Shortcuts
The Issues view supports vim-style navigation with numeric prefixes.
| Action | Default Shortcut |
|---|---|
| Navigate up / down | j / k (prefix with count, e.g. 5j) |
| First / last issue | gg / G |
| View issue details | Enter |
| Focus search | / |
| Start or go to session | s |
| Close detail / close issues view | Escape |
Mod refers to Cmd on macOS and Ctrl on Linux/Windows. The modifier key itself can be changed in Configuration > Keybindings.