Getting started
Requirements
Section titled “Requirements”- Go 1.27+
- git 2.30+
- A terminal with truecolor
Mouse support and the kitty keyboard protocol are used where available. Without them things degrade cleanly.
Install
Section titled “Install”bubblegit is in early beta: it works, but commands and keybindings can still change between releases. The first tagged build is v0.1.0, marked a pre-release on GitHub.
go install github.com/f3xp/bubblegit/cmd/bubblegit@v0.1.0Or download an archive for your platform from the releases page, extract it, and put the bubblegit binary on your PATH. Checksums are in checksums.txt. The macOS binaries are unsigned, so Gatekeeper needs one pass through:
xattr -d com.apple.quarantine ./bubblegitOr run it from a clone of the repository:
go run ./cmd/bubblegitbubblegitRun it from anywhere inside a git repository.
The four views
Section titled “The four views”Each view is a pair of panes: the document on the left, the list on the right.
| Key | View |
|---|---|
1 |
Working tree: the diff of the selected file on the left, files on the right |
2 |
Log: the selected commit on the left, commits with a graph column on the right |
3 |
Branches: the tip commit of the selected branch on the left, local branches on the right |
4 |
Stashes: the selected stash’s patch on the left, the stash list on the right |
Moving around
Section titled “Moving around”| Key | Action |
|---|---|
j k |
move the cursor |
G home end |
jump to the ends |
ctrl+d ctrl+u |
half-page |
tab |
switch pane |
R |
re-read the view now |
? |
show every keybinding in a popup |
q ctrl+c |
quit |
The full list is on the keybindings page.