Test-Driven Development

CCGM (Claude Code God Mode)

Modular configuration system for Claude Code - pick the modules you want, install in seconds. Works with Claude Code CLI, VS Code, Cursor, the macOS Claude app, and any other editor with Claude Code support.

Table of Contents

• What is CCGM?
• Requirements
• Install via agent (paste this)
• Install
• Module Catalog
  • Companion module: /deepresearch
• Customization
• Manual Installation
• Utilities
• Documentation
• Contributing
• License

What is CCGM?

CCGM is a curated collection of 71 configuration modules for Claude Code. Instead of hand-crafting rules, hooks, commands, and permissions from scratch, you pick modules and install them with a single command.

Each module is self-contained with its own README, so you can also copy individual files manually without the installer.

What gets installed

CCGM places files into ~/.claude/ (global) or .claude/ (project-level):

Directory	What	How Claude Uses It
rules/*.md	Behavior rules	Loaded automatically at session start
commands/*.md	Slash commands	Available as /commit, /pr, etc.
agents/*.md	Subagent prompts	Reusable prompts invoked by commands and skills via the Task tool
hooks/*.py	Workflow hooks	Triggered on Claude Code events
settings.json	Permissions	Controls tool access and auto-approval

Install via agent (paste this)

Paste the block below into a fresh Claude Code session. The agent detects your environment, picks a preset, runs the installer, and reports what was installed. No flags, no shell environment to configure first.

Install CCGM (Claude Code God Mode) for me.

Steps:
1. Detect my OS (uname -s), shell ($SHELL), and home directory ($HOME).
2. Clone the repo if it does not already exist:
     git clone https://github.com/lucasmccomb/ccgm.git ~/code/ccgm
   If it already exists, pull the latest main:
     cd ~/code/ccgm && git fetch origin && git checkout main && git pull --ff-only origin main
3. Read the available presets: ls ~/code/ccgm/presets/
   Available presets and what they include:
     - minimal  : global-claude-md, autonomy, git-workflow
     - standard : the above + identity, hooks, settings, commands-core, commands-utility
     - team     : standard core + github-protocols, code-quality, systematic-debugging, verification
     - cloud-agent : large set for power users running autonomous agents
     - full     : every stable module
   Based on what you know about my workflow, recommend one preset. Ask me to confirm or pick a different one before continuing. (One question only — do not ask anything else.)
4. Check what is already installed by looking at ~/.claude/rules/, ~/.claude/commands/, ~/.claude/hooks/. List any CCGM files already present and note you will skip overwriting them.
5. Read ~/.claude/settings.json if it exists and note its content. The installer will merge non-destructively — it will not delete keys that are already there.
6. Run the installer:
     cd ~/code/ccgm
     CCGM_NON_INTERACTIVE=1 \
       CCGM_USERNAME="$(gh api user --jq '.login' 2>/dev/null || echo '')" \
       ./start.sh --preset <chosen-preset>
7. Verify the install succeeded by checking that these paths exist:
     ~/.claude/rules/
     ~/.claude/CLAUDE.md   (if global-claude-md was in the preset)
   List the files now present in ~/.claude/rules/ and ~/.claude/commands/.
8. Report: which preset was installed, which modules were skipped (already present), and any errors.

For blocks pre-selecting a specific preset, and for how to dry-run this safely, see docs/install-via-agent.md.

Requirements

• Claude Code (npm install -g @anthropic-ai/claude-code)
• macOS or Linux
• bash 4+ or zsh
• git

The installer checks for Claude Code, additional tools (jq, Python 3, gh CLI), and offers to install any that are missing.

Install

git clone https://github.com/lucasmccomb/ccgm.git
cd ccgm
./start.sh

The interactive setup handles everything: prerequisite checks, module selection, and configuration. No flags needed.

Installing from an editor