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.3-darwin-arm64.dmg.

From 0.0.4, the Mac builds are signed with an Apple Developer ID and notarized by Apple, so they install like any Mac app and update themselves. The Windows installers are not code-signed yet, so Windows warns you the first time you run one; the Windows steps show how to get past it. The source is public, and you can build Volt yourself if you prefer.

macOS

Download the .dmg (arm64 for Apple silicon, x64 for Intel), open it and drag Volt to Applications. You need macOS 11 or later.

Volt 0.0.3 and older were not signed and cannot update themselves. Download the new version once and replace the app in Applications. Your settings and chats stay.

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.3 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.6

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.3-linux-x64.deb

# Fedora, RHEL, openSUSE
sudo dnf install ./volt-stable-0.0.3-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.3-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 install 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: Volt downloads and installs updates by itself. When one is ready, click Restart to Update. On 0.0.3 or older, download the new version once and replace the app.
• 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.