VibeHive

Install · Linux

Install VibeHive on Linux

x86_64 or ARM64 (aarch64) with glibc 2.35 or later: Ubuntu 22.04+, Debian 12+, Fedora 36+, Linux Mint 21+, Pop!_OS 22.04+, openSUSE Leap 15.5+, Arch and others.

Your download should start automatically.

VibeHive-2.0.0-linux-x86_64.AppImage. Didn’t start? Download again

VibeHive-2.0.0-linux-x86_64.AppImage

x86_64 · AppImage · Version 2.0.0

Download

Checksums are listed on the release page.

Optional: check the file. The output should match the SHA-256 on the release page.

sha256sum ~/Downloads/VibeHive-2.0.0-linux-x86_64.AppImage

Which architecture? uname -m prints x86_64 or aarch64 (ARM64). Which format? .deb for Ubuntu, Debian, Mint and Pop!_OS; .rpm for Fedora, RHEL and openSUSE; AppImage for anything else.

Install the AppImage

  1. Move it to a folder you own

    Keep the AppImage somewhere you can write to, such as ~/Applications, so it can update itself:

    mkdir -p ~/Applications && mv ~/Downloads/VibeHive-2.0.0-linux-x86_64.AppImage ~/Applications/ && chmod +x ~/Applications/VibeHive-2.0.0-linux-x86_64.AppImage
  2. Run it

    ~/Applications/VibeHive-2.0.0-linux-x86_64.AppImage

    The AppImage brings its own GStreamer: WebM video (VP8, VP9, Opus) plays out of the box; H.264 and AAC don’t.

  3. If it doesn’t start: FUSE 2

    AppImages need FUSE 2:

    sudo apt install libfuse2

    On Ubuntu 24.04 and later the package is libfuse2t64:

    sudo apt install libfuse2t64

    Or run it without FUSE:

    ~/Applications/VibeHive-2.0.0-linux-x86_64.AppImage --appimage-extract-and-run

Updates

VibeHive checks for updates about once a day and asks before installing one.

The AppImage replaces its own file, so keep it in a folder you can write to. If it can’t update itself, it offers the download instead.

Next steps

Your first minute in VibeHive.

  1. Open a project folder with Ctrl+Alt+O (Open Workspace…).
  2. Start an agent in a pane: pick one of the built-in agent CLIs (VibeHive installs it if it’s missing), or open a shell pane with Ctrl+Shift+N and run any terminal coding agent.
  3. When a pane turns amber, that agent needs you. Ctrl+Shift+↓ jumps to the one that has waited longest.
  4. Walk into your agents’ office, the HiveVerse, with Ctrl+4.

Changed your mind? VibeHive is easy to remove: see the uninstall guide.

Desktop integration

  • Wayland and X11: both run natively.
  • Tray icon: GNOME needs the “AppIndicator and KStatusNotifierItem Support” extension (Ubuntu includes it). KDE, Cinnamon, XFCE and MATE work as is.
  • Global shortcut Ctrl+Shift+K from other apps: always on X11; on Wayland it’s up to your desktop.

Troubleshooting

Blank or flickering window (some NVIDIA drivers)

Start VibeHive with the DMA-BUF renderer turned off:

WEBKIT_DISABLE_DMABUF_RENDERER=1 vibehive
The AppImage won’t start

It needs FUSE 2: sudo apt install libfuse2 (libfuse2t64 on Ubuntu 24.04+). Without FUSE, run it with --appimage-extract-and-run.

Videos don’t play

The AppImage plays WebM (VP8, VP9, Opus) only. The .deb and .rpm use your system’s GStreamer; add the plugins:

sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-libav
sudo dnf install gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugin-libav

On Fedora, H.264 needs gstreamer1-plugin-openh264 or RPM Fusion.

No tray icon on GNOME

Install and turn on the “AppIndicator and KStatusNotifierItem Support” extension. Ubuntu already includes it.

Ctrl+Shift+K doesn’t work from other apps

On Wayland, global shortcuts are up to your desktop environment. On X11 the shortcut always works.

Check that the download is intact

Run the sha256sum command from the download box above; its output should match the SHA-256 shown there.