A command template and snippet manager for Bash, Zsh, Fish, Nushell and PowerShell that works like IntelliSense for your terminal.
1.3K25RustApache-2.0Updated 7 days ago
egurapha/Shunpo
A minimalist bash tool for managing directory bookmarks and jumping between directories with a few keystrokes.
- Stars
- 447
- Forks
- 11
- Open issues
- 1
- Last commit
- 3 months ago
What is it?
Shunpo is a small bash tool for moving around the terminal faster. It lets you bookmark directories and jump to them with short commands, and it also provides interactive menus for jumping up to parent directories or diving down into child directories.
Bookmarks are managed with commands such as sb to add the current directory, sg to go to a bookmark, sr to remove one, sl to list them, and sc to clear them all. Navigation is handled by sj to move up and sd to move down, with numbered selection and paging in the menus.
The selection keys can be customized through a config file at ~/.config/shunpo/config, with the default set to digits 0-9. It requires Bash 3.2 or newer, is installed with install.sh, and can also be installed through Nix.
Key features
- 01Bookmark directories with sb and jump back with sg
- 02Move up to parent directories with sj
- 03Dive into child directories through an interactive menu with sd
- 04Customizable selection keys in a config file
- 05Works with Bash 3.2 or newer
Use cases
- Jumping between frequently used project directories in a terminal session
- Moving up several parent levels without typing repeated cd ..
- Replacing repeated cd, pushd and popd commands with bookmarks
Quick start
- 1
Run the install script from the repo
install.sh && source ~/.bashrc
Things to know
- Bash only; requires Bash 3.2 or newer.
- Nix users are pointed to a separate setup guide.
In collections
Topics
FAQ
- What is Shunpo?
- A minimalist bash tool for managing directory bookmarks and jumping between directories with a few keystrokes. Shunpo is a small bash tool for moving around the terminal faster. It lets you bookmark directories and jump to them with short commands, and it also provides interactive menus for jumping up to parent directories or diving down into child directories.
- Is Shunpo free to use? What license does it have?
- Shunpo is open source under the MIT license. Check the license terms before using it in commercial products.
- Is Shunpo still maintained?
- Updated within 6 months. The last commit to Shunpo was on Aug 3, 2026.
- What can I use Shunpo for?
- Jumping between frequently used project directories in a terminal session Moving up several parent levels without typing repeated cd .. Replacing repeated cd, pushd and popd commands with bookmarks
- How do I install Shunpo?
- Run the install script from the repo: install.sh && source ~/.bashrc
- Where can I get Shunpo?
- The source code and installation instructions are on GitHub: https://github.com/egurapha/Shunpo
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A community-driven framework for managing zsh configuration, bundling hundreds of plugins and themes plus an update tool.
190.1K29.4KShellMITUpdated yesterday
A community framework of Bash aliases, functions, completions, themes and scripts, managed through a single install and enable/disable system.
15.3K2.3KShellMITUpdated 2 days ago
A community-driven framework for managing your bash configuration, with bundled plugins, themes, and a self-update command.
7.8K791ShellMITUpdated 4 days ago
A smarter cd command that learns your most-used directories and lets you jump to them with a few keystrokes, across all major shells.
40.2K933RustMITUpdated 5 days ago
A general-purpose command-line fuzzy finder that filters any list of input and turns shell scripts into interactive terminal selectors.
83.7K5.4KGoMITUpdated 22 hours ago