code-cli

Project session manager — select a repo, pick a worktree, launch tmux.

Usage

code-cli [PROJECT] [--clone <url>] [--create]

With no arguments, fzf opens over your project directories for interactive selection.

# Interactive picker
code-cli

# Open a project by name (exact or fuzzy match)
code-cli myproject

# Create a new project directory (when no match is found)
code-cli myproject --create

# Clone a repo and open it
code-cli --clone https://github.com/user/repo

# Clone with a custom directory name
code-cli myname --clone https://github.com/user/repo

If the selected project has multiple git worktrees, you'll get a second fzf prompt to pick one. The tmux session is then named repo/branch.

How It Works

1. Resolve a project directory from $XDG_SOURCE_HOME (default ~/.local/src)
2. If the project has multiple git worktrees, prompt to pick one
3. Create a tmux session (or attach to an existing one)
4. Optionally run a project-specific init script to set up windows/panes

Init Scripts

On new session creation, code-cli looks for a bash init script to bootstrap the tmux layout:

1. $TMUX_SCRIPT_HOME/<session> (or ~/.config/tmux/projects/<session>)
2. Falls back to $TMUX_SCRIPT_HOME/$TMUX_SCRIPT_DEFAULT (default name: general)

The script receives the session name as $1 and the TMUX_SESSION environment variable.

Environment Variables

Dependencies

• fzf
• tmux
• git

Testing

cargo test

Tests cover fuzzy matching, project resolution, worktree detection, and init script lookup. Git is required for the integration tests.

Install

cargo install --path .

Shell Completions

# Bash
code-cli --completions bash > ~/.bash_completion.d/code-cli

# Zsh
code-cli --completions zsh > ~/.zfunc/_code-cli

# Fish
code-cli --completions fish > ~/.config/fish/completions/code-cli.fish