https://github.com/chmouel/chmoujump
FZF and ZSHZ cd jumper tool
https://github.com/chmouel/chmoujump
fzf-scripts zplug zsh
Last synced: 15 days ago
JSON representation
FZF and ZSHZ cd jumper tool
- Host: GitHub
- URL: https://github.com/chmouel/chmoujump
- Owner: chmouel
- License: apache-2.0
- Created: 2021-12-14T17:39:16.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-09-15T14:09:13.000Z (9 months ago)
- Last Synced: 2025-09-15T16:12:26.917Z (9 months ago)
- Topics: fzf-scripts, zplug, zsh
- Language: Shell
- Homepage:
- Size: 45.9 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Chmoujump 🚀
Chmoujump is a Zsh plugin that combines the power of [zsh-z](https://github.com/agkozak/zsh-z), your favorite directory paths, and custom aliases for fast directory jumping.
This project started as a simple function, but after discovering
[fzf-z](https://github.com/andrewferrier/fzf-z), it evolved into a more elegant
solution by merging ideas from both tools.
## Installation
With [zplug](https://github.com/zplug/zplug):
```sh
zplug 'chmouel/chmoujump'
```
Or use your preferred Zsh plugin manager.
## Usage
By default, Chmoujump binds to `C-g` and presents a list of recent directories
from zsh-z, combined with your favorite directories. You can define your
favorite directories using the `CHMOUJUMP_DIRS` environment variable:
```sh
export CHMOUJUMP_DIRS="/dir1 /dir2"
```
If not set, it defaults to `~/git`, or `$HOME` if `~/git` does not exist.
Chmoujump uses [fd](https://github.com/sharkdp/fd) to find the first two
subdirectory levels within your favorite directories. It leverages
[fzf](https://github.com/junegunn/fzf) for interactive selection and displays a
preview using [exa](https://the.exa.website/), or falls back to `ls` or `tree`
if `exa` is unavailable.
### Aliases
You can define directory aliases for quick access:
```sh
declare -A CHMOUJUMP_ALIASES=([fav]="$HOME/project/fav")
chmoujump fav
# ALIAS: $HOME/project/fav
```
### Options
- `-P`: Show a preview pane of the selected file or directory.
- `-f`: Use fuzzy search (default is exact match).
- `-p`: Print the path instead of changing directory.
- `-n`: Force using fzf search instead of zsh-z history.
- `-a`: Choose from aliases via fzf.
- `-A`: List aliases sorted by git index modification times.
## License
MIT