gm-cc

gm-cc for Claude Code

Installation

Plugin Marketplace Installation (Recommended)

The easiest way to install gm-cc is through Claude Code's plugin marketplace:

claude plugin marketplace add AnEntrypoint/gm-cc
claude plugin install -s user gm@gm-cc

This installation method is best for:

• One-time plugin installation across all projects
• Always having the latest version
• Minimal setup and configuration
• Access to marketplace updates

Repository Installation (Project-Specific)

For development or project-specific customization, install gm-cc directly into your project:

cd /path/to/your/project
npm install gm-cc && npx gm install

This installation method is ideal when you need to:

• Customize hooks or agents for your workflow
• Integrate with existing Claude Code projects
• Use the latest development version
• Configure platform-specific behavior per project

Installation Command Breakdown

The npm install gm-cc && npx gm install command performs two steps:

1. npm install gm-cc - Downloads the gm-cc package and stores it in your project's node_modules/ directory
2. npx gm install - Runs the gm installer that copies configuration files into your Claude Code plugin directory

Expected output:

$ npm install gm-cc
added 1 package in 1.2s

$ npx gm install
Installing gm-cc...
✓ Created .claude/ directory
✓ Copied agents/gm.md
✓ Copied hooks to .claude/hooks/
✓ Created .mcp.json for MCP integration

Installed File Structure (Project-Specific)

After running npx gm install, your project will have:

.claude/
├── agents/
│   └── gm.md                 # State machine agent rules
├── hooks/
│   ├── pre-tool-use-hook.js  # Tool validation and filtering
│   ├── session-start-hook.js # Session initialization
│   ├── prompt-submit-hook.js # Prompt validation
│   ├── stop-hook.js          # Session completion enforcement
│   └── stop-hook-git.js      # Git state verification
└── .mcp.json                 # MCP server configuration

Each hook runs automatically at the appropriate session event. No manual trigger needed.

File Installation (Manual Setup)

If you prefer manual file management, clone the repository and copy files directly:

# Clone the repository
git clone https://github.com/AnEntrypoint/gm-cc.git

# Copy to your Claude Code plugin directory
cp -r ./agents ~/.claude/agents
cp -r ./hooks ~/.claude/hooks
cp .mcp.json ~/.claude/.mcp.json

Environment Setup

# Ensure you have Node.js and bun x installed
# bun x is required for hook execution
# It's bundled with Node.js 18+
which bun x
bun x --version

MCP Server Configuration

The .mcp.json file automatically configures:

• dev: Local code execution environment (uses bun x)
• code-search: Semantic code search via mcp-codebasesearch

No additional configuration needed.

Configuration

Option 1: Marketplace Installation (Default)

Marketplace installations use the default configuration. All settings work out-of-box:

• Hooks auto-detect file locations in .claude/hooks/
• MCP servers configured via included .mcp.json
• Agents loaded from .claude/agents/gm.md

Option 2: Project-Specific Installation

For project customization:

1. Edit agents/gm.md to adjust behavioral rules
2. Modify hooks in .claude/hooks/ for custom behavior
3. Update .mcp.json to add or change MCP servers

Customizations are isolated to your project and won't affect other installations.

Hook Enablement

Hooks run automatically once installed. To verify hooks are active:

1. Restart Claude Code
2. Start a new session
3. You should see hook output in the Claude Code terminal

If hooks don't activate:

• Check that .claude/hooks/ directory exists
• Verify hook files have executable permissions
• Ensure .mcp.json references the correct hook paths

Update Procedures

Plugin Marketplace Installation

# Method 1: Via Claude Code commands
claude plugin marketplace update gm-cc
claude plugin update gm@gm-cc

# Method 2: Manual update
npm install -g gm-cc@latest

Project-Specific Installation

# Update the package
npm update gm-cc

# Re-run the installer to update .claude/ directory
npx gm install

# Or manually copy updated files
cp -r node_modules/gm-cc/agents/* .claude/agents/
cp -r node_modules/gm-cc/hooks/* .claude/hooks/
cp node_modules/gm-cc/.mcp.json .claude/.mcp.json

Features