Starter Example with Evolve and Claude Code¶
Agentic IDEs like Claude Code often repeat the same mistakes over and over again because they start from fresh every time. Using Evolve, we can alleviate this problem. In this tutorial, we will use Evolve and Claude Code to create a Python script to automate a simple task. Using Evolve, we will then instruct Claude Code that it should use this script in the future for similar tasks.
Video Tutorial¶
The plugin has changed since this video was recorded and no longer has a /evolve-lite:learn skill. Where the video and the steps below differ, follow the steps.
Requirements¶
uvinstalled- Claude Code installed.
- Docker installed.
Step 0: Run Claude in a docker container¶
The following command downloads and runs the official devcontainer which is capable of running Claude Code.
Optional
This is for consistency purposes so that the demo works. You can skip this step, but the demo may not work as intended.
# Copy only the .devcontainer directory from the official Claude Code repository
git clone --depth 1 --filter=blob:none --sparse https://github.com/anthropics/claude-code.git
cd claude-code
git sparse-checkout set .devcontainer
# Build and run
docker build -t my-claude .devcontainer/
docker run --rm -it my-claude bash
Step 1: Install Evolve¶
Evolve Lite needs more than the plugin: the installer also puts .evolve/EVOLVE.md in your project, imports it from the project's CLAUDE.md, and installs two small scripts under ~/.claude/evolve-lite/. Installing only the plugin (claude plugin install) loads the skills but none of the rest, and /evolve-lite:doctor then reports NOT_INSTALLED.
Clone Evolve somewhere it can stay (the plugin is read from the clone), create a project directory, and run the installer for it. See the installation instructions → for details.
git clone --depth 1 https://github.com/AgentToolkit/altk-evolve.git ~/altk-evolve
mkdir exif-demo && cd exif-demo && git init
~/altk-evolve/platform-integrations/install.sh install --platform claude --dir .
Step 2: Running in Claude Code¶
In the project directory, run:
Allow the import
On the first session, Claude may ask whether to allow the project's CLAUDE.md to import .evolve/EVOLVE.md. Allow it, or Evolve's instructions never reach Claude. Run /evolve-lite:doctor to check that the import is loading.
