A quick command to interactively filter and select a directory to cd into inside a
repo (or any folder with a .quickcdrc.json
file).
Note:
quickcd
was previously calledmonotab
, feel free to replacemonotab
withquickcd
in the demo above as the cli subcommands and behaviours are unchanged.
-
Quickly
cd
into any subproject directory inside a (mono)repo. -
Interactive directory picker with filtering.
-
Filter as first argument for faster filtering.
-
Automatic repo root detection (allow you to run
quickcd
from any nested directory inside monorepo) -
Automatically duplicate tab and
cd
for:- Gnome Terminal (Linux)
- Konsole (Linux)
- Terminal (MacOS)
-
Automatically picks up submodules and nested git repos.
-
Automatically picks up npm workspaces, yarn workspaces and pnpm workspaces.
-
Include any directory (even if they aren't submodules) via glob patterns.
-
Exclude any directory.
-
Automatically
cd
s if there is only one match.
Note: quickcd
works best with:
- monorepos that utilize npm/yarn/pnpm workspaces
- repositories with git submodules
npm install -g quickcd
# or with pnpm
pnpm add -g quickcd
Install bash/zsh aliases.
quickcd --setup --alias=quickcd,qcd
quickcd
uses mklement0/ttab
under the hood to create terminal tabs. As such the following
terminals are currnently supported on Linux and MacOS.
- Linux
- Gnome Terminal
- Konsole
- MacOS
- Terminal (not tested)
- iTerm2 (not tested)
- Windows Terminal Support
- Directory Labels
enquirer/enquirer has a hard time handling brackets as input.
CC0-1.0 (public domain)