Skip to main content

cc

The fastest way to switch between Claude Code projects.

PyPI version Python License: MIT CI


Stop cd-ing around and typing claude over and over.
cc remembers every project you open and lets you jump back instantly.

$ cc
? Select a project to open in Claude Code:
> my-app          ~/code/my-app            (2 min ago)
  api-server      ~/code/api-server        (1 hour ago)
  dotfiles        ~/dotfiles               (3 days ago)

Install

pip install cc-claude

That's it. You now have the cc command.

Usage

Open a project (auto-tracked)

cc .                  # current directory
cc ~/projects/my-app  # any path

The first time you open a directory, cc remembers it.
Next time, just pick it from the list.

Switch between projects

cc

Arrow keys to navigate, type to filter, Enter to launch.
Projects are sorted by last access time — your most recent work is always on top.

Open by name

cc open my-app

Clean up

cc rm my-app   # stop tracking a project
cc purge       # remove all stored data

All Commands

Command Description
cc Interactive project selector, sorted by last access time
cc <path> Auto-track a directory and launch Claude Code there
cc list Same as cc — interactive selector
cc open <name> Open a tracked project by name
cc rm <name> Remove a project from tracking
cc purge Delete all stored data

How It Works

  1. You run cc . or cc ~/some/project — the directory is saved to a local JSON file and Claude Code launches
  2. You run cc — all saved projects appear in an interactive list, sorted by when you last opened them
  3. You pick one — Claude Code launches in that directory

Data is stored in your OS data directory (~/.local/share/cc-claude/ on Linux, ~/Library/Application Support/cc-claude/ on macOS, AppData\Local\cc-claude\ on Windows). Run cc purge to remove it.

Requirements

  • Python 3.8+
  • Claude Code CLI installed and available as claude

License

MIT

Metadata

Release files for cc-claude 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cc-claude 0.2.0
File Size Uploaded
cc_claude-0.2.0.tar.gz 8.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cc-claude 0.2.0
File Interpreter ABI Platform
cc_claude-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 18.3 kB

Release files / cc_claude-0.2.0.tar.gz

Download URL cc_claude-0.2.0.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
903ab38d4cd1f04f37433fc64d87610f1120f0ef2ced4fdbb2fc0622ddd1afce
BLAKE2b-256 checksum
How to use checksums
f46ac036261f0370c303662969e1ef2c2a76d7873588c4b440863780433d4257
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.

Transparency log

Release files / cc_claude-0.2.0-py3-none-any.whl

Download URL cc_claude-0.2.0-py3-none-any.whl
Size 9.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
faedd4b7b73dcb9353c7d980f76ce8a5c4feabb0036f94d60d1d5708f472ccbb
BLAKE2b-256 checksum
How to use checksums
0fbfce3f4599d55b12e37c90cd7b934a21a840cb0d5a78b5d129c4f1d984dffe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 16, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page