Keybindings

ProGit’s TUI (GroGit) is designed for keyboard-first navigation. All actions are accessible without touching the mouse.

Global Keys

These work from anywhere in the TUI:

Key	Action
?	Show help
q	Quit (or close current panel)
Esc	Cancel / Go back
:	Open command palette
Ctrl+r	Refresh all views
Ctrl+s	Sync with remote
1-9	Switch to panel 1-9

Navigation (Vim-Style)

        k (up)
            ↑
h (left) ← → l (right)
            ↓
        j (down)

Key	Action
j / ↓	Move down
k / ↑	Move up
h / ←	Move left / Collapse
l / →	Move right / Expand
g	Go to top
G	Go to bottom
Ctrl+d	Half page down
Ctrl+u	Half page up
Ctrl+f	Page down
Ctrl+b	Page up

Panel Shortcuts

Key	Panel	Description
i	Issues	Issue tracker
k	Kanban	Kanban board
s	Sprint	Sprint planning
b	Branches	Git branches (virtual + regular)
g	Git	Git status / diff
a	AI	AI agent panel
p	Plugins	Plugin manager
c	Command	Command palette
d	Dashboard	Overview dashboard

Issue Panel (i)

Key	Action
n	New issue
e	Edit issue
d	Delete issue
Enter	Open issue details
Space	Toggle selection
l	Add label
a	Assign to user
m	Move to sprint
/	Search issues
f	Filter issues
s	Sort issues
v	View modes (list/kanban/detail)

Kanban Board (k)

Key	Action
h / l	Move between columns
j / k	Move between cards
H	Move card left
L	Move card right
J	Move card down
K	Move card up
n	New card
e	Edit card
d	Delete card
c	Card details
1-9	Jump to column N

Example Workflow

You: i (open issues)
     j (select issue)
     k (open kanban)
     L (move to "In Progress")
     q (quit kanban)
     b (open branches)
     v (create virtual branch)
     :quit (exit)

Git Panel (g)

Key	Action
s	Stage file
u	Unstage file
d	View diff
c	Commit
a	Commit —amend
p	Push
P	Pull
f	Fetch
b	Checkout branch
m	Merge
r	Rebase
z	Stash
Z	Pop stash

Sprint Panel (s)

Key	Action
n	New sprint
e	Edit sprint
d	Delete sprint
S	Start sprint
C	Complete sprint
a	Add issues to sprint
r	Remove issues from sprint
v	View velocity chart
b	Burndown chart

Branch Panel (b)

Key	Action
n	New branch
d	Delete branch
D	Force delete
m	Merge branch
r	Rebase branch
v	Create virtual branch
V	Commit virtual branch
s	Switch to branch
t	Toggle branch type (local/remote/virtual)

AI Panel (a)

Key	Action
i	Input prompt
r	Run last prompt
s	Select model
h	View history
c	Clear conversation

Command Palette (: or c)

The command palette provides fuzzy search for all commands:

┌─ Command Palette ──────────────────┐
│  > create issue                    │
│                                    │
│  ❯ issue create                    │
│    issue create --label=bug        │
│    sprint create                   │
│    kanban create                   │
│                                    │
└────────────────────────────────────┘

Type to filter, Enter to execute, Esc to cancel.

Custom Keybindings

Customize keys in .project/config.toml:

[keybindings]
# Override defaults
quit = "Q"              # Shift+Q to quit
new_issue = "N"         # Shift+N for new issue
search = "?"            # ? for search

# Custom shortcuts
open_dashboard = "D"
sync_now = "S"

Mouse Support

ProGit supports mouse interactions:

[ui]
mouse = true

Action	Mouse
Click	Select item
Double-click	Open/Execute
Right-click	Context menu
Scroll	Navigate list
Drag (kanban)	Move card

Help System

Press ? anywhere for context-sensitive help:

┌─ Help: Issue Panel ──────────────────┐
│                                      │
│  Navigation                          │
│    j/k     Move down/up              │
│    h/l     Previous/next panel       │
│    g/G     Go to top/bottom          │
│                                      │
│  Actions                             │
│    n       New issue                 │
│    e       Edit issue                │
│    d       Delete issue              │
│    Enter   Open details              │
│                                      │
│  Press any key to close...           │
└──────────────────────────────────────┘

Cheat Sheet

Print a quick reference:

progit help keybindings

Or view in TUI:

progit tui
# Press ? then select "Print Cheat Sheet"

Next Steps

• Commands Reference
• Customization
• Configuration