We will go over each of the left panels. Now is a good time to remember that you can press 1-5
to move focus to specific panels.
* - Each panel has many actions available. I’m only going to list the most notable ones. You can press ?
to see all the actions available on the panel you are in.
1. Status
The top-left most panel. This panel shows you the git repo you are in, the current branch, and the overall status of your repo.
-
↑
- number of commits ahead of remote- mnemonic: How many commits can I push up into the cloud above me?
-
↓
- number of commits behind remote- mnemonic: How many commits can I pull down from the cloud above me?
-
#screenshot of panel 1 with commits ahead and behind
Actions*
2. Files
This panel is like git status
in that it shows the modified files in your working directory.
It shows a list of files that have changes which have not yet been commited to the repo.
Legend
- color - indicates the status of the file
red
- unstagedgreen
- staged
- Status code
?
- untracked- ‘A’ - added
- ‘M’ - modified
- ‘D’ - deleted
Actions*
This panel is useful for staging, unstaging, and committing files.
Default Action
The default action (spacebar
) will toggle the staged status of the file.
3. Local branches
This panel shows you:
*
- (topmost line) the currently checked out branch- the most recent branches
- the status (
↑
/↓
) relative to the remote branch - #screenshot of panel 3 with commits ahead and behind
Actions*
This panel is useful for checking out branches.
Default Action
The default action (spacebar
) will checkout the branch. Panel “4. Commits” will change to show the commits on that branch.
Drill-down
If you want to look at the commits on a branch, without checking it out, you can press enter
to “drill-down” into the branch.
The panel will change to show you the commits on that branch. If you “drill-down” into a commit, the panel will change to show you the files that were changed in that commit.
- #screenshot of panel 3 “drill-down”-ed into the commits. Show how this is different from panel 4.
4. Commits
This panel shows the commits, for the currently checked out branch, with most recent first.
- #screenshot of panel 4
Actions*
Default Action
The default action (spacebar
) will checkout the commit.
- #describe how the other panels react to this action
5. Stash
This panel shows the stash stack, with most recent first.
- #screenshot of panel 5
Actions*
Default Action
The default action (spacebar
) will apply the stash.
- #describe how the other panels react to this action