Cobalt SQL Works
A free, open-source, cross-platform desktop SQL client for SQL Server, Azure SQL, and Microsoft
Fabric — the spiritual successor to Azure Data Studio. Pure Rust, egui.
Status: v0.1.0 released. Downloads and news at cobaltsql.org; installers on the
releases page. See docs/product_design.md for what it is,
docs/architecture.md for how it's built, and docs/alpha_notes.md for what to try first.
Build
Requires Rust 1.85+ (developed on 1.95). On Windows, Visual Studio Build Tools; on Linux,
pkg-config libssl-dev libxkbcommon-dev libwayland-dev libx11-dev libxcb1-dev libgl1-mesa-dev libfontconfig1-dev libdbus-1-dev cmake clang.
cargo run -p cobalt-app # dev build with the agent control channel compiled in
COBALT_AGENT=1 cargo run -p cobalt-app # ...and serving it (Windows: named pipe `cobalt.agent`)
cargo build --release -p cobalt-app # release (agent channel still compiled in but inert)
cargo build --release -p cobalt-app --no-default-features # release without the agent channel
A Linux binary can be produced from any machine with Docker (see CLAUDE.md). The SQL Server
driver is vendored under vendor/tiberius-ng with a small documented patch.
Testing
Unit tests run with cargo test --workspace. Driver integration tests need a SQL Server; the
easiest is Docker: docker run -d --name cobalt-mssql -e ACCEPT_EULA=Y -e MSSQL_SA_PASSWORD='Cobalt!Dev2026pw' -p 1433:1433 mcr.microsoft.com/mssql/server:2022-latest, seed it with tests/seed.sql, then
COBALT_TEST_MSSQL=1 cargo test -p cobalt-driver -- --test-threads=1.
The app can be driven by an agent (or a script) through egui_agent:
bash scripts/launch.sh then egui-agent-cli --pipe cobalt.agent invoke state --quiet.
License
MIT OR Apache-2.0.
