20MB lightweight database client for 70+ databases
Go to file
t8y2 24537093ad feat(update): add API endpoint to retrieve app version and update client-side calls 2026-05-05 16:01:38 +08:00
.github chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
.husky chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
crates/dbx-core feat(update): refactor release fetching to use structured JSON response 2026-05-05 14:40:05 +08:00
docs fix: correct app name casing in installation instructions and workflows 2026-05-04 02:55:19 +08:00
mcp feat: implement web backend for API interactions and connection management 2026-05-05 04:24:10 +08:00
public Refactor code structure for improved readability and maintainability 2026-05-05 13:21:04 +08:00
src feat(update): add API endpoint to retrieve app version and update client-side calls 2026-05-05 16:01:38 +08:00
src-tauri chore: add rustfmt.toml and apply unified code formatting 2026-05-05 14:16:18 +08:00
src-web feat(update): add API endpoint to retrieve app version and update client-side calls 2026-05-05 16:01:38 +08:00
tests feat: add execute mode settings and cursor position handling in SQL editor 2026-05-04 21:19:07 +08:00
.dockerignore feat: add web deployment with axum server, Docker support, and browser UI 2026-05-05 03:16:50 +08:00
.gitignore feat: extract dbx-core crate for web deployment support 2026-05-05 03:16:24 +08:00
.oxfmtrc.json chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
Cargo.lock feat: update dependencies and integrate tracing for improved logging and performance 2026-05-05 13:29:02 +08:00
Cargo.toml feat: extract dbx-core crate for web deployment support 2026-05-05 03:16:24 +08:00
Dockerfile feat: add Docker workflow for building and pushing images 2026-05-05 05:09:01 +08:00
README.md fix: correct app name casing in installation instructions and workflows 2026-05-04 02:55:19 +08:00
README.zh-CN.md fix: correct app name casing in installation instructions and workflows 2026-05-04 02:55:19 +08:00
components.json feat: initial release 2026-04-29 18:09:23 +08:00
docker-compose.yml feat: add web deployment with axum server, Docker support, and browser UI 2026-05-05 03:16:50 +08:00
index.html feat: enhance loading experience and update window visibility settings 2026-04-29 18:33:41 +08:00
package.json chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
pnpm-lock.yaml chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
rustfmt.toml chore: add rustfmt.toml and apply unified code formatting 2026-05-05 14:16:18 +08:00
tsconfig.json feat: initial release 2026-04-29 18:09:23 +08:00
vite.config.ts feat: add web deployment with axum server, Docker support, and browser UI 2026-05-05 03:16:50 +08:00

README.md

DBX

Open-source, lightweight, cross-platform database management tool.

English | 简体中文

Features

  • Multi-database — MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, MariaDB, TiDB, OceanBase, openGauss, GaussDB, KingBase, Vastbase, GoldenDB
  • Schema browser — Databases, schemas, tables, columns, indexes, foreign keys, triggers, with sidebar search & pin
  • Query editor — CodeMirror 6 with syntax highlighting, SQL autocomplete (tables & columns), Cmd+Enter execution, selected SQL execution, SQL formatting
  • AI SQL assistant — Natural language to SQL, explain, optimize, fix errors (Claude / OpenAI)
  • Data grid — Virtual-scrolled table with inline editing, sorting, search, pagination, column resize, row numbers, zebra stripes
  • Export — CSV, JSON, Markdown
  • File preview — Drag & drop Parquet, CSV, JSON files to preview data instantly (powered by DuckDB)
  • Redis browser — Key pattern search, value viewer for all data types (String, Hash, List, Set, ZSet, Stream)
  • MongoDB browser — Document CRUD with pagination, direct URL connection (Atlas, replica sets)
  • Query history — Persistent history with search, restore, one-click copy
  • Safety — Confirmation dialog for DROP / DELETE / TRUNCATE / ALTER
  • Auto-reconnect — Transparent retry on connection loss
  • SSH tunnel — Key and password authentication
  • Connection colors — Color-coded connections for visual identification
  • Auto-update — Built-in update checker with release notifications
  • Dark mode — Native title bar theme sync
  • i18n — English & 简体中文
  • Tiny — ~15 MB installer (no bundled Chromium)

AI Agent Integration (MCP)

DBX provides an MCP server that lets AI coding agents query your databases using connections already configured in DBX.

npx @dbx-app/mcp-server

Add to your .mcp.json:

{
  "mcpServers": {
    "dbx": { "command": "npx", "args": ["-y", "@dbx-app/mcp-server"] }
  }
}

Works with Claude Code, Cursor, Windsurf, and any MCP-compatible agent. Supports listing connections, browsing tables, executing SQL, and opening tables directly in DBX's UI.

See the MCP server README for details.

Screenshot

Install

Download the latest release from the Releases page.

Homebrew (macOS):

brew install --cask t8y2/tap/dbx

Scoop (Windows):

scoop bucket add dbx https://github.com/t8y2/scoop-bucket
scoop install dbx

macOS Note

DBX is not signed with an Apple Developer certificate. On first launch, macOS will block the app. To fix this:

xattr -cr /Applications/DBX.app

Or: System Settings → Privacy & Security → Open Anyway.

Getting Started

Prerequisites

Development

pnpm install
pnpm tauri dev

Build

pnpm tauri build

The installer will be in src-tauri/target/release/bundle/.

Tech Stack

Layer Technology
Framework Tauri 2
Frontend Vue 3 + TypeScript
UI shadcn-vue + Tailwind CSS
Editor CodeMirror 6
Backend Rust + sqlx / tiberius / redis-rs / mongodb

Community

LINUX DO

WeChat Group QQ Group

Contributors

Star History

Star History Chart

License

MIT