# Install vi-sql with Homebrew

Terminal UI for SQL databases. Version 0.6.0 via Homebrew; verified 2026-10-08.

## Install

```sh
sudo av install brew:vi-sql
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vi-sql
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:vi-sql
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/vi-sql>
- **Version:** 0.6.0
- **Source summary:** Terminal UI for SQL databases
- **Homepage:** <https://vi-sql.com>
- **Repository:** <https://github.com/kopecmaciej/vi-sql>
- **Upstream docs:** <https://vi-sql.com>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/kopecmaciej/vi-sql/archive/refs/tags/v0.3.0.tar.gz>
- **Last updated:** 2026-10-08T18:56:11Z
- **Generated:** 2026-10-12T03:48:17+00:00

## Executables

- vi-sql (cli)
- vi-sql (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-10-12
- Package-manager version: 0.6.0
- Package-manager updated: 2026-10-08
- Local data: ok
- Upstream repository: https://github.com/kopecmaciej/vi-sql
- Upstream latest detected: v0.3.0 (current)

## From the blog

- [vi-sql and the Return of Keyboard-First Database Work](https://pkg.so/blog/2026-08-13/vi-sql-keyboard-first-database-work/)
## Project history and usage

vi-sql is a customizable, keyboard-driven terminal SQL client with database browsing, editing, query analysis, import/export, encrypted connection profiles, and an optional MCP server.

### Project history

vi-sql is an open-source Go terminal interface for SQL databases. Its official materials describe support for PostgreSQL-family servers, MySQL-family servers, and SQLite, alongside a multi-tab editor and database-object browser.

### Adoption history

vi-sql is distributed as downloadable binaries, through its installation script, Homebrew, and from source. It targets terminal users who want database browsing and editing without moving to a graphical SQL client.

### How it is used

Run vi-sql and enter connection details interactively, pass a PostgreSQL, MySQL, or SQLite DSN with --connect, or select a saved connection by name. Use vi-sql --paths to print the resolved configuration and ancillary paths. The optional local MCP endpoint is disabled by default and separates read and write permissions.

### Why package nerds care

vi-sql combines a keyboard-driven SQL TUI with schema browsing, query-plan inspection, import/export, customizable YAML themes, encrypted saved connections, and an HTTP MCP server. The blend of Vim-style interaction and controlled AI-tool access is its distinctive packaging niche.

### Timeline

- 2026: The official website advertises the 0.2 series and presents vi-sql as an open-source, multi-database terminal client.

### Related projects

- PostgreSQL
- MySQL
- MariaDB
- CockroachDB
- SQLite
- Model Context Protocol
- Vim

### Sources

- <https://github.com/kopecmaciej/vi-sql#readme>
- <https://vi-sql.com/>
- <https://vi-sql.com/docs>
- <https://vi-sql.com/docs/config>


## Security Notes

No matching local secret-handling manifest was found for vi-sql. Package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: $XDG_CONFIG_HOME/vi-sql/config.yaml, ~/.config/vi-sql/config.yaml
- macOS: ~/Library/Application Support/vi-sql/config.yaml
- Windows: %LOCALAPPDATA%\vi-sql\config.yaml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** vi-sql
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://pkg.so/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew.
- [beads_viewer](https://pkg.so/brew/beads-viewer/) - Local package facts share a topical domain. Shared terms: terminal, ui.
- [cql](https://pkg.so/brew/cql/) - Local package facts share a topical domain. Shared terms: databases, sql.
- [flawz](https://pkg.so/brew/flawz/) - Local package facts share a topical domain. Shared terms: terminal, ui.

## Combined YAML source

View the package source record on GitHub. [combined/vi-sql.yml](https://github.com/mxcl/pkgdb/blob/main/combined/vi-sql.yml)


## Sources

- pkg.so package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- package relationship graph
- cross-ecosystem install command graph