cli / commands / climberhillclimb

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 COMMAND

hillclimb 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

argumentwhat it is
SPECA run spec: check the climber of every entry (default: this folder's climber: block) optional

Options

optionwhat it does
--climber TEXTA .py file or climber folder, instead of the folder's block.
--problem TEXTReplay only this problem's recorded searches (default: every search).
--set TEXTConfig override, dotted: --set climber.params.num_drafts=1.
--limit INTEGERNewest recorded searches to replay. Default: 20.
--smokeThen run a dummy-coding-agent search on --problem (no LLM, real verifier).
--smoke-budget TEXTWall clock for the smoke search. Default: 2m.
--jsonMachine-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

argumentwhat it is
PRESETA catalog climber to copy out: greedy | openevolve | gepa (see: hillclimb climber list) optional

Options

optionwhat it does
--name TEXTThe folder's name under climbers/ (default: the catalog's).
--default / --no-defaultMake 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

optionwhat it does
--jsonMachine-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] NAME

Arguments

argumentwhat it is
NAMEName of the new climber (becomes climbers/<name>.py) required

Options

optionwhat it does
--from TEXTWhat 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

argumentwhat it is
REFA .py file, a climber folder, or a pre-0.6 climber directory (default: this folder's climber) optional