Git and review

Branches, worktrees, the change review, pull and merge requests, and file history.

Rip reads your repository and shows it where you work. The status bar, the gutter, and a diff view built for review carry it.

The status bar#

The status bar shows the branch and the number of changed files. It names the worktree when the repository has more than one. It also shows how far the branch is ahead of or behind its remote. Its buttons open the change review, the pull requests, the worktrees, and the file history.

In the editor, the gutter marks added, changed, and deleted lines. ]Alt+] and [Alt+[ jump to the next or the previous change in the file.

Branches#

Press BCtrl+Shift+B. The picker lists the branches. Select one to switch to it. To create a branch, type its name and pick the Create branch row, which stays in the list.

Worktrees#

Press BCtrl+Alt+B. The worktree cockpit lists every worktree of the repository with its branch. ↩Enter switches the window to that worktree. ↩Ctrl+Enter opens it in a new window. RR reads the list again.

Review changes#

Press GCtrl+Alt+G. Rip opens Changes. Use the switch above the files to select All changes, Unstaged, or Next commit. Rip highlights the selected view. All changes shows the changes to tracked files. New files appear in Unstaged. The layout follows diff-layout. If you marked a baseline, Rip opens that comparison instead. The view has one-key commands:

Reviewed marks survive closing the view or Rip. When a hunk changes, Rip reopens it for review and keeps the other marks.

Hunk actions sit beside the selected hunk. File actions sit beside the file name. The View menu holds display options and their shortcuts. The repository tree tucks away while the review file list is open.

Undo keeps later edits to your files and index. If an edit conflicts with undo, Rip leaves the current contents intact and shows a message. Committing or switching branches ends undo for that change.

Stage the next commit#

Unstaged shows changes you have not added to the next commit. Next commit shows exactly what the commit contains. Stage or unstage a whole file from its header, or the selected hunk from its own row. A Partially staged label means the file has changes in both views. Switching views keeps your place in each one.

Marking a change reviewed leaves staging alone. After staging or unstaging, use Undo or ZCtrl+Z to reverse the action. Later edits stay intact.

Choose Commit…, enter a message, then commit. If a Git hook rejects it, Rip keeps the message and staged changes. Fix the problem, then retry.

Read the result#

Choose Read result to read a complete file, including unchanged functions. Gutter marks show where it changed. Hold BB to see the earlier version, then release to return. The same code stays near the top of the view across insertions and deletions. Search and copying work in both versions. Previewing does not edit files or stage changes.

Choose Diff to return to the split or unified comparison.

Review from a baseline#

Save your files, then press GCtrl+Alt+Shift+G to mark the state on disk as a baseline. Rip shows a message when the baseline is ready. From then on, GCtrl+Alt+G shows every change since the baseline, new files included, even across commits. New files that .gitignore names stay out. Run Workspace: Clear Baseline from the command palette to go back to reviewing uncommitted changes. Working with agents shows this in use.

Pull requests and merge requests#

Press RCtrl+Shift+R. The panel lists up to 60 open pull requests of the repository. On a GitLab project, it lists merge requests. ↩Enter opens one as a diff with its comment threads. RR reads the list again.

In the diff, NN and PP move between comments. CC starts a comment on the current line, and ↩Ctrl+Enter submits it. Comments stay pending until you submit the review with ↩Ctrl+Shift+Enter, where you approve or request changes. OO opens the request in the browser. The Checkout button checks out its branch.

Rip reads the origin remote to pick the host. A github.com remote uses GitHub CLI, so sign in with gh auth login first. A gitlab.com remote uses GitLab CLI, so sign in with glab auth login. A self-hosted name that contains github or gitlab works the same way. Rip follows SSH aliases and GitLab CLI's ssh_host mapping for a separate SSH host. For a host Rip does not recognize, set code-host.

On GitLab, your pending comments become draft notes and publish together as one review. Approve records an approval. Request changes sets your review state. Pipeline jobs appear as checks, and approvals set the review decision.

If Rip cannot find a CLI, set gh-path or glab-path to its executable. Then reload the configuration and refresh the list.

File history#

Press LCtrl+Alt+L to open the history of the current file. ←← and →→ move to an older or a newer commit, and HomeHome and EndEnd jump to the ends.

Keys#

Settings#