A blazing-fast, AI-powered MySQL GUI — built with Rust & React.
Think MySQL Workbench, but actually good.
Features • Quick Start • Development • Tech Stack • Structure • Contributing • License
SQLPilot is a modern, open-source, cross-platform MySQL database management tool. It combines a Rust backend (via Tauri 2) with a React frontend to deliver native desktop performance in a ~16 MB binary — no Electron bloat, no JVM overhead. AI features (natural language to SQL, query optimization, error fixing) are powered by GitHub Copilot.
Why this over MySQL Workbench, DBeaver, or SQLyog?
- ⚡ Instant startup — native binary, not Java
- 🤖 AI built in — ask questions in plain English, get SQL
- 🪶 Tiny footprint — 16 MB vs 300+ MB for Workbench
- 🎯 100% SQLyog feature parity — everything you need, nothing you don't
- 🔓 Fully open source — MIT licensed, no telemetry, no paywalls
- Monaco Editor — the same editor engine as VS Code
- Schema-aware autocomplete — suggests tables after
FROM, columns afterSELECT, databases afterUSE, plus 90+ MySQL keywords and 40+ functions - SQL formatting — one-click beautify with
Ctrl+Shift+F - Find & replace —
Ctrl+F/Ctrl+Hwith Monaco's built-in search - Multi-tab editor — drag to reorder, middle-click to close, double-click to rename, unsaved indicators
- Query execution —
Ctrl+EnterorF5, multi-statement support with result tabs
- Sortable columns with click-to-sort headers
- Inline cell editing — double-click to edit, generates
UPDATE/INSERT/DELETEstatements with primary key detection - Export — Copy, CSV, JSON, SQL, Markdown with one click
- Right-click context menus — copy cell, copy row, copy as INSERT statement
- Full object tree — databases → tables, views, procedures, functions, triggers
- Table structure viewer — columns, indexes, and DDL in a tabbed panel
- Context menus — SELECT top 100, view structure, copy name, drop, design table
- Double-click actions — tables open data, procedures open the viewer/executor
- Table Designer — create and alter tables with a visual form: column editor, index editor, foreign key editor, table options, DDL preview
- Visual Query Builder — drag tables onto a canvas, check columns, draw JOIN lines between fields, build WHERE/ORDER BY/GROUP BY clauses graphically
- EXPLAIN Visualizer — color-coded execution plan with cost bars, access type legend, and tree view for
EXPLAIN ANALYZE
- Process list — auto-refreshing with time color-coding and kill process button
- Server variables — searchable, grouped by category, copy-to-clipboard
- Server status — metric cards (uptime, QPS, connections, buffer pool, threads, slow queries)
- User management — list users, view/edit privileges with checkbox grid, create/drop users, change passwords
- Backup — full SQL dump with options: structure only/data only/both, DROP TABLE, multi-row INSERTs, views/procedures/triggers inclusion, progress tracking
- Restore — SQL file execution with progress bar and error reporting
- Cross-connection diff — compare schemas across different servers
- Color-coded results — green (added), red (removed), yellow (modified), grey (identical)
- Column-level detail — see exactly what changed: type, nullable, default, etc.
- Sync SQL generation — generate
CREATE/ALTER/DROPstatements to synchronize, with selective execution
- SQL import — execute
.sqlfiles with statement splitting and progress tracking - CSV import — configurable delimiter, header detection, column mapping to target tables, batch INSERTs
- Export formats — CSV, JSON, SQL (
INSERTstatements), Markdown
- Connection profiles — save, test, color-code, and label connections
- SSL/TLS — configurable SSL mode (disabled → verify identity), CA cert, client cert/key
- SSH tunnels — host, port, username, password or key file authentication
- Environment labels — tag connections as Development, Staging, or Production
- Production safety — confirmation dialogs before running
DROP/DELETE/TRUNCATEon production
- Natural language to SQL — describe what you want in English, get a query
- AI chat panel — conversational assistant with schema context awareness
- Query explanation — ask the AI to explain complex queries
- Query optimization — get AI suggestions for improving performance
- Error fixing — paste an error, get a fix
- Providers — GitHub Copilot
- Query history — every execution recorded with timestamp, duration, row count, status; searchable and click-to-reload
- Query favorites — save queries with name, category, and description; organized in folders
- Stored procedure/function viewer — auto-detect parameters, execute with input form, display results
- Dark & light themes — toggle with one click, or follow system preference; Monaco editor theme syncs automatically
- Keyboard shortcuts —
Ctrl+Nnew tab,Ctrl+Wclose,Ctrl+Tabcycle,F1shortcuts help,F5execute, and more - Color-coded tabs — connection color stripe on every tab for quick identification
- Structured logging — multi-layer tracing (console + rolling JSON file), all commands instrumented, passwords redacted
Pre-built binaries will be available on the Releases page for:
- Windows —
.msiinstaller, NSIS setup.exe, or portable.exe - macOS —
.dmg(universal binary: Intel + Apple Silicon) - Linux —
.deb,.AppImage,.rpm
- Download and install for your platform
- Open SQLPilot
- Click + New Connection and enter your MySQL server details
- Configure SSL or SSH tunnel if needed (tabs in the connection dialog)
- Click Test Connection to verify, then Save
- Double-click the connection to connect and start querying!
| Tool | Version | Purpose |
|---|---|---|
| Rust | 1.75+ | Backend compilation |
| Node.js | 20+ | Frontend tooling |
| Docker | 24+ | Integration test containers |
Linux/WSL system dependencies (for Tauri desktop builds):
sudo apt install -y pkg-config libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev libssl-dev# Clone the repository
git clone https://github.com/EVWorth/sqlpilot.git
cd sqlpilot
# One-command setup (installs system deps + npm deps + checks Rust)
make setup
# Or manually:
npm install# Full desktop app (native window via Tauri)
make dev
# or: npx tauri dev
# Web preview in browser (no system deps needed, great for UI work)
make dev-web
# Then open http://localhost:1420# Run everything
make test
# Frontend unit tests (154 tests — stores, parsers, generators, diff engine)
make test-frontend
# or: npx vitest run
# Rust integration tests against Docker MySQL 8 (37 tests)
make db-up # Start MySQL 8 on port 13306
make test-rust
# or: cd src-tauri && cargo test -p mas-core -p mas-export -p mas-admin
# Type checking
npx tsc --noEmit # TypeScript
cd src-tauri && cargo clippy # Rust# Build optimized desktop binary
npx tauri build
# Output:
# src-tauri/target/release/bundle/
# ├── msi/ (Windows .msi installer)
# ├── nsis/ (Windows NSIS setup)
# ├── deb/ (Linux .deb)
# └── appimage/ (Linux .AppImage)| Command | Description |
|---|---|
make dev |
Run desktop app in development mode |
make dev-web |
Run browser preview on localhost:1420 |
make build |
Build production desktop binary |
make test |
Run all tests (Rust + frontend) |
make test-rust |
Run Rust integration tests against Docker MySQL |
make test-frontend |
Run frontend unit tests (Vitest) |
make lint |
Run clippy + TypeScript type checking |
make db-up |
Start MySQL 8 Docker container (port 13306) |
make db-down |
Stop and remove test containers |
make db-reset |
Restart containers fresh |
make setup |
Install all dependencies |
# Optional: Override log level (default: info for console, debug for file)
RUST_LOG=debug| Technology | Purpose |
|---|---|
| React 18 | UI framework |
| TypeScript | Type safety |
| Vite | Build tooling and HMR |
| Monaco Editor | SQL editor (same engine as VS Code) |
| TanStack Table v8 | Data grid with sorting and virtualization |
| Zustand | Lightweight state management (7 stores) |
| Tailwind CSS | Utility-first styling with CSS variable theming |
| sql-formatter | SQL beautification |
| Lucide React | Icon library |
| Technology | Purpose |
|---|---|
| Tauri 2.0 | Desktop app framework (WebView, not Electron) |
| sqlx | Async MySQL driver with connection pooling |
| tokio | Async runtime |
| rusqlite | Local SQLite for connection profile storage |
| tracing | Structured logging with JSON file output |
| serde | Serialization / deserialization |
| DashMap | Thread-safe concurrent connection registry |
| rfd | Native file dialogs |
| Technology | Purpose |
|---|---|
| GitHub Copilot | AI-powered features (NL-to-SQL, optimization, explanation, error fixing) |
| Technology | Purpose |
|---|---|
| Vitest | Frontend unit tests (154 tests) |
| cargo test | Rust integration tests against Docker MySQL (37 tests) |
| Docker | MySQL 8, MySQL 5.7, MariaDB 11 test containers |
sqlpilot/
├── src/ # React frontend
│ ├── components/ # 36 UI components
│ │ ├── admin/ # AdminPanel, UserManagement, CreateUser, ChangePassword
│ │ ├── ai/ # AIChatPanel, ChatMessage, NLToSQLInput
│ │ ├── backup/ # BackupDialog, RestoreDialog
│ │ ├── common/ # ContextMenu, ConfirmDialog, ShortcutsDialog
│ │ ├── compare/ # SchemaCompare, SyncPreview
│ │ ├── connection/ # ConnectionDialog (General, SSL, SSH, Advanced tabs)
│ │ ├── designer/ # TableDesigner, SQLPreviewDialog
│ │ ├── editor/ # SQLEditor, EditorTabs, QueryToolbar
│ │ ├── explain/ # ExplainPanel (table view + tree view)
│ │ ├── favorites/ # QueryFavorites, SaveFavoriteDialog
│ │ ├── grid/ # ResultsGrid, EditableCell, EditToolbar
│ │ ├── history/ # QueryHistory
│ │ ├── import/ # ImportDialog (CSV + SQL modes)
│ │ ├── layout/ # AppLayout, Sidebar, MainPanel, Toolbar, StatusBar
│ │ ├── querybuilder/ # QueryBuilder (visual canvas + SQL generation)
│ │ ├── routine/ # RoutineViewer (procedure/function executor)
│ │ └── schema/ # TableStructure (columns, indexes, DDL)
│ ├── hooks/ # 5 custom hooks (context menu, keyboard, theme, schema cache, grid editing)
│ ├── lib/ # Tauri IPC bridge, SQL generators, parsers, diff engine
│ ├── stores/ # 7 Zustand stores (connection, editor, result, history, favorites, ai, theme)
│ ├── types/ # TypeScript type definitions
│ └── styles/ # Dark + light theme CSS variables
├── src-tauri/ # Rust backend
│ ├── src/
│ │ ├── commands/ # 27 Tauri IPC command handlers
│ │ └── lib.rs # App state, tracing init, command registration
│ ├── crates/
│ │ ├── mas-core/ # Connection manager, query executor, schema inspector
│ │ │ └── tests/ # 32 integration tests against Docker MySQL 8
│ │ ├── mas-export/ # CSV, JSON, SQL, Markdown exporters
│ │ ├── mas-admin/ # Process list, server variables, kill process
│ │ └── mas-ai/ # AI service, Copilot provider, conversation manager
│ ├── Cargo.toml # Workspace with shared dependencies
│ └── tauri.conf.json # Tauri app configuration
├── tests/fixtures/sql/ # Test seed data (tables, views, procedures, triggers)
├── docs/design/ # Design documentation
│ ├── ARCHITECTURE.md # System architecture
│ ├── DESIGN_REQUIREMENTS.md # Requirements & competitive analysis
│ ├── DEVELOPMENT_PLAN.md # Development roadmap
│ ├── TESTING_STRATEGY.md # Test strategy & coverage
│ └── TECH_DECISIONS.md # Architecture Decision Records
├── docker-compose.test.yml # MySQL 8 (13306), MySQL 5.7 (13307), MariaDB 11 (13308)
├── Makefile # Dev commands
└── package.json # Frontend dependencies
We welcome contributions! Here's how to get started:
- Fork the repository and create a feature branch from
main - Set up the dev environment:
make setup - Make your changes with clear, focused commits
- Test your changes:
make test && make lint - Submit a pull request with a clear description of what and why
- Follow existing code style — run
cargo clippyandnpx tsc --noEmitbefore submitting - Write tests for new features and bug fixes
- Keep PRs focused — one feature or fix per PR
- Update documentation for user-facing changes
- 🧪 More integration tests for edge cases
- 🌍 Internationalization (i18n)
- ♿ Accessibility improvements
- 📱 Mobile-responsive layout
- 🗄️ PostgreSQL / SQLite adapter support
- 📊 Query plan visualization improvements
- 🔌 Plugin system for custom extensions
Built on top of these excellent open-source projects:
- Tauri — desktop app framework
- Monaco Editor — code editor
- TanStack Table — headless table library
- sqlx — async SQL toolkit for Rust
- Zustand — state management
- Lucide — icon library
Inspired by the best features of SQLyog, DBeaver, and MySQL Workbench — with none of their baggage.
This project is licensed under the MIT License.
Made with ❤️ and 🦀
SQLPilot — because your database tool shouldn't be the slowest thing in your stack.