What you need
- macOS
- Bun and tmux (
brew install tmux) - Claude Code, signed in
- Codex and agy if you want them in the sidebar; each uses its own login
Install and start the server
One command installs it. It checks for Bun and tmux, builds the app, links the overvibe CLI, starts the server on http://127.0.0.1:7777 at login and opens the page, already logged in.
$ curl -fsSL https://overvibe.dev/install.sh | shOr install from a 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
The login link carries your token, so keep it out of chats, screenshots and logs.
Start your first session
- Press ⌥N, or ⌘N in the desktop app.
- Pick a folder. Folders you've used come first; type to search the rest. A path that doesn't exist yet gets a Create row.
- Choose Claude, Codex or agy. A name and a first prompt are optional.
The terminal opens and from there it is the CLI you know. Start one of each tool in the same project and they sit together under that project's name.
How each CLI is started
Every tool starts in its own auto mode, and sessions Overvibe starts trust their folder, since Overvibe answers that prompt for you.
| Tool | Started as |
|---|---|
| Claude Code | claude --permission-mode auto --remote-control |
| Codex | codex --approve-for-me, in its workspace sandbox with network on and your work root writable |
| agy | agy --mode auto --remote-control |
With Remote Control on, a Claude session can also be followed from the Claude app on your phone.
Reading the sidebar
Each row has a status dot. Teal is busy, grey is idle, and amber means the session needs you: a menu is open on its screen or its last reply asked you something. The browser tab title counts the amber ones, so a glance at the tab bar tells you whether anyone is waiting.
When a menu does show up, a dialog pops over the terminal with the same options. Clicking one moves the menu's cursor there and presses Enter in the session.
Closing the tab is safe
Sessions live on Overvibe's own tmux server, separate from the web server. Close the browser, restart the server, reload: they are all still there. From a terminal, tmux -L agent-deck ls lists them (the socket keeps the project's old name).
Questions
Do I need all three CLIs?
No. Claude Code is the one requirement. Codex and agy show up in the tool picker once they are installed and signed in.
Is agy the same as Gemini?
agy is Google's command-line agent for Gemini models. Overvibe starts it with agy --mode auto --remote-control.
Does Overvibe change how the CLIs behave?
No. It starts the real binaries in tmux and shows their terminal. Your skills, hooks and slash commands work unchanged.