Skip to main content
ClaudeWave
EN, English
evo-hq / Subagents

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

Terminal
git clone https://github.com/evo-hq/evo && cp evo/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.
Installable items

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.

Install

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/.

Install

Non-user-invocable provider/setup reference for evo backend switching, prerequisite checks, and auth/install guidance.

Install

Run the evo optimization loop with parallel subagents until interrupted.

Install
reportSkill

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.

Install
shipSkill

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.

Install

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.

Install
README

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
Topics
agent-skillsautonomous-agentsautoresearchclaude-codecode-optimizationcodexevolutionary-algorithmsllm-agents
Frequently asked

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.

Project homepage
https://evo-hq.com