Quick Start
This walks through the everyday loop — see a change, stage it, commit it, push — so you learn the core keys by using them.
1. Open ichi
Section titled “1. Open ichi”From inside a repository:
ichiichi opens on the commit graph: your history, newest at the top. Move with j/k, jump to the top/bottom with g/G.
2. Jump to status
Section titled “2. Jump to status”Press s to open the status view. This lists your changed files, split between unstaged and staged.
- j/k — move between files
- Space — stage / unstage the selected file
- a — stage all, u — unstage all
- d — view the diff for the selected file
For finer control, the diff view lets you stage individual hunks (s) or even selected lines (Enter). See Staging & Committing.
3. Commit
Section titled “3. Commit”With your changes staged, press c to open the commit dialog. Type your message, then Enter to confirm (Esc cancels).
4. Push
Section titled “4. Push”Press : to open the command line and run :push.
ichi pushes the current branch to its remote. (:pull and :fetch work the same way.) See Push, Pull & Fetch.
5. Get around
Section titled “5. Get around”A few keys you’ll use constantly:
| Key | Action |
|---|---|
| g | Back to the commit graph (home) |
| s | Status |
| b | Branches |
| S | Stashes |
| p | Pull requests |
| : | Command line |
| Ctrl+P | Command palette |
| T | Theme selector |
| ? | Help |
| Esc | Go back |
| q | Quit |
That’s the whole loop. Next, see the full Keybindings & Commands reference, or dig into a feature.