CCGears – .claude 폴더 관리자, Venv의 Claude Code용

Dynamic Preset Loader for Claude Code ___ ___ ___ / __|/ __|/ __|___ __ _ _ _ ___ | (__| (__| (_ / -_) _` | '_(_-\bin\ ) - Or add the extracted folder to your PATH via System Settings > Environment Variables - Open a new terminal and run ccgears version git clone https://github.com/MrYanMYN/CCGears.git cd CCGears go install ./cmd/ccgears The binary is installed to ~/go/bin/ccgears . Make sure it's in your PATH: # Add to ~/.zshrc or ~/.bashrc export PATH="$PATH:$HOME/go/bin" Navigate to a project that has a .claude/ directory: cd ~/projects/my-infra-project ccgears Select Create new preset + at the bottom of the menu, enter a name like infra-tools , and an optional description. CCGears snapshots your current .claude/ , tools/ , and CLAUDE.md into ~/.ccgears/presets/infra-tools/ . Navigate to any project directory and load the preset: cd ~/projects/different-project ccgears Highlight a preset with arrow keys, press Enter to preview, then Enter again to load. Your .claude/ and tools/ are replaced with the preset's contents. The previous state is backed up automatically. After loading, press Enter to launch Claude Code directly, or q to return to the menu. Select Scan & import at the bottom of the menu, enter a root directory (e.g. ~/Documents ), and CCGears will find all projects with Claude Code configurations. Use Space to toggle which ones to import, then Enter to confirm. While working in a Claude Code session, type: /ccgears This automatically exits the session, opens CCGears to pick a new preset, and resumes the same conversation after loading. No manual steps needed. ccgears Launches the preset-centric TUI: Presets ▸ frigate Imported from ~/Documents/ArguFrigate/frigate 2 days ago testmaker Imported from ~/Documents/Hobby/TestMaker just now watermelon Creative pipeline config 1 week ago ──────────────────────────────────────────────────────────────────────── ⟳ Scan & import + Create new preset Enter load s save r rename d delete u undo p preview q quit Your presets are the main menu. Use hotkeys to act on the highlighted preset: | Key | Action | |---|---| Enter | Load the preset (preview first, then confirm) | s | Save current project state to this preset | r | Rename this preset | d | Delete this preset (type name to confirm) | p | Preview this preset (skills, tools, permissions) | u | Undo last load (works from anywhere) | ↑↓ / j/k | Navigate | q / Esc | Quit | After loading a preset, CCGears launches claude as a subprocess. CCGears stays alive in the background — when Claude exits, CCGears can reopen for another preset switch. For scripting and shell aliases: # Load a preset directly ccgears load infra-tools # Save current state to the active preset ccgears save # Rename a preset ccgears rename old-name new-name # List all presets ccgears list # List as JSON (for scripts) ccgears list --json # Show help ccgears help Two slash commands are available inside any Claude Code session: | Command | What it does | |---|---| /ccgears | Switches presets. Auto-exits Claude, opens CCGears TUI, resumes the session after loading a new preset. | /ccgears-save | Saves current .claude/ and tools/ state back to the active preset. Runs inline — no session exit needed. | These commands auto-execute without permission prompts. The /ccgears and /ccgears-save skills are automatically injected into every loaded preset, so they persist across switches. # Add to ~/.zshrc alias cc-infra="cd ~/projects/infra && ccgears load infra-tools && claude" alias cc-creative="cd ~/projects/creative && ccgears load watermelon && claude" When launched interactively, CCGears acts as a parent process that manages Claude Code sessions: ┌──────────────────────┐ │ CCGears TUI │ │ Pick & load preset │ └──────┬───────────────┘ │ Enter ▼ ┌──────────────────────┐ │ Claude Code │ │ (subprocess) │ │ │ │ /ccgears ──────────┤──▶ touches marker │ auto-exits │ & kills claude └──────┬───────────────┘ │ CCGears detects marker │ ▼ ┌──────────────────────┐ │ CCGears TUI │ │ Pick new preset │ └──────┬───────────────┘ │ Enter ▼ ┌──────────────────────┐ │ Claude Code │ │ --resume │ │ (same conversation)│ └──────────────────────┘ Key behaviors: - CCGears stays alive while Claude runs as a subprocess - Session continuity — after switching, claude --resume picks up the exact conversation - Clean exit — if you /exit Claude normally (without/ccgears ), CCGears exits too - SIGINT isolation — CCGears ignores Ctrl+C signals from the /ccgears skill so it survives - Highlight a preset and press Enter - Preview its contents — skills, permissions, tools, CLAUDE.md headline - Press Enter to confirm — current .claude/ andtools/ are backed up, then replaced - Press Enter to launch claude , or q to return to the menu Hover over a preset and press s to save the current project state to it. Shows a diff summary before confirming: Changes to infra-tools: + tools/new_script.py (added) ~ .claude/settings.local.json (modified) - tools/old_script.py (removed) 2 unchanged Hover over a