Command Files

• .claude/commands//*.md** → Project commands (project-specific slash commands)
• ~/.claude/commands//*.md** → User commands (personal slash commands)

Subagent Files

• .claude/agents//*.md** → Project subagents (project-specific agents)
• ~/.claude/agents//*.md** → User subagents (personal agents)

Settings Files

• .claude/settings.json → Project settings (shared configuration)
• .claude/settings.local.json → Project settings local (local overrides, gitignored)
• ~/.claude/settings.json → User settings (global configuration)

Installation

Quick Start (Recommended)

No installation required! Run directly with:

# Using Bun (fastest)
bunx ccexp@latest

# Using npm
npx ccexp@latest

# Using pnpm
pnpm dlx ccexp@latest

Global Installation

For frequent use, install globally:

# npm
npm install -g ccexp

# Bun
bun install -g ccexp

# pnpm
pnpm add -g ccexp

Then run from anywhere:

ccexp

Usage

Interactive Mode (Default)

ccexp                    # Launch interactive TUI
ccexp --path ~/projects # Scan specific directory

Command Line Options

ccexp --help             # Show help information
ccexp --version          # Show version number
ccexp --path <path>      # Specify directory to scan

Examples

# Launch in current directory
bunx ccexp@latest

# Scan specific project
bunx ccexp@latest --path ~/my-project

# Quick exploration without installation
npx ccexp@latest

# Show help
bunx ccexp@latest --help

# Show version
bunx ccexp@latest --version

Common Use Cases

# Find all Claude configuration in your workspace
cd ~/workspace
bunx ccexp@latest

# Check Claude settings in a specific project
bunx ccexp@latest --path ./my-project

# Explore global Claude configuration
bunx ccexp@latest --path ~/.claude

# Using alias (after setup)
ccexp                      # Current directory
ccexp --path ~/workspace   # Specific directory

Keyboard Shortcuts

• ↑/↓ - Navigate file list
• Enter - Open file actions menu
• ESC - Close menu / Exit
• Tab - Switch between panes
• / - Focus search input
• c - Copy file content (in menu)
• p - Copy absolute path (in menu)
• r - Copy relative path (in menu)
• d - Copy file to current directory (in menu)
• e - Edit file with $EDITOR (in menu)
• o - Open file in default application (in menu)

Development

For development setup, commands, and contribution guidelines, see DEVELOPMENT.md.

Contributing

Contributions are welcome! Please see DEVELOPMENT.md for detailed contribution guidelines.

License

MIT License - see LICENSE file for details