PostgresGUI - A native PostgreSQL client for macOS


NOTE 01/30/2026
A fix is being pushed to the App Store to address the inconsistent data display issue reported here: https://github.com/PostgresGUI/postgresgui/issues/20. There are also improvements and features such as the table schema dropdown and saved query caching by NeodymiumPhish. — Ghazi
Getting started
-
Clone the repository:
git clone https://github.com/PostgresGUI/app.git
cd app
-
Open the project in Xcode:
open PostgresGUI.xcodeproj
-
Configure code signing:
- Select the PostgresGUI target in the project navigator
- Go to Signing & Capabilities tab
- Select your Team from the dropdown (use your Apple ID's "Personal Team" if you don't have a paid developer account)
-
Build and run with Cmd+R
Submitting Pull Requests
When you select your team in step 3, Xcode modifies project.pbxproj with your team ID. Do not include this change in your pull request.
Why Code Signing is Required
This app uses macOS Keychain to securely store database passwords. Keychain access requires a valid code signature, so even local development builds need to be signed with your team ID.
Support
Acknowledgments
PostgresGUI is built on the shoulders of giants. Special thanks to:
- The PostgresNIO team for the excellent PostgreSQL client library
- The Swift NIO project for the networking foundation