vizgres — A keyboard-driven PostgreSQL client for the terminal

// features

Everything you need, nothing you don't.

A complete Postgres workflow rendered in text — fast, focused, and entirely keyboard-driven.

Keyboard-first

Vim-style navigation everywhere. Cycle panels with Tab, move with j/k, run with F5 — your hands never leave home row.

Built in Rust

Instant startup, streaming row counters, and server-side pagination. Stays smooth on databases with 10,000+ tables.

Smart SQL editor

Syntax highlighting, context-aware autocomplete, undo/redo, one-key formatting, and full query history.

Schema browser

Navigate schemas, tables, views, functions, and indexes. Filter with /, preview data, copy names, show DDL with d.

EXPLAIN ANALYZE

One key turns any query into a navigable plan tree with color-coded timing. Find the slow node without leaving the editor.

Export & copy

Save results as CSV or JSON, or copy a cell, a row, or a fully-qualified table name straight to your clipboard.

// explain analyze

See exactly where the time goes.

Press Ctrl+E on any query and vizgres renders the plan as a tree — each node colored by how much of the runtime it owns. No copy-pasting into a web visualizer, no leaving the terminal.

fast warm slow

// themes

Four themes. Pick your light.

Dark for the night shift, light for daylight, midnight for the deep end, ember for warmth. Fully configurable in ~/.vizgres/config.toml.

// keybindings

A few essential keys.

Press ? in-app for the full set — every binding is remappable.

global

Cycle focusTab

Command barCtrl+P

New / close tabCtrl+T / W

Show all keys?

QuitCtrl+Q

editor

Execute queryF5

EXPLAIN ANALYZECtrl+E

Format SQLCtrl+Alt+F

Query historyCtrl+↑ / ↓

Cancel queryEsc

tree & results

Navigatej / k / h / l

Filter tree/

Show DDLd

Export CSV / JSONCtrl+S / J

Next / prev pagen / p

// get started

Up and running in a minute.

Install from crates.io or grab a prebuilt binary, then point it at any Postgres URL.

Install it

❯ cargo install vizgres

Connect to a database

❯ vizgres postgres://…/mydb

Or launch & pick a profile

❯ vizgres

Prebuilt binaries for Linux (x86_64 / ARM), macOS (Apple Silicon / Intel), and Windows. Reads DATABASE_URL and PG* env vars too.

Postgres, without leaving the terminal.