Installation

Homebrew (macOS / Linux)

brew tap kopecmaciej/vi-sql
brew install vi-sql

Quick Install (macOS / Linux / WSL)

The install script detects your OS and architecture, downloads the pre-built binary, and places it in /usr/local/bin (or ~/.local/bin if /usr/local/bin is not writable). Supports macOS (arm64 / amd64) and Linux (amd64 / arm64).

curl -fsSL vi-sql.com/install.sh | sh

tip

To inspect the script before running, view the source on GitHub.

To install to a custom directory, set VI_SQL_INSTALL_DIR before running:

VI_SQL_INSTALL_DIR=/usr/bin curl -fsSL vi-sql.com/install.sh | sh

Quick Install (Windows)

Run in PowerShell (Administrator recommended):

powershell

irm vi-sql.com/install.ps1 | iex

tip

To inspect the script before running, view the source on GitHub.

Version Pinning

macOS / Linux — set VI_SQL_VERSION before the curl command:

VI_SQL_VERSION=v0.0.3 curl -fsSL vi-sql.com/install.sh | sh

Windows — set $env:VI_SQL_VERSION before running:

powershell

$env:VI_SQL_VERSION="v0.0.3"; irm vi-sql.com/install.ps1 | iex

Build from Source

Requires Go 1.25+. Clone the repo and build the binary directly.

git clone https://github.com/kopecmaciej/vi-sql && cd vi-sql && go build -o vi-sql .

tip

Run vi-sql --paths to see the exact locations of the config file, keybindings, and log after installation.

Updating

In-app

When a new version is available, a yellow arrow appears in the top bar. Open the actions palette (: in vim mode, Ctrl+Space in normal mode) and select Update vi-sql to download and apply the latest release with a confirmation prompt.

Homebrew

brew upgrade vi-sql

Install script

Re-running the install script always fetches the latest release:

curl -fsSL vi-sql.com/install.sh | sh

Windows:

powershell

irm vi-sql.com/install.ps1 | iex

Uninstall

The uninstall script removes the binary and prompts before deleting config files.

curl -fsSL vi-sql.com/uninstall.sh | sh