#env #environment #config #sql-query #cli #sql-database #filesystem

bin+lib sqli

A command line tool for interacting with Postgres databases

2 releases (1 stable)

new 1.0.0 Mar 1, 2025
0.1.0 Feb 18, 2025

#36 in #env

Download history

72 downloads per month

GPL-3.0-or-later

170KB
4.5K SLoC

sqli

sqli (as in, "sql" + "cli" = "sqli") is a simple & sleek SQL client, used as a terminal UI or as a command line tool, to help you query your Postgres database!

heavily inspired by tools like posting, curl, and bruno.

features ๐Ÿš€

  • ๐Ÿ“Š view query results directly in the terminal
    • or pipe it into other tools like jq
  • ๐Ÿงช simple syntax for ad-hoc queries from the terminal
  • ๐Ÿ”„ save and reuse database connections
  • ๐Ÿ“ collections are stored in your local file system
    • repo-level collections are stored in ./sqli - add these to your source control to share with others!
    • user-level settings & collections are stored in <CONFIG_DIR>/sqli
  • ๐Ÿฆ€ written in rust btw ๐Ÿ˜Ž

installation ๐Ÿ“ฆ

cargo

cargo binstall sqli (cargo-binstall)

or

cargo install sqli

brew

coming soon!

usage โš™๏ธ

tui ๐Ÿ–ฅ๏ธ

  1. sqli - open the TUI

Keybindings:

Key Action
Tab Switch between panels (when in nav mode)
Arrow keys Switch between panels (when in nav mode)
Space/Enter Focus on a pane
Ctrl+N Create new file/folder
Ctrl+E Edit selected file/folder
Ctrl+S Save current file
Ctrl+Space Run SQL query
Esc Exit edit mode
Ctrl+C Quit application

cli โ–ถ๏ธ

  1. ad-hoc queries:
  • sqli query --url postgres://user:password@host:port/database --sql "SELECT * FROM table;"
  1. configure a connection:
  • sqli config set --name local --url postgres://user:password@host:port/database
  1. query using a pre-configured connection:
  • sqli query --conn local --sql "SELECT * FROM table;"
  1. query using a file:
  • sqli query --conn local --sql path/to/file.sql

references ๐Ÿ“š

Dependencies

~24โ€“37MB
~588K SLoC