rebase hillclimb

Start, watch, stop, and promote agentic model searches.

Synopsis

rebase hillclimb start <target> --budget 2h
rebase hillclimb watch <run-id>
rebase hillclimb status <run-id>
rebase hillclimb stop <run-id>
rebase hillclimb promote <run-id>

Subcommands

SubcommandDescription
initPrepare a repository for local searches.
problemsDiscover installed emflow problem targets.
startStart a search (hosted by default; --local runs it here).
listList hosted hillclimb search runs.
watchThe watch TUI: runs, searches, candidates, live agent streams.
chartThe hillclimb: best score so far, every candidate a dot.
treeOne search's exploration tree.
graphThe knowledge graph the searches grow.
statusPlain-text search state.
logsEngine logs of a hosted run.
stopGracefully stop a hosted search.
promoteFetch the selected model(s) into the workspace repo.

Requires the hillclimb extra: pip install "rebase-toolkit[hillclimb]".

init

rebase hillclimb init [DIRECTORY] [--force]

Creates the hillclimb/ dir (config, problems, specs, runs) used by --local searches and by the local TUI commands.

problems

rebase hillclimb problems [FAMILY] [--json]

start

Start a hillclimb search.

Synopsis

rebase hillclimb start <target> [--budget 2h] [--name NAME] [--model MODEL]
                       [--backend BACKEND] [--policy POLICY]
                       [--parallel-searches N] [--parallel-operators N]
                       [--max-cost USD] [--secret NAME] [--project PROJECT] [--local]

Arguments

ArgumentDescription
targetProblem target, e.g. emflow://gefcom2014:solar.

Options

OptionDescription
--budget, -bWall-clock budget, e.g. 2h, 30m (default 2h).
--name, -nSearch name.
--model, -mAgent model, e.g. sonnet.
--backendOperator backend: claude-code (default), codex, or dummy (smoke tests). With only Codex connected (rebase connect codex) a hosted search defaults to codex.
--policy, -PSearch engine: greedy (default), openevolve, gepa.
--parallel-searches, -SIndependent searches under one hosted run; they share live knowledge (default 1).
--parallel-operators, -OConcurrent operators per search (hosted default 3). The job is sized from searches × operators.
--max-costAgent-spend ceiling in USD per search. The platform reserves it once per engine at submit and each search parks (resumable) when its agent cost reaches it. Default: hosted.max_cost_usd in hillclimb/config.yaml, else the platform's default ($10). The platform caps what one search may declare; the workspace balance bounds it further.
--secret, -cWorkspace secret holding the agent credentials (CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY, CODEX_AUTH_JSON or OPENAI_API_KEY). Default: every one of hillclimb, hillclimb-claude and hillclimb-codex that exists, as written by rebase connect claude / codex, else the platform's own credentials. --claude-secret still works.
--holdout/--no-holdoutHidden holdout selection (default on; disable only for smoke tests).
--project, -pProject for the platform run (default hillclimb).
--local, -lRun on this machine instead of the platform.

list

List hosted hillclimb search runs in the active workspace.

rebase hillclimb list [--limit N] [--include result,parameters] [--json]

watch, chart, tree, graph

The engine's own TUIs. Without a run id they open the local hillclimb dir, exactly like the standalone hillclimb watch, chart, tree and graph. With a hosted run id they open on a live mirror of the search that the platform streams to your machine; the watch TUI's stop (s) and prune (x) keys reach the running job within seconds.

rebase hillclimb watch [<run-id>] [--search REF]
rebase hillclimb chart [<run-id>] [--search REF] [--detail] [--cost]
rebase hillclimb tree  [<run-id>] [--search REF]
rebase hillclimb graph [<run-id>]

--search is latest, a run id, or <run-id>/<search-id> inside the hillclimb dir (the mirror's run ids are the engine's, not the platform's). The mirror lives under ~/.cache/rebase/hillclimb/<sync-id>/.

status

Plain-text search state (candidates, best score, budget left, agent cost) of every search in the run; also shows the platform run status.

rebase hillclimb status <run-id>

logs

The engine logs of a hosted run, one per search of a fleet.

rebase hillclimb logs <run-id> [--lines N]

stop

Queue a graceful stop: every running search parks after its current operator finishes and can be resumed later. Delivered within seconds.

rebase hillclimb stop <run-id>

promote

Download every search's selected best/solution.py into the workspace repo (default models/<problem_id>.py). Review, commit, and open a PR; protected environments deploy through gitops. --pr opens the pull request on the connected repository instead.

rebase hillclimb promote <run-id> [--dest models] [--local] [--pr]

On this page