diff --git a/README.md b/README.md index 330a577..129a64e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,29 @@ +
+ # Noverdbee -A desktop database client, built with GPUI and Rust. PostgreSQL and SQLite first. +**Databases for you and your AI.** + +An open-source PostgreSQL and SQLite client with a built-in MCP server, so you and your AI agent work the same databases from one app. Native, built with GPUI and Rust, for macOS, Windows, and Linux. + +[![Release](https://img.shields.io/github/v/release/noverwork/noverdbee)](https://github.com/noverwork/noverdbee/releases) +[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)]() +[![License](https://img.shields.io/badge/License-MIT-5f3dc4)](LICENSE) + +[Download](https://github.com/noverwork/noverdbee/releases) · [Website](https://noverwork.github.io/noverdbee/) · [Report a bug](https://github.com/noverwork/noverdbee/issues) + +
+ +![Noverdbee with a production query tab: a SQL join in the editor, three result rows below, and the connection navigator on the left](docs/assets/shots/editor-results.webp) + +## Highlights + +- **MCP server for AI agents** — Claude Code, Cursor, VS Code, and Claude Desktop can list tables and run select, insert, update, or delete on the connections where you allow each tool +- **Environment-coloured tabs** — production, staging, development, and local each have their own colour and code, so you know where a query runs before you run it +- **SQL editor and result grid** — run a selection or the whole script, page through large results, copy and paste cell blocks +- **Staged row edits** — edits, new rows, and deletions stay marked until you review the SQL and save +- **Table structure** — columns, indexes, foreign keys, and the definition +- **Local-first** — no account, no cloud sync, no telemetry Work in progress. It connects to SQLite files and PostgreSQL servers, browses tables, runs SQL, and edits rows with staged changes. The design is in `PRODUCT.md`, `DESIGN.md`, and `.impeccable/surfaces/`. Saved connections, including passwords in plain text, stay in a local SQLite database. diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/docs/assets/shots/connection-postgres.webp b/docs/assets/shots/connection-postgres.webp new file mode 100644 index 0000000..ce98fe6 Binary files /dev/null and b/docs/assets/shots/connection-postgres.webp differ diff --git a/docs/assets/shots/editor-error.webp b/docs/assets/shots/editor-error.webp new file mode 100644 index 0000000..7446062 Binary files /dev/null and b/docs/assets/shots/editor-error.webp differ diff --git a/docs/assets/shots/editor-results.webp b/docs/assets/shots/editor-results.webp new file mode 100644 index 0000000..969c11d Binary files /dev/null and b/docs/assets/shots/editor-results.webp differ diff --git a/docs/assets/shots/mcp.webp b/docs/assets/shots/mcp.webp new file mode 100644 index 0000000..e44c137 Binary files /dev/null and b/docs/assets/shots/mcp.webp differ diff --git a/docs/assets/shots/navigator.webp b/docs/assets/shots/navigator.webp new file mode 100644 index 0000000..e93fbf8 Binary files /dev/null and b/docs/assets/shots/navigator.webp differ diff --git a/docs/assets/shots/table-pending.webp b/docs/assets/shots/table-pending.webp new file mode 100644 index 0000000..2e03598 Binary files /dev/null and b/docs/assets/shots/table-pending.webp differ diff --git a/docs/assets/shots/table-structure.webp b/docs/assets/shots/table-structure.webp new file mode 100644 index 0000000..fbf12dd Binary files /dev/null and b/docs/assets/shots/table-structure.webp differ diff --git a/docs/favicon.png b/docs/favicon.png new file mode 100644 index 0000000..3452ec1 Binary files /dev/null and b/docs/favicon.png differ diff --git a/docs/icon.png b/docs/icon.png new file mode 100644 index 0000000..47c9301 Binary files /dev/null and b/docs/icon.png differ diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..a0303b4 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,1435 @@ + + + + + + Noverdbee – Open-Source PostgreSQL and SQLite Client with an MCP Server + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+
+ + Noverdbee +
+

Databases for you and your AI

+

+ An open-source PostgreSQL and SQLite client with a built-in MCP server, so you and your agent work the + same databases from one app, and every tab tells you which environment it is about to hit. +

+ Download for macOS, Windows or Linux +
+ +
+ +
+ Noverdbee with a PRD·SHOP query tab: a SQL join of orders and customers in the editor and three result rows in the grid below, with the connection navigator on the left +
+
+ + +
+
+

Let an AI agent read your data

+

+ Turn on MCP and Claude Code, Cursor, VS Code or Claude Desktop can list your tables, read their columns and + run queries against the connections you share, with the tools you tick on each one. +

+
    +
  • Listens on 127.0.0.1 only, and every request needs the token kept in Noverdbee's local database.
  • +
  • A connection stays out of MCP until you allow a tool on it. Select, insert, update and delete are separate switches.
  • +
  • The agent sees a connection's name, driver and environment, never its host or password.
  • +
  • select runs on its own read-only session: SQLite opens the file read-only, PostgreSQL runs a read-only transaction.
  • +
+
+ +
+
+
PRD·SHOP
+

Tools AI clients may use

+
+
    +
  • +
  • +
  • +
  • +
+

+        
+ +
+ Noverdbee MCP page: port, URL and hidden token with copy and regenerate buttons, a ready-made claude mcp add command with tabs for Claude Code, Cursor, VS Code and Claude Desktop, and the tool list: list_connections, list_tables, describe_table, select, insert, update and delete +
Copy the command for your client. The token stays hidden until you reveal it.
+
+
+ + +
+
+

One window for

+
+
+
+
+
+
+ +
+ + +
+ SQL editor with an UPDATE that affected 2 rows and a SELECT that failed with a syntax error, both reported in the messages pane +
+ + + + + + + + +
+ +

+ Cmd+Enter runs the selection, or the whole script when nothing is selected. Each statement reports its rows and + time; an error points at where it happened. +

+
+ + +
+

Ground rules

+
+
+

Production reads before the query

+

Each tab carries its environment's colour and a stencilled code like PRD·SHOP, so a statement meant for staging does not run against production.

+
+ +
+
+
+

Nothing changes silently

+

Row edits stay ochre and deletions stay struck through until you save or discard them.

+
+ +
+
+
+

Every connection stays on this machine

+

Connections, folders and settings live in one local SQLite file. No account, no cloud sync, no telemetry.

+
+ +
+
+
+

Native, not a web page

+

Drawn with GPUI and written in Rust. No Electron, no webview, no JVM.

+
+ +
+
+ + +
+

Fair questions

+
+
+ Price

Is Noverdbee free?

+

Yes. It is open source under the MIT License. Download a build from GitHub Releases or build it yourself; pull requests are welcome.

+
+
+ Databases

Which databases does it support?

+

PostgreSQL and SQLite. Tables are grouped by schema in PostgreSQL, and schemas you do not need can be hidden.

+
+
+ Platforms

Which systems does it run on?

+

macOS on Apple Silicon (a .dmg, or a one-line install script), Windows (an .exe installer) and Linux on x86-64 (an .AppImage or a .deb).

+
+
+ Privacy

Where do my connections live?

+

In a local SQLite database in the app data folder, passwords included, in plain text for now. There is no account, no telemetry and no cloud sync. Besides your database connections, the only network request is the update check against GitHub Releases.

+
+
+ AI

What can my AI agent do with it?

+

Through the MCP server it can list tables, describe them, and run select, insert, update or delete on the connections where you allowed that tool. Connections with no tool allowed stay invisible to it.

+
+
+ Updates

How do I get new versions?

+

Install once. Noverdbee checks GitHub Releases on its own and updates itself. The interface speaks English and Traditional Chinese.

+
+
+
+ + +
+
+

Open your first connection

+

Download the build for your system from GitHub Releases. Add a database, pick its environment, and it opens as a tab painted like the one in this form.

+
+
+

New connection

+ +
+ Environment +
+ + + + +
+
+
+
PRD·SHOP
+
+ Download Noverdbee +
+
+
+ + + + + + diff --git a/docs/og-image.png b/docs/og-image.png new file mode 100644 index 0000000..1792774 Binary files /dev/null and b/docs/og-image.png differ diff --git a/docs/og-image.svg b/docs/og-image.svg new file mode 100644 index 0000000..90c8c9b --- /dev/null +++ b/docs/og-image.svg @@ -0,0 +1,32 @@ + + + + + + + + + + + + + + + Noverdbee + + DATABASES FOR + YOU AND YOUR AI + + + An open-source PostgreSQL and + SQLite client with an MCP server.macOS, Windows, Linux. + + + + + PRD·SHOP + + STG·SHOP + + DEV·DWH + diff --git a/docs/robots.txt b/docs/robots.txt new file mode 100644 index 0000000..d6ff7d6 --- /dev/null +++ b/docs/robots.txt @@ -0,0 +1,4 @@ +User-agent: * +Allow: / + +Sitemap: https://noverwork.github.io/noverdbee/sitemap.xml diff --git a/docs/sitemap.xml b/docs/sitemap.xml new file mode 100644 index 0000000..8511427 --- /dev/null +++ b/docs/sitemap.xml @@ -0,0 +1,9 @@ + + + + https://noverwork.github.io/noverdbee/ + 2026-11-18 + weekly + 1.0 + + diff --git a/packages/desktop/tests/screenshots.rs b/packages/desktop/tests/screenshots.rs index e6e914d..27c8637 100644 --- a/packages/desktop/tests/screenshots.rs +++ b/packages/desktop/tests/screenshots.rs @@ -185,6 +185,19 @@ mod shots { let app = desktop_lib::bootstrap::backend().expect("backend starts"); let shop = seed(&app, data.path()); + // The language otherwise follows the system; the website wants `en`. + if let Ok(code) = std::env::var("NOVERDBEE_SCREENSHOT_LOCALE") { + let locale = shared::Setting { + key: ui::i18n::LOCALE_SETTING.to_string(), + value: code, + }; + desktop_lib::app::runtime() + .block_on(desktop_lib::store::settings::set_setting( + locale, + app.state(), + )) + .expect("save locale"); + } let mut stage = open_stage(&app, out, 1200., 800.); stage.shoot("databases"); @@ -217,6 +230,14 @@ mod shots { .ok(); stage.settle(Duration::from_millis(500)); stage.shoot("navigator"); + // The failure toast has been seen; keep it off the pages that follow. + stage + .cx + .update_window(stage.window, |_, window, cx| { + use gpui_kit::component::WindowExt as _; + window.clear_notifications(cx) + }) + .ok(); // The open connection got an editor; run SQL in it, then SQL that fails. for (name, sql) in [ @@ -327,7 +348,17 @@ mod shots { stage.settle(Duration::from_millis(500)); stage.shoot("settings"); - desktop_lib::app::runtime().block_on(desktop_lib::mcp::start(app.clone())); + // A port of its own, so a running noverdbee does not hold it. + desktop_lib::app::runtime().block_on(async { + let port = shared::Setting { + key: "noverdbee.mcp.port".to_string(), + value: (desktop_lib::mcp::DEFAULT_PORT + 9).to_string(), + }; + desktop_lib::store::settings::set_setting(port, app.state()) + .await + .expect("save MCP port"); + desktop_lib::mcp::start(app.clone()).await + }); stage.store(|store, cx| store.navigate(Route::Mcp, cx)); stage.settle(Duration::from_millis(500)); stage.shoot("mcp");