Skip to main content

​
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
FlagDefaultDescription
--yesfalseSkip 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
FlagDefaultDescription
--api-keyAnthropic API key (starts with sk-ant-)
-o, --outputOutput 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
FlagDefaultDescription
--api-keyAPI key for the endpoint
--base-urlOpenAI-compatible base URL (e.g. https://openrouter.ai/api/v1)
--nameEndpoint name
-o, --outputOutput 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
FlagDefaultDescription
--yesfalseSkip 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
FlagDefaultDescription
-o, --outputOutput format: json or yaml (default: human-readable)

​
ankra ai endpoints list

List configured OpenAI-compatible endpoints 
ankra ai endpoints list [flags]
Flags
FlagDefaultDescription
-o, --outputOutput 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
FlagDefaultDescription
--api-keyNew API key (omit to keep the stored key)
--base-urlOpenAI-compatible base URL
--nameEndpoint name
-o, --outputOutput 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-4-8). 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
FlagDefaultDescription
--context-window200000Context window in tokens
--descriptionShort description
--enabledtrueModel is selectable in the picker
--endpointOpenAI-compatible endpoint id (omit for Ankra-managed Claude)
--keyCatalog key (lowercase slug; the model_mode value)
--max-output8192Maximum output tokens
--model-idProvider model id (e.g. claude-opus-4-8 or gpt-4o)
--nameDisplay name shown in the picker
-o, --outputOutput format: json or yaml (default: human-readable)
--sort-order0Sort order in the picker (lower first)
--supports-imagesfalseModel accepts image inputs
--supports-thinkingfalseModel supports a thinking/reasoning channel
--supports-toolstrueModel supports tool calling
--tierAuto-routing tier: expert, think, quick, or empty

​
ankra ai models delete

Delete a catalog model 
ankra ai models delete <id|key> [flags]
Flags
FlagDefaultDescription
--yesfalseSkip the confirmation prompt

​
ankra ai models list

List the catalog models the chat picker offers 
ankra ai models list [flags]
Flags
FlagDefaultDescription
-o, --outputOutput 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
FlagDefaultDescription
-o, --outputOutput format: json or yaml (default: human-readable)
--yesfalseSkip 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
FlagDefaultDescription
--context-window200000Context window in tokens
--descriptionShort description
--enabledtrueModel is selectable in the picker
--endpointOpenAI-compatible endpoint id (omit for Ankra-managed Claude)
--keyCatalog key (lowercase slug; the model_mode value)
--max-output8192Maximum output tokens
--model-idProvider model id (e.g. claude-opus-4-8 or gpt-4o)
--nameDisplay name shown in the picker
-o, --outputOutput format: json or yaml (default: human-readable)
--sort-order0Sort order in the picker (lower first)
--supports-imagesfalseModel accepts image inputs
--supports-thinkingfalseModel supports a thinking/reasoning channel
--supports-toolstrueModel supports tool calling
--tierAuto-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
FlagDefaultDescription
--yesfalseSkip the confirmation prompt

​
ankra ai openai set

Store the legacy OpenAI-compatible endpoint 
ankra ai openai set [flags]
Flags
FlagDefaultDescription
--api-keyAPI key for the endpoint
--base-urlOpenAI-compatible base URL
--modelModel id to use
-o, --outputOutput 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’). 
ankra ai provider <ankra|anthropic|openai_compatible> [flags]
Flags
FlagDefaultDescription
-o, --outputOutput format: json or yaml (default: human-readable)

​
ankra ai status

Show the active AI provider and configured credentials 
ankra ai status [flags]
Flags
FlagDefaultDescription
-o, --outputOutput format: json or yaml (default: human-readable)