pl-claude-settings

CLI tool to install and manage .claude settings for Claude Code.

CK version:

• CLI Version: 3.35.0
• Global Kit Version: [email protected]

Prerequisites

This tool clones a private GitHub repository. You need the GitHub CLI authenticated:

# Install gh CLI (if not already installed)
brew install gh          # macOS
# or: https://cli.github.com/ for other platforms

# Authenticate with GitHub
gh auth login

# Verify access
gh auth status

Without gh CLI, the tool falls back to git clone which requires SSH keys or a personal access token configured for the private repo.

Installation

# Using bun
bun add -g pl-claude-settings

# Using npm
npm install -g pl-claude-settings

# Using pnpm
pnpm add -g pl-claude-settings

Commands

plcc init

Install .claude settings from repository.

plcc init                # Install to ./.claude/ (current directory)
plcc init -g             # Install to ~/.claude/ (global)
plcc init --force        # Overwrite all files including protected ones
plcc init --full         # Also install Python dependencies
plcc init --branch dev   # Use specific branch

plcc update

Update settings to latest version.

plcc update              # Pull latest and merge changes
plcc update --full       # Also install Python dependencies
plcc update --dry-run    # Preview changes without applying
plcc update --branch dev # Update from specific branch

plcc doctor

Health check for .claude installation.

plcc doctor

Checks: installation manifest, .claude/ directory, git, gh CLI auth, hooks, Python venv, settings.json validity.

plcc config

View and edit .ck.json configuration.

plcc config              # List all settings
plcc config list         # Same as above
plcc config get docs.maxLoc       # Get a value (dot-notation)
plcc config set docs.maxLoc 1000  # Set a value

File Categories

During init and update, files are handled by category:

| Category | Behavior | Examples | |----------|----------|---------| | Managed | Always overwritten | hooks/, skills/, rules/, agents/, scripts/, settings.json | | Protected | Never overwritten if exists | .env, settings.local.json, .mcp.json | | Ignored | Never copied | .git/, node_modules/, .venv/ |

What's Included

• 14 agent configurations
• 60+ skills
• 12 hooks (session-init, privacy-block, etc.)
• 5 rule sets (development, orchestration, documentation, etc.)
• Statusline scripts (cjs, sh, ps1)
• Utility scripts

Development

cd cli
bun install
bun run dev -- --help    # Run CLI in dev mode
bun test                 # Run tests
bun run build            # Build for distribution

License

MIT