↓ Ir para o conteúdo principal
Rogerio de Queiroz Junior

Primeiros passos

Versão documentada: v0.1.8

Tradução da página original em inglês, que é a referência se algo estiver diferente.

Tabela de conteúdos

Instalação
#

As releases trazem um .deb e um .rpm (Ubuntu 22.04, Debian 12, Fedora e mais novos) e um instalador de prévia para Windows (ainda sem atalhos globais, notificações do desktop, Open terminal nem os presets da bandeja). Por enquanto não há AppImage. Baixe-os da release mais recente e confira um download com sha256sum -c SHA256SUMS --ignore-missing. Para conferir que ele foi gerado pelo workflow de release deste repositório: gh attestation verify <arquivo> --repo rogeriojunior31/Vults.

No Arch Linux, gere o pacote com makepkg: packaging/aur/vults compila a release mais recente, packaging/aur/vults-git acompanha a main. Os dois compilam do código-fonte, então a primeira instalação demora um pouco. Eles ainda não estão no AUR.

git clone https://github.com/rogeriojunior31/Vults
cd Vults/packaging/aur/vults && makepkg -si

Ou compile do código-fonte:

git clone https://github.com/rogeriojunior31/Vults
cd Vults
npm install
npm run tauri dev        # executa
npm run bundle:linux     # ou gera o .deb e o .rpm em target/release/bundle/

O Linux precisa de webkit2gtk-4.1, gtk3, gtk-layer-shell, libayatana-appindicator, openssl, alsa-lib, gst-plugins-good (o WebKitGTK toca os sons da ilha pelo GStreamer) e do loader do Vulkan (para compilar, também cmake, os headers do Vulkan e glslc). No KDE Plasma, Hyprland, Sway e outros compositores com layer-shell, a ilha fica na borda de cima como um painel; no GNOME ela é uma janela comum, sempre por cima. Settings → General → Start with the desktop abre o Vults quando você entra na sessão.

Conectando seus agentes
#

Abra Set up agents… pelo ícone da bandeja e clique em Install hooks… ao lado de um agente. Você vê o arquivo que vai mudar, o diff exato e um botão Write the file; antes é feito um backup datado, e os hooks de outras ferramentas são mantidos. Remove hooks… tira só o que o Vults adicionou.

AgenteArquivoDepois de instalar
Claude Code~/.claude/settings.jsonNada: as novas sessões aparecem na ilha
Codex~/.codex/hooks.jsonAbra o Codex, digite /hooks e confie nos hooks do Vults (o Codex só roda um hook quando ele é confiável e está ligado); as configurações mostram quantos ainda esperam. Uma reinstalação pede de novo
Antigravity~/.gemini/config/hooks.jsonNada (ele pergunta no próprio terminal)
OpenCode~/.config/opencode/plugins/vults.js, um plugin nossoReinicie o OpenCode (os cards dele)
Qwen Code~/.qwen/settings.jsonReinicie o Qwen Code (os cards dele)
Copilot CLI~/.copilot/hooks/vults.json, um arquivo nossoReinicie o Copilot CLI (os cards dele)
Cursor~/.cursor/hooks.jsonReinicie o Cursor (ele pergunta no próprio prompt)
Factory Droid~/.factory/settings.jsonReinicie o Droid (ele pergunta no próprio prompt)
Kimi Code~/.kimi-code/config.tomlReinicie o Kimi (ele pergunta no próprio prompt)

Com CLAUDE_CONFIG_DIR, CODEX_HOME, QWEN_HOME, COPILOT_HOME, FACTORY_HOME_OVERRIDE, KIMI_CODE_HOME ou XDG_CONFIG_HOME definida, o arquivo nessa pasta é o usado (detalhes). O do Antigravity é sempre ~/.gemini/config/hooks.json: o GEMINI_CLI_HOME não o muda de lugar.

Outras ferramentas (Pi…) também podem reportar, com algumas linhas na própria configuração delas: veja Outros agentes.

Vindo do Vultures AI
#

O Vults se chamava Vultures AI até a 0.1.5; na primeira vez que abre, ele move as pastas antigas, a entrada do chaveiro e a de login para os nomes novos, e o .deb e o .rpm substituem o pacote antigo. Depois clique em Update hooks… ao lado de cada agente em Set up agents… (o Codex pede a confiança dele de novo).

Teclas
#

No Linux, de qualquer lugar: Ctrl+Alt+Space abre a ilha e entrega o teclado a ela, Ctrl+Alt+Y / Ctrl+Alt+N permitem ou negam o card da frente, Ctrl+Alt+J / Ctrl+Alt+K põem a próxima ou a sessão anterior na frente, e segurar Ctrl+Alt+V fala com o Zeca (todas elas).

Idioma
#

O Vults fala inglês, português do Brasil, espanhol e chinês simplificado. Ele segue o idioma do seu desktop; Settings → General → Language escolhe outro para a ilha, as configurações, a bandeja e as notificações. O que os seus agentes dizem fica nas palavras deles.

Próximos passos
#