Quickstart
Get Weco running in your own codebase in a couple of minutes. Paste one prompt into your AI coding assistant and it sets everything up.
The fastest way to start is to let your AI coding assistant set up Weco and find what's worth optimizing. Paste this prompt into your agent (Claude Code, Cursor, etc.):
Help me set up Weco in this repository and choose a useful first run.
First inspect the repository and propose one measurable optimization target. Ask for my approval before installing anything or starting a run.
After I approve:
1. Install the Weco CLI with: curl -fsSL https://weco.ai/install.sh | sh
2. Run: weco setup
3. Guide me through: weco login
4. Start the approved run.
5. Show me where to observe progress and how to steer the search with follow-up prompts.The Weco skill will help you find something to optimize, write an evaluation, run an optimization, and report the results.
Prefer the command line?
If you don't use an AI coding assistant, you can drive Weco yourself from the terminal. See Optimize with the CLI.
Overview
Weco is a steerable, traceable autoresearch engine that iteratively rewrites your code to improve a metric you define.
How Weco works
The mental model behind Weco - autoresearch, the solution tree, and the vocabulary (run, step, node, branch, subtree, lineage, baseline) used throughout the docs.