cc-configs

Deploy levx's Claude Code global settings to any machine in seconds.

A Claude Code plugin that interactively installs rules, hooks, and settings into ~/.claude.

한국어 문서 →

---

Installation

As a Claude Code plugin (recommended)

Inside Claude Code:

/plugin marketplace add https://github.com/levx-me/cc-configs
/plugin install cc-configs@levx-me
/cc-configs:install

Select the components you want — they get deployed to ~/.claude automatically.

---

Manual install

git clone https://github.com/levx-me/cc-configs
cd cc-configs
./scripts/install.sh

Selective install:

./scripts/install.sh --components=rules
./scripts/install.sh --components=hooks --hooks=auto-allow,git-guard

---

What's included

rules/

Markdown rules automatically injected into every project.

File	Contents
cli-checklist.md	CLI tool building checklist
readme-guide.md	README writing guide
refactor-safety.md	Safe refactoring rules
wiki.md	Wiki writing guide

hooks/

Bash scripts that run on PreToolUse events.

Hook	Behavior
bash-auto-allow	Auto-allow Bash commands, blocking dangerous patterns (rm -rf, sudo, force push, etc.)
git-guard	Injects safety checklists before git commit and git push
rtk-rewrite	Transparently rewrites commands through RTK for token savings (requires RTK)

settings.json

Renders settings.json.template with your actual ~/.claude path and smart-merges into your existing settings. Plugin-managed fields (enabledPlugins, statusLine, etc.) are always preserved.

plugins

Claude Code plugins installed automatically in order.

Plugin	Purpose
oh-my-claudecode	Multi-agent orchestration layer
caveman	65–75% response token savings

Skip plugins: --components=rules,hooks,settings
Select specific plugins: --plugins=oh-my-claudecode

---

Updating

On a new machine or after pulling changes:

cd cc-configs && git pull && ./scripts/install.sh

Or if the plugin is installed:

/cc-configs:install

---

Syncing local changes back

./sync.sh
git add -A && git commit -m "chore: sync local changes"
git push

---

Optional dependencies

Tool	Purpose	Install
oh-my-claudecode	Multi-agent orchestration	auto-installed via plugins component
caveman	65–75% response token savings	auto-installed via plugins component
RTK	Token-saving CLI proxy (60–90% savings)	cargo install rtk
jq	Required by hook scripts	brew install jq

---

Caveats

• Never commit secrets (.mcp.json, .env, etc.)
• enabledPlugins, extraKnownMarketplaces, and statusLine are managed by Claude Code — preserved on every install

---

License

MIT