Lacy

Features

Navigation without full path

You don't have to type the full directory name. Just make sure the path matches the directory name more or less.

# normal cd
cd /Users/timothebot/projects/lacy/src

# with lacy
y / user timo prj lacy sr
# or
y / usrs timbo rojt layc rc

Skipping directories

Forgot the directory name? No problem. Just skip it using -.

y / user timo - lacy sr

# as long as some parts are still unique, it will work
# ...and it's very fast
y / - - - lacy sr

Like cd

Everything you can do with cd, you can do with y.

y /Users/timo/Projects/Lacy/src
y ~
y ..

Real paths

You can also add real paths while lazy navigating.

y /Users/timo/ desk proj lacy/src

Getting started

Installation

Cargo (Universal)

cargo install lacy

Homebrew (macOS)

brew install timothebot/tap/lacy

Shell Setup

Zsh

# ~/.zshrc
eval "$(lacy init zsh)"

Bash

# ~/.bashrc
eval "$(lacy init bash)"

Fish

# ~/.config/fish/config.fish
lacy init fish | source

Other shells

Feel free to contribute the init script for your preferred shell.

FAQ

Why not z?

z is a great tool, but if you are working with a lot of projects with similar paths, it can be a pain to navigate. z also needs to learn first, while lacy can be used on systems you (or lacy) never touched before. You can use z alongside lacy.

Contributions

Feel free to open a PR for any type of changes!

AI notice

The code in this repository was written by hand. AI was used for the different shell configurations and helped with the Github actions.

Built with <3 by timothebot