Do que você precisa
- macOS
- Bun e tmux (
brew install tmux) - Claude Code com login feito
- Codex e agy, se quiser eles na barra lateral; cada um usa seu próprio login
Instale e inicie o servidor
Um comando instala tudo. Ele confere o Bun e o tmux, faz o build do app, liga a CLI overvibe, configura o servidor em http://127.0.0.1:7777 para subir no login e abre a página com o login já feito.
$ curl -fsSL https://overvibe.dev/install.sh | shOu instale a partir de um clone:
$ git clone https://github.com/maribol/overvibe overvibe $ cd overvibe && sh install.sh # or, without the login agent: $ bun install && bun run dev # UI build watcher + server on http://127.0.0.1:7777 $ open "$(cat ~/.config/agent-deck/login-url)" # the link holds your token: keep it private
O link de login carrega o seu token, então mantenha ele fora de chats, capturas de tela e logs.
Inicie sua primeira sessão
- Aperte ⌥N, ou ⌘N no app de desktop.
- Escolha uma pasta. As que você já usou vêm primeiro; digite para buscar as outras. Um caminho que ainda não existe ganha uma linha Create.
- Escolha Claude, Codex ou agy. Nome e primeiro prompt são opcionais.
O terminal abre e, dali em diante, é a CLI que você já conhece. Inicie uma de cada ferramenta no mesmo projeto e elas ficam juntas sob o nome desse projeto.
Como cada CLI é iniciada
Cada ferramenta inicia no próprio modo auto, e as sessões que o Overvibe inicia confiam na pasta, já que o Overvibe responde esse pedido por você.
| Ferramenta | Iniciada como |
|---|---|
| Claude Code | claude --permission-mode auto --remote-control |
| Codex | codex --approve-for-me, no sandbox do workspace, com rede ligada e sua raiz de trabalho com permissão de escrita |
| agy | agy --mode auto --remote-control |
Com o Remote Control ligado, uma sessão Claude também pode ser acompanhada pelo app Claude no seu celular.
Como ler a barra lateral
Cada linha tem um ponto de status. Verde-azulado é ocupada, cinza é ociosa, e âmbar significa que a sessão precisa de você: há um menu aberto na tela dela ou a última resposta perguntou algo. O título da aba do navegador conta as âmbar, então uma olhada na barra de abas diz se alguém está esperando.
Quando aparece um menu, um diálogo surge sobre o terminal com as mesmas opções. Clicar em uma delas move o cursor do menu até ela e aperta Enter na sessão.
Fechar a aba é seguro
As sessões ficam no servidor tmux próprio do Overvibe, separado do servidor web. Feche o navegador, reinicie o servidor, recarregue: estão todas lá. Em um terminal, tmux -L agent-deck ls lista as sessões (o socket mantém o nome antigo do projeto).
Perguntas
Preciso das três CLIs?
Não. Só o Claude Code é obrigatório. Codex e agy aparecem no seletor de ferramenta depois de instalados e com login feito.
O agy é o mesmo que o Gemini?
O agy é o agente de linha de comando do Google para os modelos Gemini. O Overvibe inicia ele com agy --mode auto --remote-control.
O Overvibe muda o comportamento das CLIs?
Não. Ele inicia os binários reais no tmux e mostra o terminal deles. Seus skills, hooks e comandos de barra funcionam sem mudança.