cc-picker
Explain it

A project launcher for Claude Code on Linux

Every project gets its own drawer.

Pick a folder from a list, and Claude Code starts right inside it – with that project as its working folder, instead of wherever your terminal happened to be.

Lists ~/claude-projects, recent first, opens a terminal in the chosen folder and starts claude there. Pure Bash; zenity, kdialog or yad for the window.

← pull out a folder to try it

(demo – nothing is launched)

See it in action

Real recording: select my-app in cc-picker; a terminal opens and Claude Code starts in that project.

Why bother?

Claude Code treats the folder it starts in as your project. Starting it in the right one should take one click.

claude operates on its working directory. cc-picker turns that directory into a deliberate choice.

Without cc-picker

  1. Open a terminal
  2. Remember where the project lives
  3. Type the path to get there
  4. Start Claude Code – and hope it's the right folder
$ cd ~/code/clients/acme/webapp   # or was it ~/dev?
$ claude
# …or forget the cd and start in ~

With cc-picker

  1. Click the icon
  2. Pick the project – recent ones are on top
  3. Claude Code is running in the right folder
$ cc-picker
# pick → terminal opens in ~/claude-projects/<name>
#      → exec claude
$ cc-picker -c webapp   # or straight in, continuing

What it does

Three things, done well.

One Bash script. No framework, runtime service or background daemon. Uses standard Linux tools and your existing Claude Code installation.

Pick

A list of your projects. The ones you used lately sit on top, with “2 h ago” or “yesterday” next to them.

Recent list in ~/.local/state/cc-picker/recent (max. 50), pinned projects first. Deleted folders are skipped, hidden ones aren't listed.

…or create

Starting fresh? Type a name and pick a template if you like. Code already online? Paste its address and it's downloaded for you.

Name validation (no /, no leading ./-). Optional git clone with a progress dialog; failures show git's reason and leave no empty folder.

Start

A terminal opens in that folder with Claude Code already running. Quit Claude, and you're still in the right place.

Commands are %q-quoted; works with gnome-terminal, konsole, xfce4-terminal, alacritty, kitty and xterm.

And a few more handy things

New in version 0.3 – everything optional, nothing gets in your way.

New in 0.3.0. All of it configurable in ~/.config/cc-picker/config.

Pick up where you left off

Worked on the project before? Start fresh, continue your last conversation with Claude, or pick an earlier one.

Asked only if the project has sessions: new, claude --continue or --resume. Skip it with -n/-c/-r or CC_PICKER_SESSION.

Find it fast

Lots of projects? Type part of the name to filter the list. Or skip the list: cc-picker notes starts right in “notes”.

Text filter in the menu, fzf if installed. cc-picker NAME takes a unique prefix; cc-picker - opens the last project.

See where you stand

For projects under version control, the list shows the branch and how many files you've changed – before you start.

git status --porcelain -b per repo, 2 s timeout, no lock files. Off with CC_PICKER_GIT_STATUS=0.

Favourites & more folders

Pin the projects you use most – they stay on top. Projects spread over several folders? Show them all in one list.

Pins in ~/.local/state/cc-picker/pinned. CC_PICKER_BASE=~/claude-projects:~/code – new projects go into the first folder.

Start with a template

New projects can start from a template – for example with notes for Claude about the project already in place.

Folders in ~/.config/cc-picker/templates/; {{PROJECT_NAME}} is filled in, then git init. Ships with CLAUDE.md + .gitignore. Cloning takes user/repo.

Tidy up & stay current

Open a project in your file manager or editor, rename it, or put it away in the archive – nothing is deleted. Updates take one command.

“Manage projects” in the list: xdg-open, CC_PICKER_EDITOR, rename, archive to .archive/ and restore. cc-picker --update installs the newest release.

Two ways to choose

Click through a window, or type a number – whatever feels natural.

The window is the default; --shell-mode or CC_PICKER_MODE=shell for the menu. The installer offers to add a missing dialog tool. If it remains unavailable, normal launches use the menu without asking again.

The cc-picker window: a list of projects with a “Last used” column and Start and Cancel buttons
The window. Opens when you click the icon in your app menu.
The window. zenity (GNOME), kdialog (KDE) or yad – whichever is installed. Real screenshot, zenity 4.
$ cc-picker --shell-mode

  1) ★ my-webapp   (2 h ago · main)
  2) api-server   (yesterday · dev · 3 changed)
  3) notes-app   (5 days ago)
  4) + Create new project
  5) ⚙ Manage projects …
#? api
The menu. For people who live in the terminal – or work on another computer over the network.
The menu. Runs in place: a number picks, text filters, fzf takes over if installed; Ctrl+D quits with exit code 0.

Install it

  • You need:
  • Linux
  • Bash ≥ 4
  • Claude Code
  • a desktop for the window (optional)

Arch Linux: fully tested by the maintainer on their own system. Debian: confirmed in use. Ubuntu: automated functional tests (no full desktop test). Linux Mint, Manjaro, Fedora and openSUSE: expected to work with the required dependencies, but not yet verified separately.

Open a terminal, paste these two lines one after the other and press Enter each time. Done.

Installs into ~/.local – no root needed.

git clone https://github.com/bruneler/cc-picker.git
cd cc-picker && ./install.sh
  • Adds cc-picker to your app menu, with its own icon~/.local/share/applications/cc-picker.desktop + icon
  • Makes the cc-picker command work in any terminalAdds ~/.local/bin to PATH for bash, zsh, fish or ~/.profile – once
  • Checks that everything it needs is thereclaude, a terminal emulator, git, a dialog tool
  • If window support is missing, the installer offers to install it, shows the command first and asks for your approval. If you decline, the terminal menu remains available.Missing dialog tool: offers kdialog on KDE or zenity elsewhere; displays the package command and asks before running it.

Good to know

Is this made by Anthropic?

No. cc-picker is an independent community project. It simply starts the official claude program in a folder you choose.

Does it send anything anywhere?

The installed launcher has no telemetry and keeps settings and recent projects locally. Cloning, updates, package installation and Claude Code can use the network. This website separately uses Matomo only with your consent. See our privacy notice below.

Does this keep Claude Code away from my other files?

No – and that's worth knowing. The start folder is where Claude Code works by default, not a security boundary: depending on its permissions it can still read, change or run things elsewhere. What Claude Code may do is set by its own permission settings, and cc-picker doesn't change them.

Do I need to know my way around the terminal?

Only for the two install lines. After that, cc-picker lives in your app menu and works with clicks.

Where do my projects live?

In ~/claude-projects by default. To use another folder, write CC_PICKER_BASE=~/somewhere/else into ~/.config/cc-picker/config. Several folders work too, separated by :.

Mac or Windows?

Not at the moment – cc-picker is made for Linux with Bash. See the distribution test status in the installation section. The window uses zenity, kdialog or yad; terminal mode needs no desktop.

How do I update?

Run cc-picker --update. It installs the newest version if there is one, and keeps your settings, templates and project list.

How do I remove it?

Delete three files: rm ~/.local/bin/cc-picker ~/.local/share/applications/cc-picker.desktop ~/.local/share/icons/cc-picker.svg. Your projects stay where they are.