Leadr

Leadr is a customizable CLI shortcut manager inspired by the leader key concept in (Neo)Vim. Use memorable key sequences to quickly execute or insert commands in your terminal.

⚡️ Requirements

• bash or zsh
• crossterm compatible terminal (see their Readme for a list)

Note: leadr works best inside a tmux session since it can utilize tmux's send-keys to execute commands. Outside of tmux, leadr will fallback to eval and manually appending the command to the shell's history.

📦 Installation

curl -L https://github.com/ll-nick/leadr/releases/latest/download/leadr -o ~/.local/bin/leadr
chmod +x ~/.local/bin/leadr

cargo install leadr

git clone https://github.com/ll-nick/leadr.git
cd leadr
cargo install --path .

🐚 Shell Integration

To use leadr, simply add the following line to your shell configuration file (e.g. ~/.bashrc or ~/.zshrc):

# For bash
source <(leadr --bash)

# For zsh
source <(leadr --zsh)

🛠️ Configuration and Usage

leadr will automatically create a configuration file and fill it with some default shortcuts the first time you run it. See confy's Readme for the location of the configuration file.

For a list of all available commands, run:

leadr --list

With the default config, you can e.g. execute git status by pressing <Ctrl-Space> followed by gs. Similarly, you can pre-populate git commit -m " by pressing <Ctrl-Space> followed by gc.

Modify the configuration file to add your own shortcuts or adjust the leadr keybinding. For a list of currently supported keybindings, see src/keymap.rs.