LLM

cratis llm configures the language model that Cratis tools use. The CLI does not talk to a language model itself — it stores the provider settings in ~/.cratis/config.json, where tools such as Prologue pick them up, for example when interpreting a captured system.

cratis llm use <KIND>
cratis llm show
cratis llm clear

Providers

Kind	Description	Default model hint
anthropic	Anthropic's hosted API	claude-opus-4-6
openai	OpenAI's hosted API	gpt-4o-mini
local	Any OpenAI-compatible endpoint running on your own machine (e.g. Ollama, LM Studio)	none

cratis llm use <KIND>

Configures the provider and saves it to the configuration file. Values not passed as options are prompted for interactively when running in a terminal — the API key with hidden input, the endpoint only for local (where it is required), and the model with the provider's default pre-filled.

Option	Description
--api-key <KEY>	API key for the provider. Required for anthropic and openai; optional for local.
--endpoint <URL>	Endpoint URL. Required for local (e.g. http://localhost:11434/v1); the hosted providers use their own default endpoints.
--model <NAME>	Model to use. Optional — each hosted provider has a sensible default.

cratis llm use anthropic
cratis llm use openai --api-key sk-... --model gpt-4o-mini
cratis llm use local --endpoint http://localhost:11434/v1 --model llama3

When the terminal is not interactive (CI, piped input), all required values must be passed as options — a missing required value fails with a validation error and a non-zero exit code.

cratis llm show

Displays the configured provider. The API key is always masked — only the first and last four characters are shown, and keys too short to mask partially are hidden entirely. Global options such as -o/--output select the output format — see Global Options.

cratis llm clear

Removes the language model configuration, including the stored API key. Prompts for confirmation; pass -y/--yes to skip the prompt.

What is stored

The settings live in the llm section of ~/.cratis/config.json:

{
  "llm": {
    "kind": "anthropic",
    "apiKey": "sk-ant-...",
    "model": "claude-opus-4-6"
  }
}

Errors

Condition	Result
Unknown <KIND>	Validation error listing the valid kinds.
Missing API key for anthropic/openai in a non-interactive terminal	Validation error.
Missing --endpoint for local in a non-interactive terminal	Validation error.