Desktop app

Querylab.io Desktop is the same IDE as app.querylab.io packaged as a native macOS and Windows app. It exists for two things the browser can't do: keep your Google tokens in the OS keychain (or reuse the gcloud credentials already on your machine) and talk to local AI CLI tools. Everything else, including your tabs, settings, and queries, works the same as on the web.

Download

The download button on querylab.io hands you the signed Apple Silicon build. The direct links always point at the latest release:

There is no Linux build. The code is written for it, but nothing is compiled or published for it yet.

Install

macOS

Open the .dmg and drag Querylab to Applications. The app is signed with an Apple Developer ID and notarized, so Gatekeeper opens it without a warning. Minimum version is macOS 10.15.

Windows

Run the -setup.exe installer. It installs for the current user and adds a Start menu entry.

First launch

The app opens on Step 1 of 2 · Authentication with two cards: Local gcloud (ADC) and Google OAuth. Which one to pick, and what each does, is on Connecting to BigQuery; the sign-in screens and scopes are on Authentication. The gcloud route in detail: Use existing gcloud auth.

Updates

The app updates itself. When a new version is out, a bar appears at the top of the window — click Install update and it downloads, installs, and restarts on the new version. Close the bar to postpone; it comes back later. To check by hand, use Help → Check for Updates.

Update packages are signed, and the app verifies the signature before installing.

What’s different from the web app

Details on token storage: Local credentials. CLI tools: CLI integration.