https://github.com/neondatabase-labs/psqlsh
psql.sh - browser native PostgreSQL command line client
https://github.com/neondatabase-labs/psqlsh
neondb postgresql psql
Last synced: 11 months ago
JSON representation
psql.sh - browser native PostgreSQL command line client
- Host: GitHub
- URL: https://github.com/neondatabase-labs/psqlsh
- Owner: neondatabase-labs
- License: apache-2.0
- Created: 2024-09-24T09:51:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-22T08:20:20.000Z (over 1 year ago)
- Last Synced: 2025-06-03T15:15:01.929Z (about 1 year ago)
- Topics: neondb, postgresql, psql
- Language: TypeScript
- Homepage: https://psql.sh
- Size: 3.46 MB
- Stars: 27
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [psql.sh](https://psql.sh) - browser native PostgreSQL command line client
This project gives you a browser-native, psql-like experience for working with a Postgres database, without having to install anything.
Check out the demo video:
https://www.loom.com/share/17743bb0cc55445a84e6138a43a2557f?sid=2ba5854b-1ecd-4e86-9a4c-b76b997379b6
## Start
First, pick a dataset to work with. You can start with an empty database or choose one of these sample datasets:
- **Chinook**. A sample database representing a digital media store.
- **Pokemon**. A dataset with a single table containing information about Pokemon.
- **Netflix**. A dataset with a single table containing information about Netflix shows.
- **pgrag**. A demo database for the pgrag extension. It contains two tables: `docs` and `embeddings`. The `docs` table contains text from PGConfEU presentations and the `embeddings` table contains chunks and their embedding vectors.
Make your selection and watch as your database spins up in real-time — don't blink!
Once created, you can execute any queries you want. Feel free to explore, experiment, and run as many queries as you'd like. You can't break anything, as this is a temporary database and will be destroyed after you leave the page or stay inactive for several minutes.
## Features
- No installation required
- Supports most psql backslash commands (inspection commands)
- Instant database spin-up with each session
- AI-powered SQL generation:
- Type `\ai ` to get a SQL query generated for you
- Example: `\ai find all pokemons`, `\ai create a "users" table with two columns: "id" and "name"`
## How does it work
This project is powered by Neon. It leverages Neon's instant branching feature to create a new database for each session. Database connections are handled using the [Neon serverless driver](https://github.com/neondatabase/serverless).
## Disclaimer
This project is in its early stages, some issues may occur. If you find a bug, please report it in the issues section.
Also, note that this project is not intended as a direct replacement for psql, but instead provides a similar experience in the browser.