A minimal Claude Code plugin that runs Codeflash as a background agent to optimize Python code for performance.
- Claude Code v2.1.38 or later
- codeflash installed in your project
- Project initialized with
codeflash init(creates[tool.codeflash]inpyproject.toml)
Add the plugin marketplace and install:
/plugin marketplace add codeflash-ai/codeflash-cc-plugin
/plugin install codeflashgit clone https://github.com/codeflash-ai/codeflash-cc-plugin.git
/plugin marketplace add ./codeflash-cc-plugin
/plugin install codeflashBy default, plugins are installed at the user level (available across all projects). You can change this:
/plugin install codeflash --scope project # shared with team via .claude/settings.json
/plugin install codeflash --scope local # this project only, gitignoredRun /plugin to open the plugin manager and confirm codeflash appears under the Installed tab.
/optimize src/utils.py
/optimize src/utils.py my_function
/optimize --all
/optimize src/utils.py --no-pr # Skip PR creation
/optimize src/utils.py --effort high # Set optimization effort level
When you make a git commit that includes Python file changes, the plugin suggests running /optimize on those files.
codeflash-cc-plugin/
├── .claude-plugin/
│ ├── marketplace.json # Marketplace manifest
│ └── plugin.json # Plugin manifest
├── agents/
│ └── optimizer.md # Background optimization agent
├── hooks/
│ └── hooks.json # PostToolUse hook for commit detection
├── scripts/
│ └── suggest-optimize.sh # Detects Python commits, suggests /optimize
├── skills/
│ └── optimize/
│ └── SKILL.md # /optimize slash command
└── README.md
The plugin is a thin wrapper around the codeflash CLI:
/optimizespawns a background optimizer agent- Verifies codeflash is installed (via
pip install codeflash) and configured - Runs the
codeflashCLI with the appropriate flags - Reports results (optimizations found, PRs created)
Codeflash handles everything else: analysis, benchmarking, test generation, and PR creation.