CLI Flags Reference

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

Component Installation Flags

—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

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

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

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

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

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

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

string

Specify programming language (deprecated, use —template)

Usage:

cct --language <language>
cct --language javascript

Deprecated: Use --template instead.

—framework

string

Specify framework (deprecated, use —template)

Usage:

cct --framework <framework>
cct --framework react

Deprecated: Use --template instead.

—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

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

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

boolean

Enable verbose logging for debugging and development

Usage:

cct --verbose
cct --analytics --verbose

Behavior: Outputs detailed debugging information.

Analytics and Dashboard Flags

—analytics

boolean

Launch real-time Claude Code analytics dashboard

Usage:

cct --analytics
cct --analytics --tunnel

Port: 3333 URL: http://localhost:3333

—chats

boolean

Launch mobile-first chats interface (AI-optimized for mobile devices)

Usage:

cct --chats
cct --chats --tunnel

—agents

boolean

Launch Claude Code agents dashboard (opens directly to conversations)

Usage:

cct --agents
cct --agents --tunnel

—chats-mobile

boolean

Launch mobile-first chats interface (same as —chats)

Usage:

cct --chats-mobile

—plugins

boolean

Launch Plugin Dashboard to view marketplaces, installed plugins, and permissions

Usage:

cct --plugins

—skills-manager

boolean

Launch Skills Dashboard to view and explore installed Claude Code Skills

Usage:

cct --skills-manager

—teams

boolean

Launch Agent Teams Dashboard to review multi-agent collaboration sessions

Usage:

cct --teams

—2025

boolean

Launch 2025 Year in Review dashboard (showcase your Claude Code usage statistics)

Usage:

cct --2025
cct --2025 --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

boolean

Analyze existing Claude Code commands and offer optimization

Usage:

cct --command-stats
cct --commands-stats  # Alternative spelling

Alias: --commands-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

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

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

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

boolean

List all installed global agents

Usage:

cct --list-agents

—remove-agent

string

Remove a global agent

Usage:

cct --remove-agent <agent-name>
cct --remove-agent customer-support

—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

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

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

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

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

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

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

boolean

Launch Claude Code Studio interface for local and cloud execution

Usage:

cct --studio

Version and Help Flags

—version

boolean

Display version information

Usage:

cct --version
cct -v  # Short alias

Alias: -v

—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:

Sandbox execution - Runs first if present
Component installation - If no sandbox
Dashboard launch - If no components
Health check - If specified
Interactive menu - If no flags

Environment Variables vs Flags

Some flags have environment variable equivalents:

Flag	Environment Variable
`--anthropic-api-key`	`ANTHROPIC_API_KEY`
`--e2b-api-key`	`E2B_API_KEY`
`--directory`	`PWD` (current directory)

Flags take precedence over environment variables.

Default Values

Flag	Default Value
`--directory`	`process.cwd()` (current directory)
`--template`	Auto-detected or `common`
`--yes`	`false` (interactive prompts)
`--dry-run`	`false` (execute changes)
`--verbose`	`false` (minimal output)
`--tunnel`	`false` (local only)

Next Steps

CLI Overview - Complete CLI documentation
Configuration Guide - Settings and config files
Environment Variables - Environment configuration
Install Components - Component installation guide

​CLI Flags Reference

​Component Installation Flags

​—agent

​—command

​—mcp

​—setting

​—hook

​—skill

​Template and Configuration Flags

​—template

​—language

​—framework

​—directory

​Execution Flags

​—yes

​—dry-run

​—verbose

​Analytics and Dashboard Flags

​—analytics

​—chats

​—agents

​—chats-mobile

​—plugins

​—skills-manager

​—teams

​—2025

​—tunnel

​Statistics and Analysis Flags

​—command-stats

​—hook-stats

​—mcp-stats

​Health and Verification Flags

​—health-check

​Global Agent Flags

​—create-agent

​—list-agents

​—remove-agent

​—update-agent

​Sandbox and Execution Flags

​—sandbox

​—prompt

​—e2b-api-key

​—anthropic-api-key

​Workflow Flags

​—workflow

​Session Management Flags

​—clone-session

​—studio

​Version and Help Flags

​—version

​—help

​Flag Combinations

​Common Combinations

​Invalid Combinations

​Flag Priority

​Environment Variables vs Flags

​Default Values

​Next Steps

CLI Flags Reference

Component Installation Flags

—agent

—command

—mcp

—setting

—hook

—skill

Template and Configuration Flags

—template

—language

—framework

—directory

Execution Flags

—yes

—dry-run

—verbose

Analytics and Dashboard Flags

—analytics

—chats

—agents

—chats-mobile

—plugins

—skills-manager

—teams

—2025

—tunnel

Statistics and Analysis Flags

—command-stats

—hook-stats

—mcp-stats

Health and Verification Flags

—health-check

Global Agent Flags

—create-agent

—list-agents

—remove-agent

—update-agent

Sandbox and Execution Flags

—sandbox

—prompt

—e2b-api-key

—anthropic-api-key

Workflow Flags

—workflow

Session Management Flags

—clone-session

—studio

Version and Help Flags

—version

—help

Flag Combinations

Common Combinations

Invalid Combinations

Flag Priority

Environment Variables vs Flags

Default Values

Next Steps