O arquivo config.yaml

O arquivo é criado automaticamente, com comentários, na primeira execução, em os.UserConfigDir()/kraa/config.yaml:

SO	Caminho
macOS	~/Library/Application Support/kraa/config.yaml
Windows	%AppData%\kraa\config.yaml
Linux	~/.config/kraa/config.yaml (ou $XDG_CONFIG_HOME)

Para abrir: Editar configuração na bandeja ou kraa config. Depois de salvar, use Recarregar configuração na bandeja: não é preciso reiniciar.

Referência

Chave	Tipo	Padrão	Descrição
hotkey	string	"CmdOrCtrl+Shift+Y"	Atalho global que abre o modal.
provider.base_url	string	"http://localhost:11434/v1"	Endpoint compatível com a API OpenAI. Obrigatório.
provider.api_key	string	""	Chave de API. A variável KRAA_API_KEY tem precedência.
provider.model	string	"llama3.2"	Modelo usado. Obrigatório. Também muda pelo seletor do modal.
provider.timeout_seconds	inteiro	60	Tempo máximo de uma requisição. 0 usa o padrão.
provider.temperature	número	0.2	Opcional, de 0 a 2. Menor = mais fiel ao texto. Sem a chave, vale o padrão do servidor. Veja Providers.
max_input_chars	inteiro	20000	Tamanho máximo do texto aceito. 0 usa o padrão.
profile.enabled	booleano	false	Envia o perfil ao LLM. Veja Perfil do usuário.
profile.text	string	texto genérico	Quem você é (cargo, stack, preferências). Até 2000 caracteres pela janela da bandeja.
actions	lista	8 ações	Ações do modal. Veja Ações customizadas.

Chaves omitidas voltam ao valor padrão. Se actions for omitida ou vazia, as 8 ações padrão voltam.

Arquivo padrão

hotkey: "CmdOrCtrl+Shift+Y"

provider:
  base_url: "http://localhost:11434/v1"
  api_key: ""
  model: "llama3.2"
  timeout_seconds: 60
  temperature: 0.2

max_input_chars: 20000

profile:
  enabled: false
  text: >-
    Sou profissional de tecnologia e uso IA no dia a dia de trabalho.
    Prefiro textos objetivos, com termos técnicos quando fizerem sentido.

actions:
  - id: improve-prompt
    category: Prompt
    label: Melhorar prompt
    use_profile: true
    instruction: >-
      Reescreva o prompt em <texto> para que um LLM o execute bem,
      preservando a intenção e todos os requisitos do autor. (...)
  # ...mais 7 ações padrão

Validação

Ao carregar, o app recusa a configuração e mostra o erro no modal quando:

• base_url ou model está vazio;
• timeout_seconds ou max_input_chars é negativo;
• temperature está fora do intervalo de 0 a 2;
• uma ação não tem id, label ou instruction, ou repete um id.

Variável de ambiente KRAA_API_KEY

Se definida e não vazia, substitui provider.api_key depois do carregamento. Ela nunca é gravada no arquivo, o que evita deixar a chave em texto plano.

export KRAA_API_KEY="sua-chave-aqui"