Install Volt

Volt is in public beta. Get the latest build from the download page or from GitHub Releases. Files are named volt-<channel>-<version>-<os>-<arch>.<ext>, for example volt-stable-0.0.2-darwin-arm64.dmg.

macOS

You need macOS 11 or later. The screenshots are from macOS 26; older versions look a little different, but the steps are the same.

On macOS 14 and earlier there is a shortcut: Control-click (or right-click) Volt in Applications, choose Open, then click Open in the dialog.

"Volt is damaged and can't be opened"

The app is not damaged. macOS shows this when the quarantine flag and the app's ad-hoc signature disagree, most often after a download was unpacked by a tool that changed the app. Remove the flag in Terminal and open it again:

xattr -dr com.apple.quarantine /Applications/Volt.app
open -a Volt

Install from the Terminal

This installs the latest Volt for macOS or Linux. It checks the download's SHA-256 against the release and needs no sudo:

curl -fsSL https://raw.githubusercontent.com/LeulAria/VOLT/main/install.sh | bash

On a Mac it puts Volt.app in /Applications (or ~/Applications when that is not writable). On Linux it unpacks into ~/.local/share/volt and links ~/.local/bin/volt. Set VOLT_VERSION=0.0.2 to pick a version, or VOLT_INSTALL_DIR to choose the folder. Read the script before you run it; it is short.

To do the same by hand on a Mac:

ARCH=arm64          # use x64 on an Intel Mac
VERSION=0.0.2

curl -fL -o ~/Downloads/Volt.dmg \
  "https://github.com/LeulAria/volt/releases/download/v${VERSION}/volt-stable-${VERSION}-darwin-${ARCH}.dmg"
hdiutil attach ~/Downloads/Volt.dmg -nobrowse -quiet
cp -R /Volumes/Volt/Volt.app /Applications/
hdiutil detach /Volumes/Volt -quiet
open -a Volt

Use Volt from the Terminal

Open Volt, press ⇧ ⌘ P and run Shell Command: Install 'volt' command in PATH. macOS asks for your password once, because it links volt into /usr/local/bin. Open a new terminal window afterwards:

volt .                        # open the current folder
volt ~/code/my-app            # open a project
volt --new-window ~/code/my-app
volt --version
volt --help

You can also start Volt without installing the command:

open -a Volt                  # launch Volt
open -a Volt ~/code/my-app    # open a folder in Volt
/Applications/Volt.app/Contents/Resources/app/bin/code --version

To remove the command, run Shell Command: Uninstall 'volt' command from PATH from the same palette.

Windows

volt .          # open the current folder
volt --version

Linux

# Debian, Ubuntu
sudo apt install ./volt-stable-0.0.2-linux-x64.deb

# Fedora, RHEL, openSUSE
sudo dnf install ./volt-stable-0.0.2-linux-x64.rpm

# Any distribution, no root: use the install script above, or unpack the tar.gz and run the volt binary inside
tar xzf volt-stable-0.0.2-linux-x64.tar.gz

Then run volt or volt ..

Beta and Nightly

Volt ships three channels. Each one is its own app, so you can install them next to each other without sharing settings, and trying Nightly never touches your Stable install. Pick a channel on the download page.

The first-launch steps are the same for every channel; the dialogs just say Volt Beta or Volt Nightly.

Updating

Volt checks for new versions and tells you when one is out.

• macOS: because the build is not signed with a Developer ID, macOS will not let Volt replace itself. Volt opens the download; install it the same way as above and choose Replace. You may need to confirm Open Anyway again for the new build.
• Windows: setup installs download in the background and update in place. A zip install shows the download instead.
• Linux: Volt opens the download page.

Your settings, chats and projects live in ~/.volt (and ~/Library/Application Support/Volt on a Mac), so they carry over.

Uninstall

# macOS
osascript -e 'quit app "Volt"'
rm -rf /Applications/Volt.app
rm -f /usr/local/bin/volt        # only if you installed the shell command
rm -rf ~/.volt "$HOME/Library/Application Support/Volt"   # deletes your settings and chats; leave it out to keep them

On Windows, remove Volt in Settings > Apps. On Linux, remove the package with apt remove volt or dnf remove volt, or delete ~/.local/share/volt.

Troubleshooting

Something else? Open an issue with your system, chip (uname -m on a Mac) and the Volt version (Volt, then About Volt). Once Volt is installed, connect an agent and start a chat with ⌘ N.