Skip to content

Latest commit

 

History

History
55 lines (45 loc) · 2.1 KB

README.md

File metadata and controls

55 lines (45 loc) · 2.1 KB
Logo

Quick navigation with minimal mental overhead.


Shunpo is a minimalist bash tool that tries to make directory navigation in terminal just a little bit faster by providing a simple system to manage bookmarks and jump to directories with only a few keystrokes. If you frequently need to use commands like cd, pushd, or popd, Shunpo is for you.

Powered by 🍵 Ko-fi Built With Nix Code Formatting Unit Tests

Requirements

Bash 3.2 or newer.

Installation

Run install.sh && source ~/.bashrc. For nix, click here.

Tutorial

Click here for a video tutorial.
Shunpo Demo

Commands

Bookmarking:

sb: Add the current directory to bookmarks.
sg, sg [#] : Go to a bookmark.
sr, sr [#] : Remove a bookmark.
sl: List all bookmarks.
sc: Clear all bookmarks.

Navigation:

sj, sj [#]: "Jump" up to a parent directory.
sd: "Dive" down to a child directory.

Selection:

0~9: Select an option.
n: Next page.
p: Previous page.
b: Move selection back to parent directory. (For sd only.)
Enter: Navigate to selected directory (For sd only.)

Uninstalling

Run uninstall.sh