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
| Subcommand | Description |
|---|---|
init | Prepare a repository for local searches. |
problems | Discover installed emflow problem targets. |
start | Start a search (hosted by default; --local runs it here). |
list | List hosted hillclimb search runs. |
watch | The watch TUI: runs, searches, candidates, live agent streams. |
chart | The hillclimb: best score so far, every candidate a dot. |
tree | One search's exploration tree. |
graph | The knowledge graph the searches grow. |
status | Plain-text search state. |
logs | Engine logs of a hosted run. |
stop | Gracefully stop a hosted search. |
promote | Fetch 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
| Argument | Description |
|---|---|
target | Problem target, e.g. emflow://gefcom2014:solar. |
Options
| Option | Description |
|---|---|
--budget, -b | Wall-clock budget, e.g. 2h, 30m (default 2h). |
--name, -n | Search name. |
--model, -m | Agent model, e.g. sonnet. |
--backend | Operator backend: claude-code (default), codex, or dummy (smoke tests). With only Codex connected (rebase connect codex) a hosted search defaults to codex. |
--policy, -P | Search engine: greedy (default), openevolve, gepa. |
--parallel-searches, -S | Independent searches under one hosted run; they share live knowledge (default 1). |
--parallel-operators, -O | Concurrent operators per search (hosted default 3). The job is sized from searches × operators. |
--max-cost | Agent-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, -c | Workspace 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-holdout | Hidden holdout selection (default on; disable only for smoke tests). |
--project, -p | Project for the platform run (default hillclimb). |
--local, -l | Run 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]
