evo
turns your codebase into an autoresearch loop — discovers what to measure, instruments the benchmark, then runs tree search with parallel subagents.
- 1.5k stars
- 115 forks
- 38 open issues
- Language: Python
- License: Apache-2.0
- updated
Install
git clone https://github.com/evo-hq/evo && cp evo/*.md ~/.claude/agents/- Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
- Start a new Claude Code session to load the agents.
- Delegate work to them with the Task/Agent tool or by name.
7 items in this repository
Initialize evo for the current repository by exploring the codebase, proposing unexplored optimization dimensions, constructing the benchmark inside a baseline worktree, and running the first experiment. Use when the user invokes /evo:discover, mentions setting up evo, wants to instrument a codebase for autonomous optimization, or asks to start a new evo run on a project.
This skill should be used when picking or diagnosing a training move (SFT, LoRA, DPO/KTO/ORPO, RFT, GRPO/PPO/RLOO, RLHF), or when the user mentions fine-tuning, post-training, training recipe, reward design, or weight updates. Decision tree by reward shape, smoke-run gate, three failure diagnostics, five false-progress patterns. Provider recipes and I/O contract in references/.
Non-user-invocable provider/setup reference for evo backend switching, prerequisite checks, and auth/install guidance.
Read-only evo run reporting. Use when the user invokes /evo:report, asks what happened overnight, asks what improved recently, asks for the best/frontier candidates, asks for a quick score chart without opening the dashboard, or wants the scatter plot in chat output. Never run benchmarks, gates, Slurm commands, evo run, or ad-hoc verification scripts for report requests.
Land the winning experiment from an evo run as a clean, mergeable change -- open a PR when the repo has a remote, otherwise merge into the working branch. Distills the best-scoring experiment down to the minimal diff that reproduces its behaviour, shaped for the qualities a maintainer merges on (scope discipline, test integrity, style adherence), then attaches an advisory mergeability report. Use when the user invokes /evo:ship, asks to land/merge/ship the best result, or wants to turn a finished optimization into a pull request.
Protocol that evo optimization subagents follow when dispatched from /optimize. Auto-loaded by spawned subagents via their host's skill loader. The orchestrator may also invoke this skill to understand the brief shape its dispatched subagents expect + what they're required to emit -- useful when writing briefs or debugging a subagent's behavior.
Subagents overview
What people ask about evo
What is evo-hq/evo?
evo-hq/evo is subagents for the Claude AI ecosystem. turns your codebase into an autoresearch loop — discovers what to measure, instruments the benchmark, then runs tree search with parallel subagents. It has 1.5k GitHub stars and its last recorded update is dated 2026-10-05.
How do I install evo?
You can install evo by cloning the repository (https://github.com/evo-hq/evo) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is evo-hq/evo safe to use?
Our security agent has analyzed evo-hq/evo and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains evo-hq/evo?
evo-hq/evo is maintained by evo-hq. The last recorded GitHub activity is dated 2026-10-05, with 38 open issues.
Are there alternatives to evo?
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.