Install
PlumeSQL is one binary. The desktop app wraps it in a native window; the same binary also runs on its own from a terminal and opens a browser tab. Downloads for every platform are at plumesql.com/#download; every release with its notes is at github.com/hercstack/plumesql/releases.
macOS
Download the .dmg (Apple Silicon) and drag PlumeSQL to Applications.
The app is signed and notarized by Apple: it opens on the first double click.
Windows
Download the setup .exe or the .msi and run it. The installer is not signed yet: if SmartScreen stops it, choose More info and Run anyway.
The integrated terminal is not available on Windows yet (it needs a real PTY, and ConPTY support is planned). Where PlumeSQL would run something in its terminal, on Windows it opens a terminal window instead, so the commands the System page offers still work.
Linux
Download the .AppImage, the .deb or the .rpm. The desktop app renders in WebKitGTK 4.1, so the package needs the webkit2gtk-4.1 library your distribution ships. The AppImage registers its own desktop entry on first run, so the file manager can open a folder with PlumeSQL afterwards.
The plumesql command
Once installed, PlumeSQL offers once, in the Log, to put a plumesql command on your PATH. It never writes to PATH on its own: the command is shown as text and your own terminal runs it. The System page has the same offer at any later time.
With the command in place:
sh
plumesql # the current directory as the workspace
plumesql ~/db-work # a directory named explicitly
plumesql -d mydb # a connection, psql styleRunning plumesql opens the installed desktop app when there is one, otherwise a minimal app window, falling back to a browser tab. plumesql -browser forces a tab, plumesql -no-open starts the server without opening anything and plumesql -port 0 picks a free port. Flags go before the directory: Go's flag parsing stops at the first positional argument.
Updates
The desktop app checks for a signed release on start and from the menu (Check for Updates). On macOS, Windows and the Linux AppImage it installs the update in place on your say. The .deb and .rpm packages update through your package manager and are sent to the download page instead. Every update is verified against a public key bundled with the app.
The System page shows the running version, the latest published one and when it last checked. Being offline is not an error: a failed check reports inline on the page and never reaches the Log.
Free, no account
PlumeSQL Community is free and asks for no account and no sign-in. See Editions.
What gets written where
The app keeps everything in its own global directory, never inside a repository. Files are written with owner-only permissions. The System page lists each file with its size and opens its location.