https://github.com/tombruijn/peak
A little utility to navigate Git branches, quickly switch between them, and when you're done with them, delete them.
https://github.com/tombruijn/peak
git terminal tui
Last synced: about 1 month ago
JSON representation
A little utility to navigate Git branches, quickly switch between them, and when you're done with them, delete them.
- Host: GitHub
- URL: https://github.com/tombruijn/peak
- Owner: tombruijn
- License: mit
- Created: 2025-09-14T21:16:54.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T20:40:04.000Z (3 months ago)
- Last Synced: 2026-04-21T22:34:51.086Z (3 months ago)
- Topics: git, terminal, tui
- Language: Rust
- Homepage:
- Size: 154 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Peak
Welcome to Peak! A little utility to navigate Git branches, quickly switch between them, and when you're done with them, delete them.
## Installation
TODO
## Usage
In a repository run Peak by running the `peak` command.
Then, in Peak, use the following features:
- [Switch to a branch](#switch-to-a-branch)
- [Filter branches](#filter-branches)
- [Display remote branches](#display-remote-branches)
- [Delete branches](#delete-branches)
- [Get help](#get-help)
### Switch to a branch
To switch (checkout) to a branch using Peak, navigate to the branch you want to check out with the arrow keys, or the `j` key for down and the `k` key for up (VIM keybindings).
Press `Enter` to switch to the selected branch.
### Navigate to a branch
Use the arrow keys, `j`, or `k`, to scroll the list of branches one line at a time.
To jump half the screen up and down in the list, use `ctrl + u` and `ctrl + d`.
### Filter branches
To filter the list of branches, use the following steps:
- Press `f` or `/` to open the filter.
- Enter the characters which you want to filter on, for example `feature/`, and press `Enter` to confirm.
- To reset the filter, press `R`.
### Display remote branches
To also list the known remote branches, since the last fetch, press the `t` key to 'toggle' the types of branches listed.
### Delete branches
To delete branches, use the following steps:
- Press `x` to mark a branch for deletion.
- Then press `d` to delete them. You'll be asked to confirm before they're deleted.
### Get help
- To see a reference of key mappings press `h` for the help screen.
- Press `Esc` or `q` to return to the main view.
## License
Copyright (c) Tom de Bruijn
This project is licensed under the MIT license ([LICENSE] or )
[LICENSE]: ./LICENSE