Repository navigation
Releases: Ibnu-Afdel/dbWiz
Release list
v1.1.1
Changelog
All notable changes to DBWiz are documented here. This project adheres to
Semantic Versioning.
v1.1.1 — fixes
Fixed
- "Continue where you left off" now works for SQLite files. It opened the
file but stayed on the home menu; it now lands on the database's dashboard,
and a file that fails to open shows an error instead of nothing. - The query plan no longer cuts lines off. Long statements and the advice
under "What stands out" wrap inside the overlay instead of being truncated
mid-word, and scrolling reaches the end of a long plan.
v1.1.0 — tabs, remote targets, schema tools, and built in for Omarchy 4
Everything since v1.0.0: work with several databases at once, change data from
the browser, reach databases beyond local Docker, script it all from the CLI,
and feel at home on Omarchy 4.
Added
- Tabs — several connections open at once (
Ctrl+T/Ctrl+W,1–9to
switch, tmux-friendly). DBWiz remembers the last target and offers to continue
on relaunch, and keeps your recent SQLite files. - Change data from the browser — edit a cell, insert a row from a generated
form, or delete a row, always previewing the exactUPDATE/INSERT/
DELETEfirst. Plus truncate, exact row counts, and a quickWHEREfilter. - Query workflow — autocomplete for tables, columns, and functions; a SQL
formatter; copy a cell or row; a full-row viewer for wide tables; and an
optional vim-style editor ([editor] vim = true). - Query plans in plain language —
⌥p(ordbwiz explain) turnsEXPLAIN
into a readable tree with the slow parts flagged. - Schema tools — capture a schema, diff two of them, and export DDL
(dbwiz schema); framework-aware hints show which migration a database is on
(dbwiz migrations). - Backup and restore — from the TUI (
B) ordbwiz dump/dbwiz restore. - Beyond local Docker — connect any host/port Postgres or MySQL, tunnel
through SSH, and scan a server's Docker over SSH (dbwiz list --ssh).
Non-local targets wear a REMOTE badge and ask for an extra confirmation
before anything destructive. - Provisioning and health —
dbwiz setupcreates Omarchy-compatible
database containers;dbwiz healthruns a connectivity self-check;dbwiz url
prints a connection URL;dbwiz extmanages Postgres extensions. - Scripting surface —
dbwiz use,list,query,create,drop, and
keysfor shell scripts and CI;F1shows every key, from the same catalogue
the handlers use. - Opt-in config —
~/.config/dbwiz/config.tomlfor theme, row limit, and
saved targets. - Follows the Omarchy theme, live — on Omarchy, DBWiz paints with the active
theme's palette and recolors as soon as you switch themes.theme = "default"
(or any named theme) opts out. dbwiz desktop install/remove— an app-launcher entry and icon on any
Linux desktop. On Omarchy it opens via launch-or-focus and adds a Databases
section to the Omarchy menu (--no-menuto skip).--sudo(orDBWIZ_SUDO=1) — when your user can't reach the Docker socket,
authorize sudo once and DBWiz runs only itsdockercalls through it. In the
TUI, pressson the permission screen to do the same.
Changed
- Dashboard navigation and SQL editing reworked: type-to-jump with
f,
eto reach the editor from anywhere. - Omarchy 4 detection — recognizes the packaged install (
$OMARCHY_PATH,
/usr/share/omarchy) as well as the Omarchy 3 layout. - Docker permission errors now suggest Omarchy's own opt-in
(omarchy setup security sudoless docker) on Omarchy, and notice a docker-group
change that's still waiting on a reboot. - The empty state points at
omarchy install docker dbs.
v1.0.0 — MVP: find it, browse it, admin it, query it
The first release. Launch dbwiz on a machine with a Docker database (or a
SQLite file) and, with zero configuration, manage it from a friendly terminal UI.
Added
- Zero-config Docker detection — finds PostgreSQL / MySQL / MariaDB
containers automatically, running or stopped; start a stopped one with a
keypress. First-class Omarchy support (badges + known
default credentials). - Home menu routes — use an existing database, create a new database and
continue straight into it, or open a SQLite file. - Table browser — databases → tables → columns and rows in a scrollable
grid, no SQL required; NULLs shown distinctly;idescribes a table. - Admin — create/delete databases and users, grant/revoke a user's access to
a database. Every destructive action requires typing the name to confirm. - Query editor — multi-line SQL; run with
Ctrl+Enter/F5, cancel with
Esc, in-memory history viaCtrl+P/Ctrl+N; results in the shared grid. - Credential ladder — Omarchy defaults →
docker inspectenv → project
.env/DATABASE_URL→ masked prompt, so you usually type nothing. - Beginner safety — plain-language errors that always offer a next step, a
persistent help bar (?for the full keymap), a first-run hint, and no
dead ends (Ctrl+Cquits from anywhere). - Opt-in debug log —
DBWIZ_DEBUG=1writes~/.local/state/dbwiz/dbwiz.log
(docker commands + SQL, passwords redacted). --versionflag; single static binary (CGO_ENABLED=0, pure-Go drivers).
Engines
| Engine | Detect & connect | Browse & query | Users & grants |
|---|---|---|---|
| PostgreSQL | ✅ | ✅ | ✅ |
| MySQL / MariaDB | ✅ | ✅ | ✅ |
| SQLite | ✅ | ✅ | — (no user model) |
Known limitations
- Query results are fetched in full; a
SELECTon a very large table with no
LIMITcan use significant memory. PreferLIMITfor large tables (a capped
fetch + notice is planned for v2). - Remote/TLS databases, saved queries, tabs, export, and a full permission
matrix are v2+.
v1.1.0
Changelog
All notable changes to DBWiz are documented here. This project adheres to
Semantic Versioning.
v1.1.0 — tabs, remote targets, schema tools, and built in for Omarchy 4
Everything since v1.0.0: work with several databases at once, change data from
the browser, reach databases beyond local Docker, script it all from the CLI,
and feel at home on Omarchy 4.
Added
- Tabs — several connections open at once (
Ctrl+T/Ctrl+W,1–9to
switch, tmux-friendly). DBWiz remembers the last target and offers to continue
on relaunch, and keeps your recent SQLite files. - Change data from the browser — edit a cell, insert a row from a generated
form, or delete a row, always previewing the exactUPDATE/INSERT/
DELETEfirst. Plus truncate, exact row counts, and a quickWHEREfilter. - Query workflow — autocomplete for tables, columns, and functions; a SQL
formatter; copy a cell or row; a full-row viewer for wide tables; and an
optional vim-style editor ([editor] vim = true). - Query plans in plain language —
⌥p(ordbwiz explain) turnsEXPLAIN
into a readable tree with the slow parts flagged. - Schema tools — capture a schema, diff two of them, and export DDL
(dbwiz schema); framework-aware hints show which migration a database is on
(dbwiz migrations). - Backup and restore — from the TUI (
B) ordbwiz dump/dbwiz restore. - Beyond local Docker — connect any host/port Postgres or MySQL, tunnel
through SSH, and scan a server's Docker over SSH (dbwiz list --ssh).
Non-local targets wear a REMOTE badge and ask for an extra confirmation
before anything destructive. - Provisioning and health —
dbwiz setupcreates Omarchy-compatible
database containers;dbwiz healthruns a connectivity self-check;dbwiz url
prints a connection URL;dbwiz extmanages Postgres extensions. - Scripting surface —
dbwiz use,list,query,create,drop, and
keysfor shell scripts and CI;F1shows every key, from the same catalogue
the handlers use. - Opt-in config —
~/.config/dbwiz/config.tomlfor theme, row limit, and
saved targets. - Follows the Omarchy theme, live — on Omarchy, DBWiz paints with the active
theme's palette and recolors as soon as you switch themes.theme = "default"
(or any named theme) opts out. dbwiz desktop install/remove— an app-launcher entry and icon on any
Linux desktop. On Omarchy it opens via launch-or-focus and adds a Databases
section to the Omarchy menu (--no-menuto skip).--sudo(orDBWIZ_SUDO=1) — when your user can't reach the Docker socket,
authorize sudo once and DBWiz runs only itsdockercalls through it. In the
TUI, pressson the permission screen to do the same.
Changed
- Dashboard navigation and SQL editing reworked: type-to-jump with
f,
eto reach the editor from anywhere. - Omarchy 4 detection — recognizes the packaged install (
$OMARCHY_PATH,
/usr/share/omarchy) as well as the Omarchy 3 layout. - Docker permission errors now suggest Omarchy's own opt-in
(omarchy setup security sudoless docker) on Omarchy, and notice a docker-group
change that's still waiting on a reboot. - The empty state points at
omarchy install docker dbs.
v1.0.0 — MVP: find it, browse it, admin it, query it
The first release. Launch dbwiz on a machine with a Docker database (or a
SQLite file) and, with zero configuration, manage it from a friendly terminal UI.
Added
- Zero-config Docker detection — finds PostgreSQL / MySQL / MariaDB
containers automatically, running or stopped; start a stopped one with a
keypress. First-class Omarchy support (badges + known
default credentials). - Home menu routes — use an existing database, create a new database and
continue straight into it, or open a SQLite file. - Table browser — databases → tables → columns and rows in a scrollable
grid, no SQL required; NULLs shown distinctly;idescribes a table. - Admin — create/delete databases and users, grant/revoke a user's access to
a database. Every destructive action requires typing the name to confirm. - Query editor — multi-line SQL; run with
Ctrl+Enter/F5, cancel with
Esc, in-memory history viaCtrl+P/Ctrl+N; results in the shared grid. - Credential ladder — Omarchy defaults →
docker inspectenv → project
.env/DATABASE_URL→ masked prompt, so you usually type nothing. - Beginner safety — plain-language errors that always offer a next step, a
persistent help bar (?for the full keymap), a first-run hint, and no
dead ends (Ctrl+Cquits from anywhere). - Opt-in debug log —
DBWIZ_DEBUG=1writes~/.local/state/dbwiz/dbwiz.log
(docker commands + SQL, passwords redacted). --versionflag; single static binary (CGO_ENABLED=0, pure-Go drivers).
Engines
| Engine | Detect & connect | Browse & query | Users & grants |
|---|---|---|---|
| PostgreSQL | ✅ | ✅ | ✅ |
| MySQL / MariaDB | ✅ | ✅ | ✅ |
| SQLite | ✅ | ✅ | — (no user model) |
Known limitations
- Query results are fetched in full; a
SELECTon a very large table with no
LIMITcan use significant memory. PreferLIMITfor large tables (a capped
fetch + notice is planned for v2). - Remote/TLS databases, saved queries, tabs, export, and a full permission
matrix are v2+.