Skip to content
leo-cli Documentation

Getting Started

Install

Section titled “Install”

Download the binary for your platform from GitHub Releases, rename it to leo (leo.exe on Windows), and put its directory on PATH.

macOS / Linux:

Terminal window
chmod +x leo-TAG-darwin-arm64
mv leo-TAG-darwin-arm64 ~/bin/leo

You can also build from source:

Terminal window
make build

The output is bin/leo.

Build Your First SQL IN List

Section titled “Build Your First SQL IN List”

Copy values separated by commas or whitespace, then run:

Terminal window
leo join

You can also pipe values directly. Piped input takes priority over the clipboard:

Terminal window
seq 1 10 | leo join

Choose an output format and press Enter to copy the result. See Build SQL IN Values for more input methods and interactive keys.

Create The First Index

Section titled “Create The First Index”

The default configuration scans ~/work. Create the local repository index, then open the picker:

Terminal window
leo repo reindex
leo repo

Press / to enter filter mode and type a query. Press Up/Down to apply the filter, then use Up/Down or j/k to move through results. Press Enter to print the selected repository’s absolute path. Esc clears an active filter first and quits when no filter is active; Ctrl-C always cancels.

Enable Shell Jumps

Section titled “Enable Shell Jumps”

leo shell init prints its integration script to standard output. Use eval to define the repo function in the current shell:

Terminal window
eval "$(leo shell init zsh)"

For bash:

Terminal window
eval "$(leo shell init bash)"

Add the matching command to ~/.zshrc or ~/.bashrc. You can then run repo to select a repository and change directory. Continue with Navigate Repositories or browse the command reference.