Claude Config CLI

A CLI tool to manage Claude Code configuration files by scanning existing configs and applying recommended settings.

Features

• Scan Mode: Scan multiple directories to find existing Claude config files and generate a recommended configuration
• Apply Mode: Directly apply a pre-defined recommended configuration
• Merge or Overwrite: Choose to merge with existing configs or overwrite them
• Interactive CLI: User-friendly prompts for all operations

Installation

# Using npm
npm install -g claude-config-cli

# Using pnpm
pnpm add -g claude-config-cli

# Using yarn
yarn global add claude-config-cli

Or use directly with npx (no installation needed):

npx claude-config-cli

Usage

Command: scan

Scan directories for Claude config files and generate recommended configuration.

# Scan current directory
claude-config scan

# Scan specific directories
claude-config scan ~/personal ~/work

# Preview without applying
claude-config scan --preview

# Specify output path
claude-config scan -o .claude/settings.local.json

Command: apply

Apply the recommended Claude configuration directly.

# Apply with interactive prompts
claude-config apply

# Preview the recommended config
claude-config apply --preview

# Specify output path
claude-config apply -o /custom/path/settings.json

Options

Both commands support the following options:

• -o, --output <path>: Specify the output file path (default: .claude/settings.local.json)
• -p, --preview: Preview the configuration without applying it
• -h, --help: Display help information

Interactive Prompts

When you run scan or apply without --preview, you'll be prompted to choose an action:

• Save to new file: Create a new config file
• Merge with existing config: Merge the recommended config with any existing config (preserves existing settings)
• Overwrite existing config: Replace any existing config with the recommended one
• Cancel: Cancel the operation

Example Workflow

1. Scan and Preview

npx claude-config scan ~/personal ~/work --preview

This will show you the recommended configuration based on all configs found in the specified directories.

2. Apply Recommended Config

npx claude-config apply

You'll be prompted to choose how to apply the config. Select your preferred option and the tool will handle the rest.

3. Scan and Apply in One Step

npx claude-config scan ~/projects

After scanning, choose how you want to apply the generated configuration.

Recommended Configuration

The recommended configuration includes common permissions for:

• Package managers (pnpm, npm, bun)
• Build tools (cargo, wrangler)
• Git operations
• Development tools (node, python, tsc)
• MCP tools (context7, ast-grep, ide)

This configuration is based on common patterns found across many projects.

Development

Local Testing

# Install dependencies
pnpm install

# Test the CLI
node cli.js --help
node cli.js scan --preview
node cli.js apply --preview

# Run tests
pnpm test

Publishing to npm

# Build (if you have a build step)
pnpm run build

# Publish
pnpm publish

Release

This project uses bumpp for version management.

# Interactive release
pnpm release

# Automatic release (patch/minor/major)
pnpm release:patch
pnpm release:minor
pnpm release:major

License

MIT License