@schuettc/claude-code-setup

Claude Code Setup CLI

A CLI tool to set up and configure Claude Code command templates and settings.

Features

• 🎨 Beautiful Interactive Interface - Enhanced UI with colors, tables, and branded elements
• 📝 Template Management - Add, update, and manage command templates for common tasks
• ⚙️ Settings Management - Configure permissions, themes, and environment variables
• 🔄 Unified Commands - Consistent interface for both templates and settings
• 🎯 Interactive Mode - Guided setup with smart prompts and selections
• 🌙 Themes - Choose from different themes (default, dark)
• 🔒 Permissions - Fine-grained control over Claude Code capabilities
• 🚀 Modern CLI Experience - Progressive disclosure and beautiful formatting

Usage

You can run this tool directly without installing it using package manager executors:

# Using npx (npm)
npx @schuettc/claude-code-setup <command>

# Using pnpm
pnpm dlx @schuettc/claude-code-setup <command>

# Using yarn
yarn dlx @schuettc/claude-code-setup <command>

# Using bun
bunx @schuettc/claude-code-setup <command>

For brevity, the examples below use npx, but you can substitute with your preferred package manager.

Quick Start

🚀 Get Overview of Everything

# See both templates and settings in one beautiful view
npx @schuettc/claude-code-setup list

🎯 Interactive Setup

# Interactive mode - let the tool guide you
npx @schuettc/claude-code-setup add

# Choose what to add:
#   📝 Templates - Add command templates  
#   🔒 Permission - Add a new permission
#   🎨 Theme - Set a theme
#   🌱 Environment Variable - Add an env var

⚡ Quick Setup

# Initialize Claude Code (first time)
npx @schuettc/claude-code-setup init

# Add specific items directly
npx @schuettc/claude-code-setup add template python-optimization
npx @schuettc/claude-code-setup add permission "Bash(npm:*)"
npx @schuettc/claude-code-setup add theme dark
npx @schuettc/claude-code-setup add env NODE_ENV production

Commands Reference

Core Commands

list - See Everything

# Show both templates and settings with beautiful formatting
npx @schuettc/claude-code-setup list

# Show only templates
npx @schuettc/claude-code-setup list templates

# Show only settings  
npx @schuettc/claude-code-setup list settings

add - Add Anything

# Interactive mode - choose what to add
npx @schuettc/claude-code-setup add

# Add templates
npx @schuettc/claude-code-setup add template <template-name>
npx @schuettc/claude-code-setup add template python-optimization

# Add settings
npx @schuettc/claude-code-setup add permission "Bash(docker:*)"
npx @schuettc/claude-code-setup add theme dark
npx @schuettc/claude-code-setup add env HTTP_PROXY "http://proxy.com:8080"

update - Update Anything

# Interactive mode - choose what to update
npx @schuettc/claude-code-setup update

# Update all templates
npx @schuettc/claude-code-setup update templates

# Update all settings to latest defaults
npx @schuettc/claude-code-setup update settings

# Update specific template
npx @schuettc/claude-code-setup update python-optimization

remove - Remove Anything

# Interactive mode - choose what to remove  
npx @schuettc/claude-code-setup remove

# Remove specific items
npx @schuettc/claude-code-setup remove template <template-name>
npx @schuettc/claude-code-setup remove permission "Bash(rm:*)" 
npx @schuettc/claude-code-setup remove env HTTP_PROXY

init - Initial Setup

# Basic initialization in current directory
npx @schuettc/claude-code-setup init

# Initialize with specific permission sets
npx @schuettc/claude-code-setup init -p python,git

# Initialize with dark theme
npx @schuettc/claude-code-setup init --theme dark

# Initialize globally (in ~/.claude)
npx @schuettc/claude-code-setup init -g

# Force overwrite existing settings
npx @schuettc/claude-code-setup init -f

Options

All commands support these options:

• -t, --test-dir <dir> - Use a test directory instead of current directory
• -g, --global - Use global ~/.claude directory instead of local
• -f, --force - Force overwrite existing items (add/update commands)

Examples

# Use test directory for all operations  
npx @schuettc/claude-code-setup list --test-dir ./my-test
npx @schuettc/claude-code-setup add template python-optimization --test-dir ./my-test

# Work with global settings
npx @schuettc/claude-code-setup add permission "Bash(git:*)" -g
npx @schuettc/claude-code-setup list settings -g

# Force overwrite
npx @schuettc/claude-code-setup add template create-tasks -f

Available Templates

Python

• python-optimization: Optimize Python code for performance

Node.js

• node-optimization: Optimize JavaScript/TypeScript code for performance

Project Management

• create-tasks: Create a TASKS.md file to track project progress
• update-tasks: Update task status in TASKS.md file

General Development

• code-review: Comprehensive code review with specialized subagents
• fix-issue: Analyze and fix GitHub issues using parallel subagents

Configuration

The tool manages configuration in these locations:

• Global: ~/.claude/settings.json and ~/.claude/commands/
• Project: ./.claude/settings.json and ./.claude/commands/

Settings Structure

{
  "theme": "default",
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(npm:*)", 
      "Bash(python:*)"
    ],
    "deny": []
  },
  "env": {
    "NODE_ENV": "development"
  },
  "ignorePatterns": [
    "node_modules",
    ".git"
  ]
}

Available Themes

• default - Light, clean interface
• dark - Dark mode for night coding

Permission Sets

• python - Python development tools
• node - JavaScript/TypeScript tools
• git - Version control commands
• shell - System shell commands
• package-managers - npm, yarn, pnpm access

License

MIT