vi-sql logo

Installation

Quick Install

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), Linux (amd64 / arm64), and WSL.

sh
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:

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

Version Pinning

Pin to a specific release by setting VI_SQL_VERSION before the curl command.

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

Build from Source

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

sh
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.

Uninstall

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

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