TUI Controls
whispercom uses a full terminal UI built with Ink. Each screen has its own key bindings, shown in the hint bar at the bottom.
Commit Picker
Shown after AI generates suggestions. Navigate and confirm your commit.
| Key | Action |
|---|---|
↑ / k | Move selection up |
↓ / j | Move selection down |
1 – 9 | Jump directly to suggestion number |
Enter | Confirm and commit the selected message |
e | Edit the subject line of the selected suggestion |
c | Open the configure wizard to switch provider/model |
q | Quit without committing |
Editing a message
Press e to enter edit mode on the selected suggestion. The subject line becomes a text buffer:
| Key | Action |
|---|---|
| Any characters | Appends to the buffer |
Backspace | Deletes last character |
Enter | Saves the edit and exits edit mode |
Esc | Cancels the edit |
File Staging UI
Shown when you run whis --stage. Stage/unstage files before committing.
| Key | Action |
|---|---|
↑ / k | Move selection up |
↓ / j | Move selection down |
Space | Toggle staged/unstaged for the selected file |
Enter | Toggle staged/unstaged for the selected file |
a | Toggle all files (stage all or unstage all) |
c | Confirm staged files and proceed to commit generation |
q / Esc | Quit without staging |
Files are shown in two groups: staged (green) and unstaged (gray).
Commit Graph Browser
Shown when you run whis log.
| Key | Action |
|---|---|
↑ / k | Move selection up one commit |
↓ / j | Move selection down one commit |
PgUp | Go to previous page |
PgDn | Go to next page |
Enter / d | Show diff for the selected commit |
Esc / b | Go back to graph from diff view |
q | Quit |
Graph lines are colored by branch column. Ref badges (HEAD, remote branches, tags) are highlighted in distinct colors.
Branch Switcher
Shown when you run whis branch.
| Key | Action |
|---|---|
| Any characters | Filter branches (fuzzy match) |
Backspace | Remove last filter character |
↑ / Ctrl+K | Move selection up |
↓ / Ctrl+J | Move selection down |
Enter | Switch to the selected branch |
Esc / q | Cancel |
The current branch is marked with a ✔ and highlighted in green. Up to 20 results are shown; type more characters to narrow the list.
Configure Wizard
Shown when you run whis configure or press c in the commit picker.
| Key | Action |
|---|---|
↑ / k | Move up |
↓ / j | Move down |
Enter | Confirm selection / advance to next step |
Esc / q | Go back (on model step) or cancel (on provider step) |
Providers with a detected API key are shown with a ✔ checkmark. Providers with a missing key show a ⚠ warning but can still be selected.