Referência

CLI kraa

Referência dos comandos instalados pelo pacote npm.

Uso: kraa <comando>

Comando	O que faz
`start`	Inicia o app em segundo plano (ícone na bandeja)
`stop`	Encerra o app
`trigger`	Dispara a captura no app em execução
`config`	Abre o `config.yaml` no editor
`autostart on\|off`	Liga/desliga o início com o sistema
`doctor`	Diagnostica a instalação e a conexão com o LLM
`install`	Baixa de novo o binário desta versão
`help`, `-h`, `--help`	Mostra a ajuda
`version`, `-v`, `--version`	Mostra a versão

Códigos de saída: 0 sucesso · 1 falha · 2 uso incorreto (comando desconhecido ou argumento inválido).

start

Inicia o app desanexado do terminal. Se o binário ainda não estiver instalado, baixa antes. No macOS usa open -a.

stop

Encerra o app (osascript no macOS, taskkill no Windows, pkill no Linux). Sai com 1 se o app não estiver rodando.

trigger

Faz a instância em execução capturar a seleção e abrir o modal, como o atalho global. É o mesmo que rodar o binário com --trigger, e é a forma de ter um atalho no Wayland (veja Linux).

config

Mostra o caminho do config.yaml e o abre no editor padrão (open -t, notepad ou xdg-open). O arquivo só existe depois da primeira execução do app.

autostart

kraa autostart on
kraa autostart off

Cria ou remove os mesmos artefatos usados pelo item Iniciar com o sistema da bandeja:

SO	Artefato
macOS	`~/Library/LaunchAgents/dev.matrixia.kraa.plist`
Windows	valor `Kraa` em `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`
Linux	`~/.config/autostart/kraa.desktop`

doctor

Verifica, em ordem:

se o binário está instalado;
se o config.yaml existe (e lê o base_url);
se o provider responde em {base_url}/models;
no Linux, se o xdotool existe e se a sessão é X11 ou Wayland.

Kraa — diagnóstico

[ok] Binário instalado: ~/.local/share/kraa/kraa
[ok] Configuração: ~/.config/kraa/config.yaml
[erro] Não foi possível conectar em http://localhost:11434/v1/models (connect ECONNREFUSED).
       Se estiver usando o Ollama local, inicie o servidor com: ollama serve
[ok] xdotool encontrado.
[ok] Sessão X11.

Sai com 1 se algum item crítico falhar.

Nota

A permissão de Acessibilidade do macOS é verificada pelo próprio app, não pelo doctor.

install

Baixa o binário da mesma versão do pacote npm, confere o SHA-256 e o instala. Use quando o download do npm i falhou ou para reinstalar.

Editar esta página