hillclimb connect
Connect the coding agents (claude, codex, pi) and the OpenRouter route that pays for them.
hillclimb connect COMMAND [OPTIONS]Options
| option | what it does |
|---|---|
--json | The 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
| option | what it does |
|---|---|
--auth TEXT | Who pays: subscription (default) | api-key. |
--model TEXT | Model to ping with (default: the configured one). |
--probe / --no-probe | Make one tool-free coding agent call to prove the route works. Default: on. |
--login / --no-login | Run claude auth login when logged out. Default: on. |
--default / --no-default | Pin this coding agent as the default. Default: only when none is pinned there yet. |
--local / --user | Where 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
| option | what it does |
|---|---|
--auth TEXT | Who pays: subscription (default) | api-key | openrouter. |
--model TEXT | Model to ping with (default: the configured one). |
--probe / --no-probe | Make one tool-free coding agent call to prove the route works. Default: on. |
--login / --no-login | Run codex login when logged out or when the login no longer works. Default: on. |
--default / --no-default | Pin this coding agent as the default. Default: only when none is pinned there yet. |
--local / --user | Where 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
| option | what it does |
|---|---|
--key TEXT | The API key; omitted, connect asks for it (input hidden). |
--agent TEXT | Also route this coding agent through OpenRouter: codex | pi. |
--model TEXT | OpenRouter model id, e.g. qwen/qwen3-coder. |
--probe / --no-probe | Make one tool-free coding agent call to prove the route works. Default: on. |
--default / --no-default | Pin this coding agent as the default. Default: only when none is pinned there yet. |
--local / --user | Where 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
| option | what it does |
|---|---|
--auth TEXT | Who pays: subscription (default) | api-key | openrouter. |
--model TEXT | Model to ping with (default: the configured one). |
--probe / --no-probe | Make one tool-free coding agent call to prove the route works. Default: on. |
--default / --no-default | Pin this coding agent as the default. Default: only when none is pinned there yet. |
--local / --user | Where 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. |