Documentation

Getting started with plusq

Install plusq, activate your license, connect a database, and run your first query — in about five minutes.

  1. 1

    Download and install

    Download the latest .dmg from the releases page, open it, and drag plusq into your Applications folder.

    plusq is signed and notarized by Apple, so it opens without security warnings. If macOS ever blocks a build, right-click the app and choose Open to confirm the first launch.

    Tip · plusq runs on macOS 13 Ventura or later, on both Apple Silicon and Intel Macs.

  2. 2

    Start your trial or activate a license

    plusq begins with a 14-day free trial — no key required. The days remaining are shown under Settings → License.

    Already bought a license? Open Settings → License, paste the key from your purchase email, and click Activate. One key activates up to 3 devices, and you can deactivate a device from the same screen to free a slot.

    Once activated, plusq keeps working offline for up to 30 days between checks, so a flaky connection never locks you out.

    Tip · Your license key is stored in the macOS Keychain — never in plain text or your workspace files.

  3. 3

    Connect your first database

    Click New connection and pick your engine — PostgreSQL, BigQuery, MySQL, Snowflake, or DuckDB. Enter the host, credentials, and database, then Test to confirm.

    Connection definitions live in your Git-backed workspace while secrets stay in the Keychain, so you can commit and share query files without leaking credentials.

    No database handy? Create a local DuckDB connection to explore plusq with zero setup.

  4. 4

    Keep BigQuery costs in check

    On BigQuery connections, plusq runs an automatic dry-run as you type, showing the estimated scan size and dollar cost before you hit Run.

    Set a cost threshold in the connection settings — queries above it turn the Run button red and ask for confirmation, so a stray SELECT * never surprises your bill.

    Add your own AI key (Claude, OpenAI, Gemini, and more) under Settings → AI to draft queries, explain errors, and get optimization tips — all with your data staying in your stack.

    Tip · Turn on read-only mode for production connections to block destructive DML.

Need a hand?

Questions, feature ideas, or a bug to report? Start a discussion or open an issue on GitHub — we read everything during the beta.