Skip to main content

​
CLI Flags Reference

Complete documentation of all command-line flags and options for the Claude Code Templates CLI.

​
Component Installation Flags

​
—agent

​
--agent
string
Install specific agent component (supports comma-separated values)
Usage: 
cct --agent <agent-name>
cct --agent frontend-developer
cct --agent development-team/frontend-developer
cct --agent security-auditor,devops-engineer
Format: Direct name or category/name Examples:
  • frontend-developer
  • development-team/react-specialist
  • security-team/penetration-tester

​
—command

​
--command
string
Install specific command component (supports comma-separated values)
Usage: 
cct --command <command-name>
cct --command setup-testing
cct --command testing/generate-tests,code-review
Format: Direct name or category/name

​
—mcp

​
--mcp
string
Install specific MCP component (supports comma-separated values)
Usage: 
cct --mcp <mcp-name>
cct --mcp web-fetch
cct --mcp github-integration,filesystem-access
Available MCPs:
  • web-fetch
  • filesystem-access
  • github-integration
  • memory-integration
  • mysql-integration
  • postgresql-integration
  • deepgraph-react
  • deepgraph-typescript
  • deepgraph-vue
  • deepgraph-nextjs

​
—setting

​
--setting
string
Install specific setting component (supports comma-separated values)
Usage: 
cct --setting <setting-name>
cct --setting permissions/allow-npm-commands
cct --setting model/use-sonnet,telemetry/disable-telemetry
Categories:
  • permissions/ - Permission configurations
  • model/ - Model selection settings
  • telemetry/ - Telemetry controls
  • retention/ - Data retention policies
  • security/ - Security settings
  • statusline/ - Statusline configurations

​
—hook

​
--hook
string
Install specific hook component (supports comma-separated values)
Usage: 
cct --hook <hook-name>
cct --hook automation/git-commit-validation
cct --hook automation/simple-notifications,automation/run-tests
Hook Types:
  • PreToolUse hooks
  • PostToolUse hooks
  • Stop hooks
  • Notification hooks

​
—skill

​
--skill
string
Install specific skill component (supports comma-separated values)
Usage: 
cct --skill <skill-name>
cct --skill web-development/roier-seo
cct --skill document-processing/pptx

​
Template and Configuration Flags

​
—template

​
--template
string
Specify template (e.g., common, javascript-typescript, python, ruby)
Usage: 
cct --template <template-name>
cct --template javascript-typescript
cct --template python
Available Templates:
  • common - Universal configuration
  • javascript-typescript - Node.js, React, Vue, Next.js
  • python - Django, Flask, FastAPI
  • ruby - Rails, Sinatra
  • go - Go projects
  • rust - Rust/Cargo projects

​
—language

​
--language
string
Specify programming language (deprecated, use —template)
Usage: 
cct --language <language>
cct --language javascript
Deprecated: Use --template instead.

​
—framework

​
--framework
string
Specify framework (deprecated, use —template)
Usage: 
cct --framework <framework>
cct --framework react
Deprecated: Use --template instead.

​
—directory

​
--directory
string
Target directory (default: current directory)
Usage: 
cct --directory <path>
cct --directory ./my-project
cct -d ./my-project  # Short alias
Alias: -d

​
Execution Flags

​
—yes

​
--yes
boolean
Skip prompts and use defaults
Usage: 
cct --yes
cct -y  # Short alias
Behavior: Uses detected project type and default options. Alias: -y

​
—dry-run

​
--dry-run
boolean
Show what would be copied without actually copying
Usage: 
cct --dry-run
cct --agent frontend-developer --dry-run
Behavior: Displays files that would be created/modified without making changes.

​
—verbose

​
--verbose
boolean
Enable verbose logging for debugging and development
Usage: 
cct --verbose
cct --analytics --verbose
Behavior: Outputs detailed debugging information.

​
Analytics and Dashboard Flags

​
—analytics

​
--analytics
boolean
Launch real-time Claude Code analytics dashboard
Usage: 
cct --analytics
cct --analytics --tunnel
Port: 3333 URL: http://localhost:3333

​
—chats

​
--chats
boolean
Launch mobile-first chats interface (AI-optimized for mobile devices)
Usage: 
cct --chats
cct --chats --tunnel

​
—agents

​
--agents
boolean
Launch Claude Code agents dashboard (opens directly to conversations)
Usage: 
cct --agents
cct --agents --tunnel

​
—chats-mobile

​
--chats-mobile
boolean
Launch mobile-first chats interface (same as —chats)
Usage: 
cct --chats-mobile

​
—plugins

​
--plugins
boolean
Launch Plugin Dashboard to view marketplaces, installed plugins, and permissions
Usage: 
cct --plugins

​
—skills-manager

​
--skills-manager
boolean
Launch Skills Dashboard to view and explore installed Claude Code Skills
Usage: 
cct --skills-manager

​
—teams

​
--teams
boolean
Launch Agent Teams Dashboard to review multi-agent collaboration sessions
Usage: 
cct --teams

​
—2025

​
--2025
boolean
Launch 2025 Year in Review dashboard (showcase your Claude Code usage statistics)
Usage: 
cct --2025
cct --2025 --tunnel

​
—tunnel

​
--tunnel
boolean
Enable Cloudflare Tunnel for remote access (use with —analytics, —chats, or —2025)
Usage: 
cct --analytics --tunnel
cct --chats --tunnel
cct --2025 --tunnel
Behavior: Creates public URL for remote access. Restriction: Only works with dashboard flags.

​
Statistics and Analysis Flags

​
—command-stats

​
--command-stats
boolean
Analyze existing Claude Code commands and offer optimization
Usage: 
cct --command-stats
cct --commands-stats  # Alternative spelling
Alias: --commands-stats

​
—hook-stats

​
--hook-stats
boolean
Analyze existing automation hooks and offer optimization
Usage: 
cct --hook-stats
cct --hooks-stats  # Alternative spelling
Alias: --hooks-stats

​
—mcp-stats

​
--mcp-stats
boolean
Analyze existing MCP server configurations and offer optimization
Usage: 
cct --mcp-stats
cct --mcps-stats  # Alternative spelling
Alias: --mcps-stats

​
Health and Verification Flags

​
—health-check

​
--health-check
boolean
Run comprehensive health check to verify Claude Code setup
Usage: 
cct --health-check
cct --health  # Short alias
cct --check   # Alternative alias
cct --verify  # Another alias
Aliases: --health, --check, --verify

​
Global Agent Flags

​
—create-agent

​
--create-agent
string
Create a global agent accessible from anywhere (e.g., customer-support)
Usage: 
cct --create-agent <agent-name>
cct --create-agent customer-support
cct --create-agent development-team/frontend-developer
Installation: Creates executable in /usr/local/bin/ or ~/.claude-code-templates/bin/

​
—list-agents

​
--list-agents
boolean
List all installed global agents
Usage: 
cct --list-agents

​
—remove-agent

​
--remove-agent
string
Remove a global agent
Usage: 
cct --remove-agent <agent-name>
cct --remove-agent customer-support

​
—update-agent

​
--update-agent
string
Update a global agent to the latest version
Usage: 
cct --update-agent <agent-name>
cct --update-agent customer-support

​
Sandbox and Execution Flags

​
—sandbox

​
--sandbox
string
Execute Claude Code in isolated sandbox environment (e.g., e2b)
Usage: 
cct --sandbox <provider>
cct --sandbox e2b --prompt "Create a React app"
Supported Providers:
  • e2b - E2B sandbox
  • docker - Docker containers
  • cloudflare - Cloudflare Workers

​
—prompt

​
--prompt
string
Execute the provided prompt in Claude Code after installation or in sandbox
Usage: 
cct --prompt "Create a React component"
cct --agent frontend-developer --prompt "Review this code"
cct --sandbox e2b --prompt "Build an API"

​
—e2b-api-key

​
--e2b-api-key
string
E2B API key for sandbox execution (alternative to environment variable)
Usage: 
cct --sandbox e2b --e2b-api-key YOUR_KEY --prompt "Create app"
Alternative: Set E2B_API_KEY environment variable.

​
—anthropic-api-key

​
--anthropic-api-key
string
Anthropic API key for Claude Code (alternative to environment variable)
Usage: 
cct --anthropic-api-key sk-ant-xxx --prompt "Create app"
Alternative: Set ANTHROPIC_API_KEY environment variable.

​
Workflow Flags

​
—workflow

​
--workflow
string
Install workflow from hash (#hash) OR workflow YAML (base64 encoded) when used with component flags
Usage: 
# Install from hash
cct --workflow #security-audit-workflow

# Install with YAML (base64 encoded)
cct --workflow <base64-yaml> --agent security-auditor
Behavior:
  • Standalone: Installs workflow from hash
  • With components: Treats as YAML workflow definition

​
Session Management Flags

​
—clone-session

​
--clone-session
string
Download and import a shared Claude Code session from URL
Usage: 
cct --clone-session <url>
cct --clone-session https://example.com/session/abc123
Behavior: Downloads session data and imports into local Claude Code.

​
—studio

​
--studio
boolean
Launch Claude Code Studio interface for local and cloud execution
Usage: 
cct --studio

​
Version and Help Flags

​
—version

​
--version
boolean
Display version information
Usage: 
cct --version
cct -v  # Short alias
Alias: -v

​
—help

​
--help
boolean
Display help information
Usage: 
cct --help
cct -h  # Short alias
Alias: -h

​
Flag Combinations

​
Common Combinations

Install multiple components: 
cct --agent security-auditor \
    --command security-audit \
    --mcp github-integration \
    --setting read-only-mode
Analytics with remote access: 
cct --analytics --tunnel
cct --chats --tunnel
cct --2025 --tunnel
Install and execute prompt: 
cct --agent frontend-developer --prompt "Review this React component"
Sandbox execution: 
cct --sandbox e2b --e2b-api-key YOUR_KEY --prompt "Create a dashboard"
Dry run installation: 
cct --agent security-auditor --command security-audit --dry-run
Directory-specific installation: 
cct --directory ./project --agent frontend-developer --yes
Verbose debugging: 
cct --analytics --tunnel --verbose
cct --agent security-auditor --verbose

​
Invalid Combinations

Tunnel without dashboard: 
# ❌ Error
cct --tunnel

# ✅ Correct
cct --analytics --tunnel
Multiple exclusive flags: 
# ❌ Avoid
cct --analytics --chats  # Opens analytics (first wins)

# ✅ Correct
cct --analytics  # Or
cct --chats      # Run separately

​
Flag Priority

When multiple flags are present:
  1. Sandbox execution - Runs first if present
  2. Component installation - If no sandbox
  3. Dashboard launch - If no components
  4. Health check - If specified
  5. Interactive menu - If no flags

​
Environment Variables vs Flags

Some flags have environment variable equivalents:
FlagEnvironment Variable
--anthropic-api-keyANTHROPIC_API_KEY
--e2b-api-keyE2B_API_KEY
--directoryPWD (current directory)
Flags take precedence over environment variables.

​
Default Values

FlagDefault Value
--directoryprocess.cwd() (current directory)
--templateAuto-detected or common
--yesfalse (interactive prompts)
--dry-runfalse (execute changes)
--verbosefalse (minimal output)
--tunnelfalse (local only)

​
Next Steps