Plugin Keystroke no Omarchy

O Keystroke substitui o menu do Omarchy por uma paleta de comandos no estilo do Raycast. Um único campo aceita nomes de aplicativos, rotas do menu, cálculos, conversões, cores, emojis, histórico do clipboard, arquivos e perguntas ao Codex. O Smart Match completa a busca com um modelo de embeddings que roda na sua máquina.

Como o manifest declara omarchy.clonedFrom: "omarchy.menu", habilitar o plugin faz o Super+Space, os vínculos de omarchy-menu e os seletores omarchy-menu-select e omarchy-menu-input chegarem à paleta. Desabilitar ou remover devolve o menu original do sistema.

Antes de instalar

O README exige Omarchy 4.0.2 ou mais recente, com Quickshell 0.3 e Qt 6.11. O plugin roda sem sandbox dentro do shell.

O Smart Match baixa um modelo de 8 MB na primeira consulta e usa um binário x86_64 incluído no plugin, com 16 MiB residentes. Em outra arquitetura, o cargo compila o motor uma vez. Sem toolchain Rust, o python3 com uv instala o runtime equivalente. A busca comum continua disponível durante a configuração, e depois dela o Smart Match funciona offline. A voz depende do voxtype, que o Omarchy instala em Install › AI › Dictation.

Instale e coloque o botão na barra

1
omarchy plugin add https://github.com/evindor/keystroke.git --enable

O comando habilita a paleta como menu e coloca o botão do menu como widget de barra, depois dos workspaces. Para deixá-lo no começo da barra:

1
omarchy bar move evindor.keystroke left --index 0

Para um plugin de terceiros, estar habilitado significa estar citado em shell.json. Tirar o botão da barra também desabilita o menu. Para manter a paleta sem o botão, deixe o plugin em plugins[] no arquivo ~/.config/omarchy/shell.json.

Use a paleta

Digite um prefixo como tr, timer ou : e a linha abaixo do campo nomeia a ação e o argumento atual, enquanto os argumentos que faltam aparecem depois do cursor. A barra / lista todos os comandos com a forma de uso. Cada provedor tem uma tela própria com exemplos. Ações destrutivas do Omarchy, como desligar, reiniciar, sair, hibernar e remover programas, solicitam confirmação. Essa confirmação pode ser desligada em Settings › Omarchy.

A paleta também encontra arquivos e pastas a partir de duas letras, com abreviações como dwnlds para Downloads. Enter abre o resultado, Ctrl+Enter abre um terminal no local. O histórico do clipboard entra na mesma lista, e o Ctrl+Enter cola a entrada na janela anterior, com Ctrl+Shift+V em terminais e Ctrl+V nos demais programas.

Ajuste o Smart Match e a voz

Keystroke Settings › Matching traz três modos de Smart Match: desligado, só voz ou voz e texto, que é o padrão. O modelo pode ser pequeno (2M), o padrão, ou grande (8M), baixado uma vez no primeiro uso. O runtime roda na CPU, sai da memória depois de dois minutos sem uso e guarda os arquivos em ~/.local/share/keystroke/matching. Se a instalação falhar, a busca comum continua. Retry Smart Match tenta de novo.

Para ditar, aperte o atalho outra vez com a paleta aberta ou segure Super+Space: a paleta começa a ouvir e encerra a gravação quando você solta. Settings › Voice › Hold-to-talk bindings grava os dois vínculos em ~/.config/hypr/bindings.lua dentro de um bloco marcado. A transcrição entra no campo. O Enter seguinte executa a seleção visível.

Configuração, estado e extensões

Tudo fica em um único arquivo, editável à mão e recarregado sem reiniciar: ~/.config/omarchy/keystroke.json. As telas de configuração são geradas a partir do schema de cada provedor e ficam pesquisáveis pela paleta.

O uso fica em ~/.local/state/keystroke/usage.json, com identificadores em hash e sem o texto das consultas. As extensões incluídas, como Timer, Translate, Currency e Keyboard Cleaner, chegam desligadas. Ao ativar uma, a paleta avisa que o código foi revisado antes da distribuição e que ele roda por sua responsabilidade. Extensões que você escreve ficam em ~/.local/share/keystroke/extensions/ e aparecem na próxima abertura.

Atualize e remova

1
omarchy plugin update evindor.keystroke
2
omarchy plugin remove evindor.keystroke

Remover o plugin devolve o menu original do Omarchy. O estado da paleta e as extensões próprias continuam no disco. Você pode apagar ~/.local/state/keystroke e ~/.local/share/keystroke para limpar tudo. O README também documenta bin/keystroke uninstall para instalações feitas a partir do código.