cli / commands / connecthillclimb

hillclimb connect

Connect the coding agents (claude, codex, pi) and the OpenRouter route that pays for them.

hillclimb connect COMMAND [OPTIONS]

Options

optionwhat it does
--jsonThe same rows as data.

hillclimb connect claude

Claude Code as the coding agent, billed to your Claude subscription.

Operators run in a Claude Code home of hillclimb's own (~/.cache/hillclimb/claude-home), never your ~/.claude: your settings, plugins, skills, MCP servers and history neither change a search nor collect what it leaves behind. That home logs in once, here (claude auth login, run inside it); your own login is left as it is. The check strips ANTHROPIC_API_KEY, so a key left in the environment cannot masquerade as the subscription. --auth api-key keeps the key instead, for headless machines.

Headless with the subscription: run claude setup-token once on a machine with a browser, and export the token it prints as CLAUDE_CODE_OAUTH_TOKEN where hillclimb runs. Every operator, and this check, uses it in place of a login, so no claude auth login is needed there.

hillclimb connect claude [OPTIONS]

Options

optionwhat it does
--auth TEXTWho pays: subscription (default) | api-key.
--model TEXTModel to ping with (default: the configured one).
--probe / --no-probeMake one tool-free coding agent call to prove the route works. Default: on.
--login / --no-loginRun claude auth login when logged out. Default: on.
--default / --no-defaultPin this coding agent as the default. Default: only when none is pinned there yet.
--local / --userWhere the defaults (and an OpenRouter key) go: --user (the default) is ~/.config/hillclimb/, every folder on this machine; --local is this folder's hillclimb dir, overriding the user level for it alone.

hillclimb connect codex

The Codex CLI as the coding agent.

Operators run in a codex home of hillclimb's own (~/.cache/hillclimb/codex-home, with a HOME of its own too), never your ~/.codex or ~/.agents, so your settings, plugins and skills change neither a search's results nor its token bill. That home logs in once, here (codex login, run inside it) — a login of its own, not a copy of yours, which codex would invalidate the first time either refreshed. --auth openrouter bills OpenRouter credits instead (hillclimb connect openrouter first).

hillclimb connect codex [OPTIONS]

Options

optionwhat it does
--auth TEXTWho pays: subscription (default) | api-key | openrouter.
--model TEXTModel to ping with (default: the configured one).
--probe / --no-probeMake one tool-free coding agent call to prove the route works. Default: on.
--login / --no-loginRun codex login when logged out or when the login no longer works. Default: on.
--default / --no-defaultPin this coding agent as the default. Default: only when none is pinned there yet.
--local / --userWhere the defaults (and an OpenRouter key) go: --user (the default) is ~/.config/hillclimb/, every folder on this machine; --local is this folder's hillclimb dir, overriding the user level for it alone.

hillclimb connect openrouter

OpenRouter credits as the bill for codex or pi operators.

The only credential hillclimb stores itself: the key is validated against OpenRouter (one unbilled call), then written to a .env — the user-level one in ~/.config/hillclimb/, or with --local the one beside this folder's hillclimb.yaml that hillclimb init gitignores — never into hillclimb.yaml, where it could be journaled. --agent codex also pins the route.

hillclimb connect openrouter [OPTIONS]

Options

optionwhat it does
--key TEXTThe API key; omitted, connect asks for it (input hidden).
--agent TEXTAlso route this coding agent through OpenRouter: codex | pi.
--model TEXTOpenRouter model id, e.g. qwen/qwen3-coder.
--probe / --no-probeMake one tool-free coding agent call to prove the route works. Default: on.
--default / --no-defaultPin this coding agent as the default. Default: only when none is pinned there yet.
--local / --userWhere the defaults (and an OpenRouter key) go: --user (the default) is ~/.config/hillclimb/, every folder on this machine; --local is this folder's hillclimb dir, overriding the user level for it alone.

hillclimb connect pi

pi as the coding agent — the one that can sample.

pi logs in inside its own TUI, so this imports what that login wrote (~/.pi/agent/auth.json) into pi's isolated hillclimb home, together with pi.models_file if the config names one.

hillclimb connect pi [OPTIONS]

Options

optionwhat it does
--auth TEXTWho pays: subscription (default) | api-key | openrouter.
--model TEXTModel to ping with (default: the configured one).
--probe / --no-probeMake one tool-free coding agent call to prove the route works. Default: on.
--default / --no-defaultPin this coding agent as the default. Default: only when none is pinned there yet.
--local / --userWhere the defaults (and an OpenRouter key) go: --user (the default) is ~/.config/hillclimb/, every folder on this machine; --local is this folder's hillclimb dir, overriding the user level for it alone.