Junie CLI - Hostlinku Docs

Junie CLI — JetBrains’ terminal-based coding agent — supports custom model profiles in the form of JSON files. A single profile contains endpoints, API formats, API keys, as well as the main model and a faster model for light tasks. For the AI Assistant in JetBrains IDEs, see JetBrains AI Assistant.

Variant: Anthropic format

For the Claude model with the Messages API (full prompt caching), create a second profile, e.g., ~/.junie/models/hostlinku-claude.json:

{
  "displayName": "Hostlinku (Anthropic)",
  "id": "claude-sonnet-4-6",
  "baseUrl": "https://api.hostlinku.com/v1/messages",
  "apiType": "Anthropic",
  "apiKey": "${HOSTLINKU_API_KEY}",
  "fasterModel": { "id": "claude-haiku-4-5" }
}

Then run junie --model custom:hostlinku-claude.

What You Need to Know

${HOSTLINKU_API_KEY} is read from the environment when the profile is loaded. If the variable has not yet been When set, the profile fails to load and Junie reports the missing variable name—it’s safe to commit the profile to the repo (.junie/models/).
Main model vs. faster model. Choose a model with robust tool calling for the main model (claude-sonnet-4-6, gpt-5-5); more affordable models like claude-haiku-4-5 or deepseek-v4-flash are sufficient for faster tasks (summarization and classification).
Responses API (OpenAIResponses) is also available at https://api.hostlinku.com/v1/responses, but it is stateless (details). OpenAICompletion is the safest option.

Troubleshooting

Symptoms	Solutions
`404`	`baseUrl` is incomplete — it must end with `/v1/chat/completions` or `/v1/messages`.
Profile not found	Incorrect file name or location, or invalid JSON. Profile = filename without `.json`.
Environment variable error	Export `HOSTLINKU_API_KEY` in the shell running `junie`.
Tool call failed / agent is stuck in a loop	The model is too small for agentic coding — replace the main model with the one recommended in the Overview.

​Variant: Anthropic format

​What You Need to Know

​Troubleshooting

Variant: Anthropic format

What You Need to Know

Troubleshooting