Troubleshooting
Fixes for the things people hit most.
The app won't install on my Mac
vivibe is built for Apple Silicon only. Intel Macs aren't supported.
The AppImage does not start on Linux
AppImages mount themselves with FUSE, which some systems do not have. Let it unpack itself instead: APPIMAGE_EXTRACT_AND_RUN=1 ./vivibe-linux-x64.AppImage. On Debian and Ubuntu, the .deb avoids this.
Simulate says Docker is off
Start Docker Desktop (or your Docker engine), then press run again.
The app says my account is not on the beta list
During the beta the app opens only for accounts whose email we approved. Ask to join with the email you sign in with (for Gmail, dots and +tags do not matter), then press Check again. A different email? Sign out and sign in with the approved one.
A call is missing from the diagram
If the engine can't resolve a call, it shows a gap rather than guess. Try Hermes → Complete the diagram, which suggests calls with file and line evidence.
Terminal sessions stop when I quit
Install tmux 3.2 or later (brew install tmux). vivibe uses it automatically.
brew install tmuxI don't see the Agent island
It needs a Mac with a notch, and is switched on in Settings → Agents. There is no Agent island on Linux.
Still stuck?
Contact us from the Support page.