One 1.3 MB binary. Zero config. Every project at your fingertips.
A Rust CLI that replaces 700 lines of shell scripts with a fast, atomic,
interactive project manager for Claude Code workspaces.
Type claude → pick a project → axon + tldr refresh → you're coding.
Pick a project. Code intelligence refreshes automatically. You're coding in under two seconds.
If you manage more than a handful of Claude Code projects, you know the pain: cd-ing into the right directory, remembering which project you touched last, manually refreshing code indexes, wondering if your registry JSON got corrupted by a half-written update.
Projectwise solves all of it:
| Problem | Projectwise |
|---|---|
| Hunting for project directories | FZF fuzzy picker with live preview |
| Stale code intelligence | Auto-refreshes Axon graphs + tldr indexes on every entry |
| Corrupted project registry | Atomic writes via tempfile + POSIX rename, with file locking |
| Phantom deleted directories | Integrity checker detects and repairs mismatches |
| 700 lines of fragile shell | Single 1.3 MB Rust binary, 0 compiler warnings |
git clone https://github.com/anoop-titus/Projectwise.git
cd Projectwise
cargo build --release
cp target/release/cpm ~/.local/bin/Add to your .zshrc or .bashrc:
eval "$(cpm shell-init)"Initialize the registry:
cpm registry initDependencies: fzf (required). Axon and tldr are optional -- Projectwise degrades gracefully without them.
claude # FZF picker → enters Claude Code in the selected project
cpm select # just the picker (returns folder name)
cpm select all # include archived projectsThe claude shell wrapper uses the same pattern as zoxide -- a thin shell function that calls the binary and cds the parent shell.
cpm list # Ratatui TUI with dark theme, alternating rows
cpm list favorite # favorites only
cpm list all # including archivedNavigate with j/k or arrow keys. Enter for details. q to quit.
cpm create # interactive creation with dialoguer prompts
cpm edit <folder> # edit name, description, category, status, tags, git link
cpm archive <folder> # soft-delete to archive directory
cpm restore <folder> # bring it back
cpm delete <folder> # permanent removal (requires 2 confirmations)cpm preview <folder> # styled terminal preview (powers the FZF preview pane)
cpm info <folder> # full JSON detailcpm registry add <folder> [name] # register a project
cpm registry remove <folder> # unregister
cpm registry list # list all folder names
cpm registry touch <folder> # bump last_accessed + session_count
cpm registry toggle-fav <folder> # toggle favorite star
cpm registry set-name <folder> <name> # rename
cpm registry set-status <folder> <s> # active / paused / archived
cpm registry set-tags <folder> <csv> # comma-separated tagscpm integrity check # show registry ↔ filesystem mismatches
cpm integrity repair # auto-fix: archive missing, add untracked
cpm cleanup prune --days 30 # remove stale .axon/.tldr caches
cpm cleanup report # per-project size breakdown| Key | Action |
|---|---|
Enter |
Select and enter project |
R |
Rename project |
F |
Toggle favorite |
Ctrl-D |
Archive project |
Esc |
Cancel |
eval "$(cpm shell-init)" # emits a ~25-line claude() shell wrapper
│
▼
cpm select # FZF picker with themed preview
│
▼
cpm pre-launch <folder> # background: axon analyze + tldr warm
│ # + registry touch + doc review prompt
▼
command claude "$@" # enters Claude Code in the project dir
Pre-launch runs code intelligence tools in background threads so they never block your workflow. Tools that aren't installed are silently skipped.
| Variable | Default | Description |
|---|---|---|
CLAUDE_PROJECTS_DIR |
~/.claude/projects |
Root directory for projects |
CLAUDE_ARCHIVE_DIR |
~/.claude/archive |
Archive directory |
PAGER |
less |
Pager for doc review |
src/
├── main.rs # clap CLI dispatcher + all command implementations
├── models.rs # Project, Registry, ProjectStatus, ListMode structs
├── registry.rs # CRUD, atomic writes (tempfile → rename), backup rotation
└── theme.rs # Ratatui dark theme: cyan / green / amber / gold
Design decisions worth noting:
- External fzf, not skim -- FZF keybindings shell out to
cpmfor mutations, then reload the list. This keeps the picker and the data layer cleanly separated. - Atomic writes -- every registry mutation writes to a tempfile in the same directory, then calls
fs::rename(POSIX atomic). No partial writes, ever. - Backup rotation -- the last 10 timestamped registry snapshots live in
.backups/. - Graceful degradation --
cmd_exists()checks before spawning axon, tldr, or claude-context. Missing tools are silently skipped.
cargo test # 7 unit tests: registry CRUD, sorting, favorites, set_fieldRatatui TUI table with dark theme and keyboard navigation. Interactive cpm edit via dialoguer. Cleanup commands. Themed FZF colors. claude-context integration. Zero compiler warnings.
Complete Rust rewrite. Single 1.3 MB binary (stripped + LTO). Atomic registry writes with backup rotation. Integrity checker. Background code intelligence refresh. 7 unit tests.
Original Bash implementation. Shell cleanup, dedup fixes, FZF keybinding wiring.
MIT -- see LICENSE.
Anoop Titus -- github.com/anoop-titus