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 system | Architecture | Download |
|---|---|---|
| macOS | Apple silicon (ARM64) | DMG · ZIP |
| macOS | Intel (x86_64) | DMG · ZIP |
| Linux | x86_64 / AMD64 | AppImage · DEB |
| Windows | x86_64 / AMD64 | EXE 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
- Your first workspace to start Vibeke in a project.
- Connect the desktop app to your host.
- Troubleshooting if the installation does not work.