hillclimb climber
Climbers, the swappable search methods: list, copy, check.
Climbers — the shareable bundle that decides HOW to hillclimb (policies, operators, prompts, tuner): list them, start your own, check one before spending budget on it
hillclimb climber COMMANDhillclimb climber check
Conformance check for a climber — the cheap pre-verifier.
Resolves every module the block names, then replays every recorded journal (plus an empty one) through the climber's policies with no coding agent or verifier: two fresh instances must propose the same action at every budget point and a resumed one must agree with a live one (the resume contract), every referenced candidate must exist, the policies must never write, and the climber's prompts must lint clean. Exit 1 on any breach. --smoke follows up with a short --agent dummy search so the whole loop — prompts included — runs once before a coding agent hour is spent on it. Given a run spec, every entry's climber is checked.
hillclimb climber check [OPTIONS] [SPEC]Arguments
| argument | what it is |
|---|---|
SPEC | A run spec: check the climber of every entry (default: this folder's climber: block) optional |
Options
| option | what it does |
|---|---|
--climber TEXT | A .py file or climber folder, instead of the folder's block. |
--problem TEXT | Replay only this problem's recorded searches (default: every search). |
--set TEXT | Config override, dotted: --set climber.params.num_drafts=1. |
--limit INTEGER | Newest recorded searches to replay. Default: 20. |
--smoke | Then run a dummy-coding-agent search on --problem (no LLM, real verifier). |
--smoke-budget TEXT | Wall clock for the smoke search. Default: 2m. |
--json | Machine-readable output. |
hillclimb climber get
Copy a catalog climber into climbers/<name>/: the whole climber as Python you can read and edit.
hillclimb ships no climber of its own — a catalog of examples to copy from, like problem get. policy.py IS the climber: the selector policy (which candidate the next attempt starts from) and the operator policy (which operator makes it), every decision and every default (DEFAULTS) written out, and at the end the Climber(...) that wires them to the operators, tuner and memory — no config file; prompts/ holds the templates its operators render — the words the coding agents get — plus a README of what the harness fills into each template's tokens. It becomes this folder's climber, so edit policy.py or a template and the next hillclimb run climbs with it. An existing folder is never overwritten.
hillclimb climber get [OPTIONS] [PRESET]Arguments
| argument | what it is |
|---|---|
PRESET | A catalog climber to copy out: greedy | openevolve | gepa (see: hillclimb climber list) optional |
Options
| option | what it does |
|---|---|
--name TEXT | The folder's name under climbers/ (default: the catalog's). |
--default / --no-default | Make the copy this folder's climber (climber: in runs/config.yaml), so hillclimb run uses it. Default: on. |
hillclimb climber list
The catalog's climbers (climber get copies one out) and every climber under climbers/.
hillclimb climber list [OPTIONS]Options
| option | what it does |
|---|---|
--json | Machine-readable output. |
hillclimb climber new
Start your own climber from a copy of an existing one.
A climber folder (hillclimb climber get wrote it: policy.py builds the whole Climber, prompts/ beside it) is copied as climbers/<name>/. Any other source's file — the policies, or the loop — is copied into climbers/<name>.py, a one-file climber you can edit, and the block that runs it is printed.
hillclimb climber new [OPTIONS] NAMEArguments
| argument | what it is |
|---|---|
NAME | Name of the new climber (becomes climbers/<name>.py) required |
Options
| option | what it does |
|---|---|
--from TEXT | What to copy: a catalog climber's name or a local climber (.py file or folder). Default: greedy. |
hillclimb climber show
Print a climber as the block a run config takes.
Paste it under climber: in a run spec or in runs/config.yaml and edit it there: the block IS the climber. A pre-0.6 directory holding climber.yaml comes out as its block too — this is how one is migrated.
hillclimb climber show [REF]Arguments
| argument | what it is |
|---|---|
REF | A .py file, a climber folder, or a pre-0.6 climber directory (default: this folder's climber) optional |