Claude Code Chameleon 🦎

Quickly switch between Claude Code agents and commands with a beautiful visual interface. Pull components directly from the official claude-code-templates repository.

Features

🎯 Quick Agent Switching

• Status Bar Integration: Click the status bar item to quickly switch agents
• Command Palette: Use Chameleon: Switch Claude Agent command
• Tree View: Browse agents by category in the sidebar

⚡ Command Installation (NEW!)

• 210+ Commands: Install powerful Claude Code slash commands
• Category Organization: Testing, Performance, Security, Documentation, and more
• Visual Installation: Click to install, see installed commands with checkmarks
• Command Preview: View command content before installing

📦 160+ Pre-Built Agents

Automatically pulls from the official repository with agents for:

• Development Team: Frontend, Backend, Full-stack, DevOps, Mobile, iOS developers
• Security: Security auditors, penetration testers, compliance specialists
• Data & AI: Data scientists, ML engineers, NLP engineers, AI engineers
• Performance Testing: Load testing specialists, web vitals optimizers
• Expert Advisors: Legal advisors, business analysts, product strategists
• And many more...

🔄 Automatic Updates

• Refreshes agent list from GitHub
• Caches agents for offline use
• Auto-refresh on startup (configurable)

🎨 Beautiful UI

• Tree view with categorized agents
• Status bar indicator showing current agent
• Visual highlighting of active agent
• Quick pick with categories and descriptions

Installation

1. Install the extension from VS Code Marketplace (coming soon)
2. Or install from VSIX:

   code --install-extension claude-code-chameleon-0.0.1.vsix
   

Usage

Method 1: Status Bar

1. Click the agent indicator in the status bar (bottom-right)
2. Select an agent from the quick pick menu
3. Agent will be downloaded and installed to .claude/agents/

Method 2: Command Palette

1. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
2. Type "Chameleon: Switch Claude Agent"
3. Select your desired agent

Method 3: Sidebar

1. Click the Chameleon icon in the activity bar (left sidebar)
2. Browse agents by category
3. Click any agent to switch to it

Method 4: View Current Agent

1. Use command "Chameleon: View Current Agent"
2. Opens the agent's markdown file in a preview tab
3. Review the agent's capabilities and instructions

Installing Commands

1. Click the Chameleon icon in the activity bar
2. Expand "Available Commands" section
3. Browse commands by category (Testing, Performance, Security, etc.)
4. Click any command to install it to .claude/commands/
5. Installed commands show a green checkmark

Or use Command Palette:

1. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
2. Type "Chameleon: Install Claude Command"
3. Browse and select commands to install

Commands

Agent Commands

Command Commands (NEW!)

Configuration

Access settings via Preferences > Settings > Extensions > Claude Code Chameleon

Custom Repository

You can point to your own fork or custom agent repository:

{
  "claudeCodeChameleon.githubRepo": "your-username/your-repo",
  "claudeCodeChameleon.githubBranch": "main"
}

Privacy & Telemetry

This extension:

• ✅ Downloads agents directly from GitHub (public repository)
• ✅ Stores agents locally in your workspace (.claude/agents/)
• ✅ Caches agent list in VS Code's global state
• ❌ Does NOT collect any telemetry or usage data
• ❌ Does NOT send any information about your usage

How It Works

1. Agent Discovery: Fetches agent list from aitmpl.com API or GitHub API
2. Direct Download: Downloads agent markdown files from GitHub raw URLs
3. Local Installation: Saves to .claude/agents/ in your workspace
4. State Management: Tracks current agent in VS Code workspace state

Example Download URL

https://raw.githubusercontent.com/davila7/claude-code-templates/main/cli-tool/components/agents/development-team/frontend-developer.md

Requirements

• VS Code 1.85.0 or higher
• Active internet connection (for downloading agents)
• A workspace folder open (agents are installed per-workspace)

Troubleshooting

"No workspace folder open"

• Solution: Open a folder in VS Code (File > Open Folder)

"Failed to refresh agents"

• Check your internet connection
• GitHub API might be rate-limited (will use cached agents)
• Try refreshing manually after a few minutes

"Agent not switching"

• Ensure .claude/agents/ directory is writable
• Check VS Code output panel for error messages
• Try refreshing the agent list

Contributing

Found a bug or want a feature? Open an issue on GitHub.

Credits

• Agents sourced from claude-code-templates by @davila7
• Agent collection includes contributions from @wshobson and the community

License

MIT License - see LICENSE file for details

Made with 🦎 for the Claude Code community