docs/start here

Installation

Install the CLI, download the desktop app, or open the browser app.

Install the terminal CLI, download the desktop app, or open the browser app.

Terminal CLI

The host CLI runs on macOS 13 or later with Apple silicon or Intel processors. It also runs on Linux with x86_64 or aarch64 processors. Linux binaries use static musl linking.

Install minisign first. It verifies the release signature. On macOS:

brew install minisign

On Debian or Ubuntu:

sudo apt install minisign

Then install Vibeke:

curl -fsSL https://vibeke.dev/install.sh | sh

The installer downloads the latest published release installer from GitHub. It verifies the signature and binary checksum before installing.

Check your installation:

vibeke --version
vibeke doctor

If your shell cannot find Vibeke, add this line to your shell configuration and open a new terminal:

export PATH="$HOME/.local/bin:$PATH"

Continue with your first workspace.

Desktop app

Desktop downloads for Vibeke 0.27.0:

Operating systemArchitectureDownload
macOSApple silicon (ARM64)DMG · ZIP
macOSIntel (x86_64)DMG · ZIP
Linuxx86_64 / AMD64AppImage · DEB
Windowsx86_64 / AMD64EXE installer

Linux ARM64 and Windows ARM64 desktop packages are not included in this release.

See all release files and notes.

On macOS, open the DMG and drag Vibeke into Applications. On Windows, run the EXE installer. On Linux, choose the DEB for Debian-based systems or the AppImage for other distributions. The Linux desktop app requires an available Secret Service/keyring backend.

The desktop app connects to a Vibeke host. It does not bundle the host CLI. For local use on a supported Mac or Linux computer, install the CLI too. On Windows, connect to a remote host.

The macOS app is signed with an Apple Developer ID and notarized by Apple. The Windows installer is not publisher-signed. Windows can ask you to approve it.

Continue with the desktop connection guide.

Browser and phone

Open app.vibeke.dev. Pair it with your host using the phone and browser guide.

Update Vibeke

In the terminal interface, open the command palette with Ctrl+B, then : and choose Check for updates or Update Vibeke…. When a release is available, the sidebar shows its version. Review it and confirm installation; Vibeke reopens the same session and pane. Background checks run every six hours and can be turned off in the update view.

You can also update from the shell:

vibeke update --check
vibeke update

The updater verifies the signed release manifest and binary checksum. Running terminal processes survive the local session's restart. Other sessions use the installed version on their next restart; remote hosts are updated separately. Use vibeke update --rollback to return to the previous installed version when it can read your session databases. A rollback is refused if the target cannot confirm database compatibility or a newer schema is in use; restore a compatible backup offline before downgrading.

For desktop updates, use Check for Updates… in the app menu. See the desktop guide for in-app installation and manual download options.

Advanced installation

The CLI lives at ~/.local/share/vibeke/versions/<version>/vibeke. The installer creates links at ~/.local/share/vibeke/current and ~/.local/bin/vibeke.

To select a version, set the variable on the shell that runs the installer:

curl -fsSL https://vibeke.dev/install.sh | VIBEKE_VERSION=0.2.0 sh

For mirrors, offline installation, signatures, and development builds, see release verification. To contribute code, see building from source.

Next steps