CLI Projects

Stop cd-ing around. Just type cj api and start coding.

A lightning-fast project switcher for AI coding assistants. Jump to any project and launch Claude, Aider, Cursor, or any tool — in one command.

Why?

You have 20 projects scattered across ~/dev, ~/work, and ~/experiments. You want to:

1. Get to a project fast
2. Launch your AI coding tool
3. Remember which tool each project uses

That's it. cliproj does exactly this — nothing more.

cj api          # cd to api project + launch claude
cj fo           # fuzzy match "family-office" + launch
cj -            # return to last project
cj              # interactive picker with search

Quick Start

npm install -g cliproj
cliproj-core setup    # configures your shell (adds cj alias)

Restart your terminal, then:

# Scan for all git repos in a directory
cj scan ~/dev

# Or add projects manually
cj myproject .              # add current directory
cj api ~/work/api-server    # add with explicit path

# Start jumping
cj api                      # boom, you're there

Features

| Command | What it does | |---------|--------------| | cj <name> | Fuzzy jump to project + launch tool | | cj | Interactive menu with search | | cj - | Jump to last project | | cj -- | Jump to previous project (2nd last) | | cj scan <dir> | Auto-discover git repos | | cj -p <name> | Pin project to top of list | | cj -y <name> | Toggle yolo mode (skip confirmations) | | cj -l | List all projects | | cj -e | Edit config in $EDITOR |

Per-Project Settings

Each project can use a different tool:

cj -e    # open config

{
  "settings": { "command": "claude" },
  "projects": [
    { "name": "api", "path": "~/work/api", "command": "aider" },
    { "name": "frontend", "path": "~/work/frontend" }
  ]
}

api launches Aider. frontend uses the default (Claude).

Yolo Mode

Skip all confirmations for trusted projects:

cj -y myproject    # toggle yolo mode

Appends the right flag automatically:

• Claude: --dangerously-skip-permissions
• Gemini/Codex: --yolo
• Aider: --yes

Fuzzy Matching

Uses fzf if installed (recommended), falls back to built-in fuzzy search.

cj ap        # matches "api" → jumps directly
cj a         # multiple matches → shows picker

Config Location

• Linux: ~/.config/cli-projects/config.json
• macOS: ~/Library/Application Support/cli-projects/config.json
• Windows: %APPDATA%\cli-projects\config.json

Requirements

• Node.js 18+
• Optional: fzf for better fuzzy matching

What This Tool Does NOT Do

• Not a file manager — only switches directories
• Not a session manager — no tmux, no persistent sessions
• Not an AI tool — just launches them

License

MIT