Skip to content

Your first review

Read a change, accept part of it, and commit — in five minutes.

This is the whole loop, once. Run stage in a repository that has uncommitted changes.

cd ~/code/my-project
stage

The files panel lists the changed files. Press 2 to focus it, then j and k to move. The pane on the right shows the diff of the file under the cursor.

Press 0 to move into the diff, and j and k to scroll it. Press esc to go back to the panel.

Press w to put the cursor on a name, and g to open the file that defines it. Press shift+tab to come back.

This needs a language server for the language. Read Navigating with LSP.

  1. Press v to start the line cursor.
  2. Move to the line with j or k.
  3. Press c, type the comment, and press ctrl+s.

The comment stays in the diff, at the line. Read Review comments.

Press esc to return to the files panel, then enter on a file to open the staging editor.

Keys Action
a, then space Stage the hunk under the cursor
v, j, then space Stage the lines you select
esc Leave the editor

Read Staging.

Press c, type a message, and press ctrl+s. The title of the editor counts the files you are committing.

Read Commit and amend.

Press # to open the review list, then s to send the comments to the agent beside you.

With no agent terminal, press y to copy the review and paste it wherever the agent runs. Read Terminal integrations.

  • Panels, modes and contexts explains why a key does one thing here and another thing there.
  • Press ? in the app for every key of wherever you are standing.