CLI utilities for Claude Code workflow management.
brew tap nsheaps/devsetup
brew install claude-utils
| Command |
Description |
ccresume |
Shorthand for claude --resume |
cccontinue |
Shorthand for claude --continue |
ccr |
Resume with visual feedback |
ccc |
Continue with visual feedback |
| Command |
Description |
cc-tmp |
Create temporary workspace in /tmp (persists after exit) |
cc-newsession |
Create new workspace (use --temp to delete on exit) |
cc-resume |
Interactive picker to resume existing workspaces |
| Command |
Description |
claude-team |
Launch Claude with agent teams enabled (interactive mode picker) |
ct |
Shorthand alias for claude-team |
| Command |
Description |
claude-update |
Update claude-code via Homebrew |
claude-clean-orphaned |
Kill orphaned Claude processes (PPID=1) |
claude-diagnostics |
Capture diagnostics for troubleshooting |
# Quick resume/continue
ccr # Resume with visual feedback
ccc # Continue with visual feedback
# Workspace management
cc-tmp # Create workspace in /tmp (persists)
cc-newsession # Create persistent workspace
cc-newsession --temp # Create temporary workspace (deleted on exit)
cc-resume # Pick from existing workspaces
# Maintenance
claude-update # Update Claude Code
claude-clean-orphaned # Dry-run: show orphaned processes
claude-clean-orphaned --force # Actually kill orphaned processes
# Diagnostics
claude-diagnostics # Create diagnostic archive
claude-diagnostics -v # Print diagnostics to console
claude-diagnostics --no-archive # Print only, no archive
# Agent teams
claude-team # Interactive mode picker
claude-team --mode tmux # Tmux split panes
claude-team --mode in-process # In-process mode
ct --mode auto # Shorthand with auto mode
The cc-tmp command creates workspaces in /tmp/claude-workspace-<timestamp>:
- Workspaces persist after Claude exits (unlike the original shell function)
- Use
cc-resume to return to a previous workspace
- Use
cc-newsession --temp if you want auto-deletion on exit
fzf - For interactive workspace selection (installed automatically)claude - Claude Code CLI (must be installed separately)
# Install dependencies
yarn install
# Run tests
mise run test
# Check bash syntax
mise run lint
# Lint formula (requires rubocop)
mise run lint-formula
MIT