ankra ai

Manage AI provider settings and the model catalog

ankra ai

Configure the organisation’s AI provider, credentials, custom OpenAI-compatible endpoints, and the model catalog the chat picker offers.

Mutations require the ai.manage permission (organisation admins by default); the provider status and the model listing are available to every member.

ankra ai anthropic

Manage the custom Anthropic API key

ankra ai anthropic delete

Remove the custom Anthropic API key

ankra ai anthropic delete [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra ai anthropic set

Store and validate a custom Anthropic API key (must start with sk-ant-).

ankra ai anthropic set [flags]

Flags

Flag	Default	Description
--api-key		Anthropic API key (starts with sk-ant-)
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai endpoints

Manage custom OpenAI-compatible endpoints

ankra ai endpoints create

Add a named OpenAI-API-standard endpoint (OpenRouter, vLLM, LiteLLM, Ollama, …). The server validates and probes the endpoint before saving; the API key is stored server-side and never returned.

ankra ai endpoints create [flags]

Flags

Flag	Default	Description
--api-key		API key for the endpoint
--base-url		OpenAI-compatible base URL (e.g. https://openrouter.ai/api/v1)
--name		Endpoint name
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai endpoints delete

Delete an endpoint and its stored key. Catalog models on it are removed too.

ankra ai endpoints delete <endpoint_id> [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra ai endpoints discover

Query the endpoint’s /models list so you know which model ids to reference.

ankra ai endpoints discover <endpoint_id> [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai endpoints list

List configured OpenAI-compatible endpoints

ankra ai endpoints list [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai endpoints update

Update an endpoint’s name, base URL, and optionally rotate its key. Omit —api-key to keep the stored key.

ankra ai endpoints update <endpoint_id> [flags]

Flags

Flag	Default	Description
--api-key		New API key (omit to keep the stored key)
--base-url		OpenAI-compatible base URL
--name		Endpoint name
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai models

Manage the organisation model catalog

ankra ai models create

Add a model to the catalog.

For an Ankra-managed Claude model pass —model-id (e.g. claude-opus-5). For a model served by a custom OpenAI-compatible endpoint, also pass —endpoint with the endpoint id (see ‘ankra ai endpoints list’).

ankra ai models create [flags]

Flags

Flag	Default	Description
--context-window	200000	Context window in tokens
--description		Short description
--enabled	true	Model is selectable in the picker
--endpoint		OpenAI-compatible endpoint id (omit for Ankra-managed Claude)
--key		Catalog key (lowercase slug; the model_mode value)
--max-output	8192	Maximum output tokens
--model-id		Provider model id (e.g. claude-opus-5 or gpt-4o)
--name		Display name shown in the picker
-o, --output		Output format: json or yaml (default: human-readable)
--sort-order	0	Sort order in the picker (lower first)
--supports-images	false	Model accepts image inputs
--supports-thinking	false	Model supports a thinking/reasoning channel
--supports-tools	true	Model supports tool calling
--tier		Auto-routing tier: expert, think, quick, or empty

ankra ai models delete

Delete a catalog model

ankra ai models delete <id|key> [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra ai models list

List the catalog models the chat picker offers

ankra ai models list [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai models reset

Revert the catalog to the built-in defaults

ankra ai models reset [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)
--yes	false	Skip the confirmation prompt

ankra ai models update

Update a catalog model addressed by its row id or catalog key.

Only the flags you pass are changed; the rest keep their current values. Editing a built-in default the first time materialises the catalog.

ankra ai models update <id|key> [flags]

Flags

Flag	Default	Description
--context-window	200000	Context window in tokens
--description		Short description
--enabled	true	Model is selectable in the picker
--endpoint		OpenAI-compatible endpoint id (omit for Ankra-managed Claude)
--key		Catalog key (lowercase slug; the model_mode value)
--max-output	8192	Maximum output tokens
--model-id		Provider model id (e.g. claude-opus-5 or gpt-4o)
--name		Display name shown in the picker
-o, --output		Output format: json or yaml (default: human-readable)
--sort-order	0	Sort order in the picker (lower first)
--supports-images	false	Model accepts image inputs
--supports-thinking	false	Model supports a thinking/reasoning channel
--supports-tools	true	Model supports tool calling
--tier		Auto-routing tier: expert, think, quick, or empty

ankra ai openai

Manage the legacy single OpenAI-compatible endpoint configuration.

For multiple endpoints and per-model routing prefer ‘ankra ai endpoints’ and ‘ankra ai models’; this command configures the single legacy endpoint the ‘openai_compatible’ provider uses.

ankra ai openai delete

Remove the legacy OpenAI-compatible endpoint

ankra ai openai delete [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra ai openai set

Store the legacy OpenAI-compatible endpoint

ankra ai openai set [flags]

Flags

Flag	Default	Description
--api-key		API key for the endpoint
--base-url		OpenAI-compatible base URL
--model		Model id to use
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai openrouter

Manage the organisation’s OpenRouter API key (bring your own key).

Store a key with ‘set’, then activate it with ‘ankra ai provider openrouter’. Removing the key while OpenRouter is the active provider resets the organisation to the Ankra-managed default.

ankra ai openrouter remove

Remove the organisation’s OpenRouter API key. When OpenRouter is the active provider the organisation falls back to the Ankra-managed default.

ankra ai openrouter remove [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra ai openrouter set

Store and validate an OpenRouter API key (must start with sk-or-).

Pass the key with —api-key, pipe it on stdin, or omit both to be prompted interactively. The interactive prompt masks the input; the key is never echoed or logged.

ankra ai openrouter set [flags]

Flags

Flag	Default	Description
--api-key		OpenRouter API key (starts with sk-or-; omit to read stdin or be prompted)
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai provider

Set the active AI provider for the organisation.

ankra Ankra-managed Claude models (the default). anthropic Your own Anthropic API key (set it first with ‘ankra ai anthropic set’). openai_compatible Your OpenAI-compatible endpoint (set it first with ‘ankra ai openai set’). openrouter Your own OpenRouter API key (set it first with ‘ankra ai openrouter set’).

ankra ai provider <ankra|anthropic|openai_compatible|openrouter> [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra ai status

Show the active AI provider and configured credentials

ankra ai status [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)