Skip to main content

​
Install Avibe

Avibe runs locally on the machine where your data and coding agents live.

​
Desktop app

The desktop app for macOS and Windows bundles everything Avibe needs, including Python and Node, so there is nothing else to install first. Download the installer for your machine: These links always point to the newest stable release. Every release, with its checksums, is also on GitHub Releases.
  • macOS: open the DMG, drag Avibe to Applications, and launch it. The app is signed with Avibe’s Developer ID and notarized by Apple. If macOS says it is damaged or cannot be verified, do not override the warning: delete the download and fetch it again.
  • Windows: run the installer. It is not code-signed yet, so Windows may show a SmartScreen or unknown-publisher prompt. Choose More info > Run anyway only if your machine’s policy allows it.
The app opens the setup wizard in its own window and checks for updates each time it starts. Claude Code, Codex, and OpenCode are detected if you already have them, or installed when you select them. Sessions, settings, and credentials stay in ~/.avibe, so reinstalling the app keeps them. Closing the window does not stop Avibe. To uninstall, choose Uninstall Avibe… in the app’s menu first, which also removes the app’s private runtime and the agents it installed, then delete the app (macOS) or use the Windows uninstaller. Your data in ~/.avibe is kept.

​
macOS and Linux

Open source — view the script on GitHub or audit it before running. The short URL is a 307 redirect to that file. Verify the install:
Start the service and setup wizard:

​
Windows

The recommended Windows path is WSL:
  • Use Windows for your browser and chat apps.
  • Use Ubuntu in WSL for Avibe, agent CLIs, and your code repository.
From Ubuntu in WSL:
Native PowerShell installation is available, but WSL is usually smoother for Python, Node, Git, and coding agent CLIs:
On a native Windows install, the built-in Vibey agent runs its commands in PowerShell; under WSL it uses bash.

​
Audit before running

Prefer to read the script before piping it to bash? Fetch it locally first, inspect it, then run it:
https://avibe.bot/install.sh is a 307 redirect to the same file on GitHub raw, so both URLs serve identical content.

​
What the installer does

The installer:
  • Installs the vibe CLI.
  • Uses PyPI first and falls back to GitHub when needed.
  • Prints PATH guidance if the command is installed but not visible in the current shell.
  • Leaves model credentials (a subscription sign-in or an API key) for the setup wizard, and chat platform credentials for Settings > Messaging Platforms.

​
Upgrade

Re-run the installer:

​
Uninstall

Run the installer with --uninstall. It stops Avibe, then removes every vibe command and install file it put on this machine. A vibe it did not install is left alone. Your settings, sessions, and other data in ~/.avibe (and the legacy ~/.vibe_remote) are kept:
To delete your data too, add --purge. It lists everything it will delete and asks before deleting. Deleted data cannot be recovered. Where no terminal can answer, it also needs --yes.
For a native PowerShell install, run the Windows installer with -Uninstall. Add -Purge to delete your data too, and -Yes where the session cannot prompt for confirmation:
The uninstaller never deletes through a link. Anything behind a link is reported for you to remove yourself.