Your local databases, one keypress away.

DBWiz finds the SQL databases in your Docker containers and opens them in a friendly terminal UI. No config.

curl -fsSL https://raw.githubusercontent.com/Ibnu-Afdel/dbWiz/main/install.sh | sh
View on GitHub
DBWiz running a SQL query against a SQLite shop database, with the results grid below the editor

Works with

  • PostgreSQL
  • MySQL
  • MariaDB
  • SQLite
  • Docker

Everything you open psql for. Without the psql.

Finds them for you

Running and stopped Postgres, MySQL, and MariaDB containers show up on launch. Start a stopped one with a single key.

The DBWiz home menu listing detected database containers, two running and two stopped

Credentials, recovered

Known defaults, then docker inspect, then your project's .env. You usually type nothing, and passwords never touch disk.

Query plans in plain language

One key turns EXPLAIN into a readable tree, with the slow steps called out and what to do about them.

The DBWiz query plan viewer explaining a full table scan and suggesting an index

Change data safely

Edit a cell, insert or delete a row. DBWiz shows the exact SQL first, and anything destructive asks you to type the name.

Browse without SQL

Databases, tables, rows. Filter with a quick WHERE, jump with type-to-find, open any cell's full value.

DBWiz previewing the rows of an orders table in its results grid

Also in the box

Tabs
Several connections open at once. DBWiz remembers where you were.
Beyond local Docker
Any host and port, SSH tunnels, and Docker scans on a server over SSH.
Admin chores
Databases, users, grants, backup and restore, schema diffs, DDL export.
A real SQL editor
Autocomplete, a formatter, history, and an optional vim mode.
Scriptable
list, query, dump, health, schema and more, with JSON output for CI.
One static binary
Pure Go drivers, no runtime to install. SQLite files need nothing at all.

Built in for Omarchy.

Works on any Linux. Feels native on Omarchy 4.

What's Omarchy?

  • Knows its databases

    Containers from omarchy install docker dbs connect with zero prompts, and dbwiz setup creates the same ones.

  • Follows your theme

    DBWiz paints with your current Omarchy theme and recolors the moment you switch. No restart.

  • In the launcher and the menu

    dbwiz desktop install adds it to the app launcher and a Databases section to the Omarchy menu.

  • Respects Docker security

    Omarchy keeps you out of the docker group. dbwiz --sudo asks once and uses it only for its own docker calls.

Install in one line.

Linux, x86_64 or arm64.

Script

curl -fsSL https://raw.githubusercontent.com/Ibnu-Afdel/dbWiz/main/install.sh | sh

Picks the binary for your CPU, checks its SHA-256, and installs to ~/.local/bin without sudo.Read the script

Omarchy

omarchy pkg aur add dbwiz-bin

From the AUR, with shell completions.

Arch

yay -S dbwiz-bin

Any AUR helper works. Includes bash, zsh, and fish completions.AUR page

Go

go install github.com/Ibnu-Afdel/dbwiz@latest

Builds from source with Go 1.25 or newer.

Binary

Download dbwiz-linux-amd64 or dbwiz-linux-arm64 from the latest release, make it executable, and put it on your PATH.Latest release

Container databases need the docker CLI. SQLite files and host/port connections need nothing else.

Thirty seconds to your data.

  1. Run

    Type dbwiz. It scans Docker and lands on a menu of what it found.

  2. Pick

    Choose a database. Press s first to start a stopped one.

  3. Browse

    Tab cycles panes, Enter opens a table, i describes it.

  4. Query

    Press e, write SQL, run it with Ctrl+R. F1 lists every key.

Questions

Which databases does it support?

PostgreSQL, MySQL, MariaDB, and SQLite files. User and permission management works on the server engines; SQLite has no user model.

Do I need Docker?

Only for detecting containers. You can also open a SQLite file, or connect to any Postgres or MySQL by host and port, directly or through an SSH tunnel.

Does it run on macOS or Windows?

Not today. DBWiz is built for Linux on x86_64 and arm64. It runs on any distro and feels most at home on Omarchy.

Is it safe to point at real data?

Every change shows its SQL before it runs, destructive actions ask you to type the name, and remote targets get a REMOTE badge plus an extra confirmation. Passwords are never stored or logged.

Why would it ask for sudo?

Only when your user can't reach the Docker socket, which is the Omarchy 4 default. With --sudo it asks once and uses it only for its own docker commands.

Is it free?

Yes. DBWiz is open source under the MIT license.