How t8y2/dbx works
DBX is a multi-database client and management platform, offered as desktop, Docker/web, CLI, AI assistant, and MCP server. Its principal workflow is a user composing and executing database work, with DBX routing it through shared query and driver layers to a connected database and presenting results. The repository also documents schema, backup, administration, and plugin capabilities. Edges use the README or shown source-index references; several subsystem links are necessarily broad because their implementation was not sampled.
Main entry points: query_execution_sql.rs Query execution · agent_runtime.rs Driver runtime · App.vue Desktop app · useQueryEditorCompletion.ts SQL editor
Components 23
Desktop client
- Desktop app
apps/desktop/src/App.vue - SQL editor
apps/desktop/src/components/editor/useQueryEditorCompletion.ts - Completion metadata
apps/desktop/src/components/editor/useQueryEditorCompletionMetadata.ts - Schema diagrams
apps/desktop/src/components/diagram/SchemaDiagramDialog.vue - Schema comparison
apps/desktop/src/components/diff/SchemaDiffDialog.vue - Database administration
apps/desktop/src/components/admin/DatabaseUserAdmin.vue
Query and drivers
- Query execution
crates/dbx-sql-core/src/query_execution_sql.rs - SQL handling
crates/dbx-sql-core/src/sql.rs - Result export
crates/dbx-core/src/data/query_result_export.rs - Driver management
crates/dbx-driver-agent/src/agent_manager.rs - Driver runtime
crates/dbx-driver-agent/src/agent_runtime.rs - Agent protocol
agents/common/src/main/java/com/dbx/agent/AgentProtocol.java
Services and interfaces
- Web service
crates/dbx-web/src/main.rs - Web query routes
crates/dbx-web/src/routes/query.rs - Scheduled backups
crates/dbx-core/src/scheduled_backup/engine.rs - Command-line client
crates/dbx-cli/src/main.rs - MCP server
crates/dbx-mcp/src/server.rs - MCP backend
crates/dbx-mcp/src/backend.rs
Plugins and AI
- Plugin host
plugins/sdk/dev-host/server.mjs - Plugin storage
src-tauri/src/commands/plugin_storage.rs - Built-in AI
apps/desktop/src/components/ai/rich/AiChartRenderer.vue
Other components
- Database user
- Connected databases
Connections 24
- Database user → Desktop app: uses
- Desktop app → SQL editor: provides editor
- SQL editor → Completion metadata: loads metadata
apps/desktop/src/components/editor/useQueryEditorCompletion.ts - Database user → Query execution: runs queries
- Query execution → SQL handling: uses SQL handling
crates/dbx-sql-core/src/query_execution_sql.rs - Query execution → Connected databases: executes against
- Query execution → Result export: exports results
- Driver management → Driver runtime: manages runtime
crates/dbx-driver-agent/src/agent_manager.rs - Driver runtime → Connected databases: connects through agents
- Driver runtime → Agent protocol: launches agents
- Database user → Web service: uses web edition
- Web service → Web query routes: routes requests
crates/dbx-web/src/main.rs - Web query routes → Query execution: uses query services
- Database user → Command-line client: uses CLI
- Database user → MCP server: uses MCP
- MCP server → MCP backend: delegates tools
crates/dbx-mcp/src/server.rs - Database user → Scheduled backups: configures backups
- Scheduled backups → Result export: exports data
- Database user → Schema diagrams: explores schema
- Database user → Schema comparison: compares schemas
- Database user → Database administration: administers databases
- Database user → Built-in AI: uses assistant
- Database user → Plugin host: uses plugins
- Plugin host → Plugin storage: stores plugin state