Skip to main content

kapi config

kapi config [key] [value]

Read and write configuration.

App configuration (the global config file, typically ~/.config/kapi/kapi.yaml) uses the subcommands. Common keys: ai.provider default AI provider for translate / qa / brand-voice-check / flows (e.g. ollama to default to a free, on-device local model) ai.model default model for the AI provider

An explicit --provider/--model flag, inline config, or project recipe default always overrides these.

Installed plugins claim their own key namespaces, reached through the same subcommands (e.g. kapi config set bowrain.server.url https://…); there is no separate per-plugin config command. kapi config list shows every namespace.

Project recipe fields use the positional form: with one argument the key is printed, with two it is set and the recipe saved. Core keys: name, source_language, preset. Dotted keys edit a registered recipe block (e.g. server.url, server.stream on a connected project).

Commandconfig
Groupadvanced
Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

kapi config set ai.provider ollama # app config
Flags
FlagTypeDefaultDescription
--project, -pstringpath to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
More examples
kapi config get ai.provider
kapi config unset ai.model
kapi config list
kapi config set bowrain.server.url https://bowrain.example # plugin namespace
kapi config name # recipe: print the project name
kapi config name "My Project" # recipe: set the project name
kapi config server.url https://bowrain.example/acme/app

← Back to the Command Reference