A ilha

A ilha fica pendurada na borda de cima da tela. No KDE Plasma, Hyprland, Sway e outros compositores com layer-shell, ela fica acima de todas as janelas, como um painel; no GNOME, é uma janela comum sempre no topo. No X11, ela aparece em todas as áreas de trabalho. Ela só pega o teclado enquanto você digita no chat, ou depois de Ctrl+Alt+Space (abaixo).

Com mais de uma tela, o desktop escolhe uma (em geral, a tela em foco na inicialização). Para fixar a ilha numa tela, escolha-a em Settings → General → Screen. Se essa tela sumir, a ilha passa para outra e volta quando ela retornar.

No Windows (uma versão de prévia) ainda não há atalhos globais, notificações do desktop, Open terminal nem predefinições na bandeja.

O bando

#

Cada sessão de agente é uma ave, um urubu. Um projeto é uma espécie: todas as sessões dele a compartilham, e ele a mantém toda vez que o app inicia. Uma pequena faixa na base de cada pescoço mostra o agente: laranja para Claude Code, verde-azulado para Codex, rosa para OpenCode, índigo para Qwen Code, azul para Copilot CLI, e violeta para qualquer outra ferramenta (Antigravity, Pi, Cursor…).

O Zeca não é uma sessão: ele fica no fio quando nada roda, e é com ele que você fala no chat. A sessão da frente (a que precisa de você, a que você clicou ou, senão, a primeira a chegar) ocupa o lugar dele. Toda outra sessão é um vult.

As aves encenam o que as sessões fazem: leem, bicam o fio enquanto editam, levantam voo para a web e abrem as asas quando uma permissão espera (com uma marca sobre a cabeça; ao amanhecer as aves em descanso abrem as delas ao sol, sem marca). Sessões novas chegam voando (uma que uma tarefa sua começou decola do lugar do Zeca na pílula, ou da ave da frente quando há uma lá); as que terminam vão embora. Com movimento reduzido, elas ficam nos poleiros. Settings → Flock & Zeca escolhe o conjunto de espécies, a espécie do Zeca e os visitantes raros. Animações lista cada clipe.

Os visuais sazonais do Zeca

#

O Zeca se veste para a estação: um chapéu de bruxa em outubro, um gorro de Papai Noel em dezembro, um chapéu de festa no Ano-Novo e orelhas de coelho na Páscoa, pela data do seu computador. Settings → Flock → Look (com o Zeca desenhado ao lado: no visual que você escolhe, com as próprias penas no Auto) mantém um visual o ano todo, ou nenhum, e acrescenta óculos escuros e catorze trajes sem estação. Clique com o botão direito no Zeca na ilha para escolher ali mesmo: ele veste o que estiver sob o ponteiro, um clique fica com ele, Escape o deixa como estava. Só o Zeca os usa.

Sem o Zeca

#

O Zeca é opcional. Settings → Flock & Zeca → Zeca o desliga; o bando continua funcionando: sessões no fio, cards de permissão e de pergunta, os atalhos de Allow / Deny, notificações, conectores e as predefinições. O que vai com ele:

• O chat, sua aba, os arquivos soltos na ilha, o Chat do Nest, o Chat… da bandeja, o microfone e o atalho de fala. Os medidores de uso ficam: eles leem as assinaturas dos seus agentes.
• O olá dele na inicialização.
• O lugar dele no fio: a sessão da frente fica ali como a própria ave, e sem ninguém rodando a pílula diz Nothing running.

Ligue-o de volta no mesmo lugar; sem reiniciar, nos dois casos.

Compacta, aberta e escondida

#

Compacta (o Mini do seletor de tamanho), a ilha é uma pequena pílula sem texto, só o bando: o Zeca à esquerda com a sessão da frente, até oito vults espalhados pelo fio e, embaixo, uma linha fina por plano com o uso dele, nas cores dos medidores de uso (âmbar a partir de 70%, vermelho a partir de 90%). Para as sessões, as cores significam o mesmo em todo lugar: âmbar para uma permissão, ciano para uma pergunta, verde quando concluiu, vermelho quando falhou. Um vult num desses estados usa um selo dessa cor e com uma forma própria, para que nenhum estado dependa só da cor: um triângulo para uma permissão, um losango para uma pergunta, um círculo quando concluiu, um quadrado quando falhou. Enquanto alguém precisa de você a borda da pílula pulsa em âmbar; quando uma sessão falhou (e ninguém precisa de você) ela fica vermelha; um ponto ciano no canto diz que um conector tem novidade. Deixe o ponteiro sobre um vult e ele olha para você (um que está no ar desce); clique nele para abrir a ilha na sessão dele, ou clique com o botão direito para as ações rápidas dele. As novidades de conectores esperam na ilha aberta.

Clique em qualquer outro ponto da pílula para abrir a ilha. Ela se recolhe 15 segundos depois que o ponteiro sai (uma linha fina embaixo faz a contagem; voltar com o ponteiro cancela). O seletor de tamanho no canto superior direito muda o quanto você vê, mantendo o que você olhava: Mini recolhe na hora para a pílula, Quick é a ilha, Room abre o Nest no que a ilha mostra (o bando, o chat, as suas conexões ou esta semana; as Settings a partir da engrenagem) e o botão de tela cheia ao lado o abre na tela toda. Enquanto um card espera, ele ocupa o lugar do bando. Settings → General → Fold the island define a espera.

Com Settings → General → Open on hover ligado, deixar o ponteiro sobre a pílula a abre sem clique. Aberta assim, ela se recolhe assim que o ponteiro sai, a não ser que você tenha clicado nela. Desligado por padrão, e não vale no Panel.

Duas coisas a mantêm aberta até você terminar:

• Um card de permissão. Ele abre a ilha sozinho e fica até você responder. Nada mais a abre sozinho: uma sessão que termina, falha ou pergunta algo toca seu som e ganha seu selo.
• O chat. A ilha nunca se recolhe enquanto você digita.

Sem ninguém no fio por um minuto, a ilha se esconde. Leve o ponteiro ao meio da borda de cima da tela para trazê-la de volta.

Presença: quanto ela mostra

#

Settings → General → Presence, ou o menu da bandeja (Linux), escolhe uma de quatro predefinições, na hora.

Nada esconde ou silencia um card pelo qual um agente espera: nem uma predefinição (exceto Paused), nem silenciar ou esconder um projeto, nem o Do not disturb. O card abre a ilha e espera o seu clique.

Paused é para nenhuma interrupção: permissões e perguntas, inclusive cards que já esperavam, vão para o terminal do agente, e suas regras Always não respondem nada. Os conectores param de verificar, e nenhuma notificação do desktop aparece. Escolha outra predefinição para voltar.

No painel

#

Nada é desenhado no topo da tela. O Zeca fica na bandeja do painel e mostra o estado do bando: empoleirado, trabalhando, de asas abertas com uma marca âmbar (algo espera por você), brilhos verdes (concluído), uma marca vermelha (falhou).

• Clique nele e a ilha abre no canto do painel. Ela se recolhe quando o ponteiro sai, com Mini ou Escape, e quando você abre as Settings.
• Clique com o botão direito nele para o menu: Chat… (com o Zeca ligado), Nest… (também com o Zeca desligado), Set up agents…, as quatro predefinições (Linux), Quit.
• Um card abre a ilha junto ao painel, e o Zeca chama atenção na bandeja até você responder. Allow e Deny são sempre cliques no card.
• Novidades de conectores tocam seu som mas não abrem a ilha: clique no Zeca para lê-las.

No KDE Plasma a ilha abre ao lado do painel que tem a bandeja; nos outros, no canto inferior direito. A bandeja precisa de um painel que mostre StatusNotifierItems (o Plasma mostra; no GNOME, a extensão AppIndicator, onde um clique esquerdo pode abrir o menu). Sem bandeja, inicie o Vults de novo para abrir as configurações.

Nas outras predefinições o Zeca também fica na bandeja, com os mesmos estados e menu, e um clique abre a ilha no topo.

O widget de canto

#

Settings → General → Corner widget põe uma pequena janela num canto que você escolhe; fica desligado até você escolher um. Funciona com todas as predefinições. Mostra até três aves (a sessão da frente, depois as que mais querem você) e quantas sessões precisam de você ou estão trabalhando. Uma borda âmbar significa que alguém precisa de você.

Clique nele para abrir a ilha, no card quando um espera. Clique numa ave para pôr a sessão dela na frente antes; se o card dessa ave espera atrás de outro, ele vem primeiro. O widget nunca responde a um card.

Ele fica longe dos painéis e embaixo de janelas em tela cheia. Sem layer-shell, é uma janela sempre no topo. Custa cerca de 40 MiB de memória enquanto está ligado.

Notificações do desktop

#

Só no Panel, onde a ilha fica fora de vista, o Vults também usa as notificações do desktop (qualquer desktop Linux com um servidor de notificações). No topo da tela a ilha já mostra tudo, então você nunca é avisado duas vezes; Paused não mostra nenhuma.

Elas avisam quando uma sessão terminou (com a primeira linha da resposta), falhou (com o erro), precisa de você (um card espera) ou ficou quieta. Cada sessão tem no máximo uma, com o nome do projeto no título; ela some quando o card é respondido, a sessão volta a trabalhar ou sai (uma sessão concluída sai do fio depois de 10 minutos, uma calada depois de 30). O que aconteceu enquanto elas estavam desligadas não é avisado depois.

Open (ou um clique) traz a ilha com aquela sessão na frente. Uma notificação nunca tem Allow nem Deny. Desligue-as em Settings → General → Notifications.

A ilha aberta

#

Aberta, o cabeçalho da ilha tem a marca e o nome, um botão de som, a busca (a paleta, como Ctrl+K), o seletor de tamanho e o botão de tela cheia. Embaixo, as cinco abas como ícones, como o protótipo as desenha:

• Flock, com quantas sessões precisam de você;
• Chat, do Zeca, numa forma compacta: o motor e as suas conversas no topo, o campo com um clipe (para entregar arquivos ao Zeca) e o microfone, a pasta e o modelo embaixo;
• Activity: esta semana, contada neste computador, os quatro números e uma barra por projeto (o maior primeiro; por dia quando nenhum projeto tem nome), e ‹ Previous week / This week;
• Connections, com quantas linhas os conectores mostram e você não marcou como vistas: um chip por conector e um card por linha, com Ask Zeca why, Review with Zeca, Squash and merge e ✓ (Conectores); sem nenhum ligado, + leva às Connections do Nest;
• Settings (a engrenagem): Presence e Fold the island ali mesmo; a lista de páginas também desenha Activity (o interruptor do histórico local) e Flock & Zeca (o interruptor do Zeca e de onde o bando vem) ali mesmo; qualquer outra página das Settings no Nest, e All settings (em Agents enquanto os hooks de um agente faltam ou estão desatualizados, em General nos outros casos).

Sobre as abas Chat, Activity, Connections e Settings, os chips das sessões que precisam de você ficam embaixo das abas; um deles abre a sessão. Activity tem Open in the Nest para o resto, e as suas tarefas ficam no Nest, a janela do próprio Vults, com abas próprias, que a seta no topo do chat também abre. A música e o uso dos seus planos ficam numa linha abaixo das abas. Embaixo, na largura toda da ilha (cerca de 500 px na tela, o Quick do seletor de tamanho):

• em repouso, o bando: o vult de cada sessão num fio, com o dobro do tamanho, o nome do projeto embaixo (numa caixa para a que está na frente) e ! quando precisa de você (até seis; além disso, cinco ficam e +N ocupa o último lugar, abrindo o Flock do Nest, em âmbar quando uma delas precisa de você), com o selo; deixe o ponteiro sobre um para ver o projeto, o agente e o que ele está fazendo. Embaixo do fio, um chip para cada sessão que pede um olhar: um card ou uma pergunta, uma falha, um pássaro quieto demais;
• uma sessão, quando você clica no vult ou no chip dela: ‹ Flock volta, e um ponto por sessão, na cor do agente, abre outra. Um card de permissão abre aqui sozinho e mantém a sessão na frente até você responder. À esquerda o Zeca, grande, com um brilho e uma marca na cor do estado da sessão (um ! âmbar para uma permissão, um ? ciano, brilhos verdes quando concluiu, um # vermelho quando falhou, suor num limite de uso); ao lado o projeto, o agente e o estado, e embaixo dos dois o card da sessão.

Um passo se lê como Editing main.rs, Running cargo build ou, para uma ferramenta MCP, Calling github · list_prs.

Uma edição concluída mostra as linhas que acrescentou e removeu (Editing main.rs +4 −2). Clique nelas para ver o diff no lugar do card, com números de linha quando o agente os manda (o Claude Code manda; os diffs do Codex não têm). × ou Esc volta. Os diffs ficam guardados para os últimos oito passos da sessão, até 400 linhas cada; um mais longo avisa que para antes.

OK diz que você viu: o selo some e a sessão aparece como ociosa. Sem ninguém no fio, o card oferece Ask Zeca.

O Zeca repara em você: olha para o ponteiro, ajeita as penas se você o deixa sobre ele e se assusta com um clique. Na inicialização ele diz olá, pelo seu primeiro nome quando a sua conta de usuário tem um nome completo (nunca tirado da rede).

Tocando agora

#

Ligue Settings → General → Now playing e a ilha mostra a música que o seu player está tocando (qualquer player que fale MPRIS: Spotify, uma aba do navegador, mpv). A ilha compacta a mostra quando nada roda; a ilha aberta a mostra na barra de cima, com anterior, tocar/pausar e próxima ao passar o ponteiro. Enquanto ela toca, o Zeca dança e as aves ociosas do bando fazem o cortejo no fio em vez de planar.

Uso da assinatura

#

A barra de cima da ilha aberta mostra quanto dos limites dos seus planos você já usou, ao lado do ponto de cada agente: 7d 12% é 12% da janela semanal. Fica âmbar em 70% e vermelho em 90%; passe o ponteiro para ver quando reinicia. Nenhum token seu é lido: cada número vem da CLI em que você fez login.

• Codex: com Settings → General → Codex usage ligado, consultado a cada 5 minutos, só leitura, nunca com a tela bloqueada. Chega à OpenAI pelo seu codex, então fica desligado numa instalação nova.
• Claude Code (Pro ou Max): ele só informa o uso a uma linha de status, então instalar os hooks acrescenta uma nossa, que roda a sua se você tiver uma (como). Os números chegam depois da primeira resposta de uma sessão.

Chegando a uma sessão

#

Clique num vult do bando para abrir aquela sessão; ela fica na frente até você escolher outra ou ela sair. Um card esperando ainda vem primeiro. Pelo teclado (Ctrl+Alt+Space), ↑ e ↓ passam de uma sessão a outra: em repouso o nome na caixa muda, numa sessão a próxima abre.

Open terminal no card dela traz o terminal para a frente:

• um painel do herdr, tmux, kitty ou wezterm, em qualquer desktop (o kitty precisa de listen_on unix:/tmp/kitty e allow_remote_control socket-only no kitty.conf);
• a própria janela do terminal, no KDE Plasma (Wayland ou X11) e em qualquer sessão X11, na sua área de trabalho e desminimizada (de várias janelas, primeiro a que tem no título a pasta da sessão);
• no GNOME, Hyprland ou Sway sob Wayland, só um terminal rodando pelo XWayland.

Quando não há nada para trazer, o card avisa. Uma sessão iniciada no terminal do VS Code ou do Cursor leva uma etiqueta VS Code ou Cursor, e o botão dela traz esse editor, no KDE e em sessões X11.

Os atalhos globais funcionam de qualquer janela:

• Ctrl+Alt+Y / Ctrl+Alt+N permitem ou negam a permissão na tela (Aprovações).
• Ctrl+Alt+J / Ctrl+Alt+K põem a próxima ou a anterior sessão na frente. Um card esperando fica na frente; as teclas escolhem quem vem depois dele.
• Ctrl+Alt+V, segurado, fala com o chat (Falar).
• Ctrl+Alt+1, Ctrl+Alt+2 e Ctrl+Alt+3 trocam para Mini, Quick e Room.
• Ctrl+K, na ilha aberta ou no Nest, abre a paleta.
• Ctrl+Alt+Space abre a ilha e entrega o teclado a ela até ela se recolher:
  • ↑ ↓ (ou K J) trocam a sessão da frente; Enter abre o terminal dela; M abre as ações rápidas dela; C abre o chat.
  • Y ou N respondem a uma permissão; 1 a 9 escolhem uma opção de uma pergunta.
  • Esc recolhe a ilha e devolve as teclas. No Wayland, é o caminho de volta ao seu terminal.

Aberta com um clique, a ilha não pega teclas. Os atalhos passam pelo portal do desktop: o KDE pergunta uma vez, e System Settings → Shortcuts muda as teclas (vale a pena se o seu editor usa Ctrl+Alt+J ou K, como as IDEs da JetBrains). Settings → General os lista.

Ações rápidas

#

Clique com o botão direito num vult da pílula ou do bando, ou no card de uma sessão (longe do Zeca) para as ações rápidas daquela sessão:

• Open terminal, como acima. Onde o desktop não consegue, fica acinzentado e oferece a pasta.
• Open folder: no VS Code quando code está no seu PATH, senão no gerenciador de arquivos. Só uma pasta que existe, pelo caminho completo, é aberta, sem shell.
• Activity: os últimos oito passos da sessão, cada edição concluída com seu diff.
• View the last diff, e Open its file in VS Code na primeira linha alterada (ou mostrá-lo na pasta; um arquivo nunca é executado nem aberto pelo programa associado ao tipo dele).
• Keep in front, ou Let the flock choose.
• Mute, Pin ou Hide this project, e This project’s bird… (abaixo).

O menu nunca tem Allow nem Deny, e não abre sobre um card esperando. Para chegar a um card que espera atrás de outro, veja Mais de um por vez.

Enquanto você estava fora

#

Com a tela bloqueada (num desktop que avisa pelo org.freedesktop.ScreenSaver, como o Plasma e o GNOME), a ilha descansa (sem animação) e os conectores param de verificar. Agentes e cards seguem como sempre.

Quando você desbloqueia, ou sai do Paused, uma linha diz o que aconteceu nesse meio-tempo: While you were away: 2 finished, 1 failed, 1 waits for you for 12 min. No Island ela abre a ilha uma vez; fica até você dispensá-la com ×. Projetos escondidos e silenciados ficam de fora.

Uma ave quieta

#

Uma sessão que está trabalhando e não manda nada por 5 minutos pode estar travada (um comando esperando entrada, uma ferramenta pendurada). A ave dela ganha um selo cinza: No news for 5 min. Aos 15 minutos o selo fica âmbar, um alerta toca e, no Panel, uma notificação avisa. Pensar por muito tempo não é sinalizado; qualquer novidade limpa o sinal.

O card oferece três respostas, e nenhuma mexe no agente:

• Snooze: some por 15 minutos, depois volta se ela ainda estiver quieta.
• Keep going: está tudo bem; o sinal cinza só volta depois de 30 minutos, o âmbar 10 minutos depois.
• Dismiss: nenhum sinal de novo até a próxima pergunta dela.

Cada resposta conta como novidade, então a ave fica no fio (uma calada sai depois de 30 minutos); depois de Keep going ela fica até o sinal poder voltar.

Por projeto: silenciar, fixar, esconder

#

Essas escolhas pertencem ao projeto (a pasta dele): toda sessão nela as segue, agora e depois.

• Mute: sem sons nem notificações quando as sessões dele terminam ou falham.
• Pin: as sessões dele vêm primeiro no fio, na pílula e no bando.
• Hide: as sessões dele ficam fora da ilha, da bandeja e do widget de canto.
• This project’s bird…: escolhe a espécie de todas as sessões dele; Automatic o devolve ao sorteio do bando.

Settings → Projects os lista, e é o caminho de volta para um projeto escondido.

Sons

#

Bipes curtos de 8 bits quando uma sessão precisa de você, termina ou falha, e para novidades de conectores; outros mais suaves quando a ilha abre ou se recolhe e quando o Zeca reage a você. O botão de alto-falante na ilha, ou Settings → General → Sounds, os desliga; Volume define o quão alto. Um card que continua esperando soa de novo, e o Do not disturb silencia sons e notificações por um tempo: veja Quando ninguém responde.