Reference

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.

Terminal
brew install tmux

I 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.