Start a coding agent on HIPS
Shell
hi <agent> [hi's options] [--] [the agent's own arguments]hi <agent> starts that coding agent on HIPS for one session: it finds the agent on this computer, checks its version, makes sure you are signed in, chooses the model, and starts the agent with HIPS's address, your sign-in and the model in that session's configuration. The agent then keeps its own commands, terminal, signals and exit code. hi never changes the agent's own settings, never puts a credential in its environment, files or arguments, and never reads another vendor's stored sign-in.
| Command | Agent | Its program |
|---|---|---|
hi claude | Claude Code | claude |
hi codex | Codex | codex |
hi opencode | OpenCode | opencode |
hi code | HIPS Code | hips |
hi kilo | Kilo | kilo |
hi pi | Pi | pi |
hi qwen | Qwen Code | qwen |
hi crush | Crush | crush |
hi cline | Cline | cline |
hi prime-agent | Prime Agent | prime-agent |
hi aider | Aider | aider |
hi goose | Goose | goose |
hi hermes | Hermes Agent | hermes |
hi grok | Grok Build | grok |
hi dsh | DeepSeek Harness | dsh |
- Command
hi claude- Agent
- Claude Code
- Its program
claude
- Command
hi codex- Agent
- Codex
- Its program
codex
- Command
hi opencode- Agent
- OpenCode
- Its program
opencode
- Command
hi code- Agent
- HIPS Code
- Its program
hips
- Command
hi kilo- Agent
- Kilo
- Its program
kilo
- Command
hi pi- Agent
- Pi
- Its program
pi
- Command
hi qwen- Agent
- Qwen Code
- Its program
qwen
- Command
hi crush- Agent
- Crush
- Its program
crush
- Command
hi cline- Agent
- Cline
- Its program
cline
- Command
hi prime-agent- Agent
- Prime Agent
- Its program
prime-agent
- Command
hi aider- Agent
- Aider
- Its program
aider
- Command
hi goose- Agent
- Goose
- Its program
goose
- Command
hi hermes- Agent
- Hermes Agent
- Its program
hermes
- Command
hi grok- Agent
- Grok Build
- Its program
grok
- Command
hi dsh- Agent
- DeepSeek Harness
- Its program
dsh
Each agent talks to HIPS in its own protocol, which the gateway serves: Anthropic's Messages API for Claude Code, the Responses API for Codex, chat completions for the rest.
After the agent's name, hi reads only its own options. The first argument that is not one of them, or a literal --, ends them, and everything after goes to the agent unchanged: hi claude --model <id> -p "..." sends -p "..." to Claude Code. An option the agent shares by name, such as Claude Code's own --model, is reached after --.
Without the pool, region, mode and fallback options, the workspace's tool defaults apply, as hi status shows them
| Option | What it does |
|---|---|
--model <id> | The catalog model for the session. Without it, HIPS_MODEL; else the model last used with that agent on this computer while it is still listed and fit; else the fit model with the largest context. One line names the model chosen |
--effort <level> | The agent's reasoning effort, low, medium or high, where the model offers one |
--pool <pool> | The pool for this session's requests: auto, certified or community |
--region <code> | The region for this session's requests, a code such as eu |
--mode <mode> | The pricing mode for this session's requests: market or stable |
--fallback <true|false> | Whether a request may run in the other pool |
--keep-agent-telemetry | Leaves the agent's own telemetry as you set it |
--check | Sends one small request to the model through the agent's configuration and shows the answer, the usage and the request id, instead of the session. It costs credit, and says so first |
- Option
--model <id>- What it does
- The catalog model for the session. Without it,
HIPS_MODEL; else the model last used with that agent on this computer while it is still listed and fit; else the fit model with the largest context. One line names the model chosen
- Option
--effort <level>- What it does
- The agent's reasoning effort,
low,mediumorhigh, where the model offers one
- Option
--pool <pool>- What it does
- The pool for this session's requests:
auto,certifiedorcommunity
- Option
--region <code>- What it does
- The region for this session's requests, a code such as
eu
- Option
--mode <mode>- What it does
- The pricing mode for this session's requests:
marketorstable
- Option
--fallback <true|false>- What it does
- Whether a request may run in the other pool
- Option
--keep-agent-telemetry- What it does
- Leaves the agent's own telemetry as you set it
- Option
--check- What it does
- Sends one small request to the model through the agent's configuration and shows the answer, the usage and the request id, instead of the session. It costs credit, and says so first
An unknown model id is refused before the agent starts, with the nearest listed ids; hi never corrects or substitutes one, and a model without tool calls is refused. Status and models has hi models.
Step 1:
hilooks for the agent's program on yourPATHand in its installers' usual folders. If it is missing,hinames the vendor's own installer and runs it only on your yes, at a terminal, never as root; without a terminal it prints the command and stops.Step 2: It reads the agent's version and compares it with the versions HIPS has tested on your system. Any other version is refused, with the tested versions named.
Step 3: It makes sure you are signed in, and runs
hi loginfirst when you are not.Step 4: Before the first launch in a workspace on this computer, it says which pool the workspace's requests, your source code in them, run in, and that the Community pool runs on GPU owners' machines.
Step 5: It turns off the agent's own telemetry for the session and says so in one line, then starts the agent.
HIPS tests each new release of every agent automatically, on each of Linux, macOS and Windows where the agent's vendor offers it, and publishes the versions that pass, per system, as a signed list, which hi reads at most once a day; a list without HIPS's signature is never used. A newer release than the list names is refused until it is tested, so a session never runs on a version HIPS has not seen. The agent's own auth, update and similar commands run as they are, with no sign-in.
For a session on HIPS, hi turns off the agent's own telemetry and its nonessential traffic to its vendor (for example CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC for Claude Code), and says once at launch what it turned off. --keep-agent-telemetry leaves it as you set it. Your sessions of the agent outside hi are untouched.
HIPS keeps no prompt or answer; your agent keeps its own history on your computer, as it does without HIPS.
Requests are billed to the workspace you chose at sign-in and appear in the Console as that sign-in's usage. The workspace's budget covers them: past it, the agent shows the gateway's 402 budget_exceeded as it shows any error. If the same model fails on one server, the gateway tries another before the first byte; hi never switches models for you.
Note
Every agent is unvalidated until its row of the supported-tools matrix records a dated test.
Related sheets
- Sheet
- 10 of 19
- Detail
- D
- Updated
- 2026-11-12