Skip to content

Connect a model

A teammate runs either on Hotline Agent, the built-in agent, with a model from a provider you connect, or on a harness such as Claude Code or Codex that brings its own sign-in. On a server, connecting providers is a one-time step you do on the server itself. Your phone can’t do it.

Every command here runs as the account the desk runs as, against the running desk. hotline wire reads its parameters from standard input, never from the command line, so a key stays out of your shell history and the process list. Start with a variable for the account:

Terminal window
H="sudo -u $(systemctl show -p User --value hotline) HOTLINE_DATA_DIR=/var/lib/hotline/room hotline"

List the providers and their ids:

Terminal window
echo '{}' | $H wire providers.list

Then add a key, typing it at a hidden prompt so it doesn’t land in your history:

Terminal window
read -rs KEY && printf '{"providerId":"anthropic","label":"Server","secret":"%s"}' "$KEY" | $H wire credential.create; unset KEY

Ids include anthropic, openai, openrouter, google, xai, zai, zai-coding-plan, groq, deepseek, mistral and ollama-cloud. hotline status then lists the model under models.

For Ollama, give its address. No key is stored:

Terminal window
echo '{"baseUrl":"http://127.0.0.1:11434"}' | $H wire credential.connect_local

ChatGPT, GitHub Copilot, and the sign-in forms of OpenRouter and xAI use a browser sign-in that hotline wire can’t finish on its own yet. Use an API key for now, or connect the provider in the desktop app and use that machine.

A harness uses its own login, not Hotline’s, so a teammate on Claude Code needs no provider at all if Claude Code is signed in for the account the desk runs as. When that is you, your own login is the one it uses. When it is the hotline service account, harnesses live under its home (/var/lib/hotline), not yours. Sign in as it, for example:

Terminal window
sudo -u hotline -H bash -lc 'npx -y @anthropic-ai/claude-code' # then /login

When you add a teammate on the phone, the harness list shows what this server can run. Choose the signed-in harness there.