Skip to content

A minimalist bash tool that makes directory navigation just a little bit faster.

License

Notifications You must be signed in to change notification settings

egurapha/Shunpo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

A minimalist bash tool that makes directory navigation just a little bit faster.

Resources

License

Stars

Watchers

Forks