vi-sql logo
v0.1.0 — now available

Terminal UI for your SQL databases

Highly customizable terminal SQL client with fast keyboard-driven navigation, extensive tooling, and built-in MCP server.

SQL
Open Source
Go
Multi-DB
Vim
MCP
$~ vi-sql ─ query editor
See it in action

Watch the introductory video

Features

Built for keyboard-driven work

Query, browse, and manage your database without leaving the terminal.

$~ vi-sql ─ vim mode
Vim-Motions

Vim and normal keybinding profiles

Ships with vim and normal profiles. Every keybinding is remappable — no hardcoded keys.

$~ vi-sql ─ command palette
Actions

Built-in command palette

Built-in command palette and discoverable shortcuts. Switch connections, change schemas, export results, run EXPLAIN.

$~ vi-sql ─ dracula theme
Themes

Multiple themes, fully configurable via YAML

Ships with multiple built-in themes. Creating a custom theme is just a YAML file.

Multi-Backend

Connect to any supported database. Schema browser, DDL inspection, and EXPLAIN ANALYZE plan viewer.

MCP Server

Safely expose your database to Claude, Cursor, and other AI tools via the Model Context Protocol.

Import & Export

Import CSV into any table. Export results as CSV, JSON, SQL INSERT statements, Markdown, or plain text — with optional gzip.

Encrypted Connections

Passwords encrypted at rest via OS keyring, master password (Argon2id), or environment variable. Never stored in plaintext by default.

01

Install

Run the install script — detects OS & arch, places binary in /usr/local/bin.

02

Connect

Pass a DSN with --connect, or launch and configure interactively.

03

Explore

Use vim motions (hjkl) to navigate through your schemas and tables.

04

Query

Press 'i' to enter SQL mode, write your query, hit Enter.