Find Project (fp)

A small utility to quickly change project directory on the command line.

It is heavily inspired by telescope-project.nvim (in fact it even uses the same fuzzy search algorithm) with my theme vim-enfocado.

Why

I want:

• something easy, fast, and no setup (or as little as possible)
• something simple overall, meaning no SQL database or tracking project navigation ...
• to search through project, not through recent directories
• possibly a telescope.nvim-like interface

Most other project/workspace switcher do not meet that. It's also a good excuse to use ratatui.

Install

cargo install --git https://github.com/Valentin271/fp
echo "alias fp='cd \$(command fp)'" >> ~/.profile # or .bash_aliases or whatever else your shell uses

Functioning

Currently fp searches for projects in $HOME, ignoring hidden directories and build/dependency directories like node_modules, target, cmake* and more.

Preview

File listing is similar to running:

ls -1 -A --group-directories-first

It also uses your LS_COLORS.

TODO

In no particular order

• implement projects cache
• configurable search path
• display filtered entries / total just like telescope
• configurable whitelist
• configurable blacklist?