---
id: pgcli
version: "4.5.0"
license: BSD
license_treatment: permissive
maintenance: active
---

# pgcli — CLI for Postgres Database. With auto-completion and syntax highlighting.

License: permissive · Maintenance: active · Downloads: 647.3K/mo

## What it is and what it does

pgcli is a PostgreSQL client that replaces the standard psql command-line tool with an interactive shell featuring auto-completion and syntax highlighting. It uses prompt_toolkit to provide a modern terminal interface that suggests SQL keywords, table names, and column names as you type, and highlights syntax using Pygments. The tool supports both direct database names and full PostgreSQL connection URIs, environment variables for authentication (PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE), and SSL connection options.

You run it from the command line to open an interactive session with a PostgreSQL database. It displays query results in formatted tables and supports configuration through a config file at ~/.config/pgcli/config. The package is built on established dependencies: psycopg for database connectivity, click for command-line argument parsing, sqlparse for SQL parsing, and cli_helpers for output formatting.

Use it for:

- Interactive database exploration and ad-hoc querying with real-time auto-completion of table and column names
- Development workflows where syntax highlighting and smart suggestions reduce typing and errors
- Remote PostgreSQL administration via SSH tunnels or direct connections with SSL support
- Learning SQL with guided completion that shows available tables and columns in context
- Scripting and automation via command-line invocation with DSN aliases from config files

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pgcli is a command-line interface for PostgreSQL that provides auto-completion for SQL keywords, table and column names, and syntax highlighting as you type.

Yes. pgcli is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. It is a straightforward productivity tool for PostgreSQL users who want a more modern interactive shell than psql. Install it if you regularly work with PostgreSQL from the command line and value auto-completion and syntax highlighting.

## Install

pip install pgcli
uv add pgcli
poetry add pgcli

## Installing pgcli

Before you install: Low install friction with a pure Python wheel distribution. Actively maintained with a release within the last 72 days. Requires Python 3.10 or later and depends on 11 runtime packages including psycopg for database connectivity and prompt_toolkit for the interactive interface.

License in practice: BSD license is permissive, allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

$ pip install pgcli
$ pgcli local_database

or

$ pgcli postgresql://user:password@host:5432/dbname

Requires a PostgreSQL server to connect to; psycopg (the database driver) must be able to reach a running PostgreSQL instance.

Verify before relying:

- Whether smart-completion (context-sensitive suggestions based on SQL keywords) works reliably across all query patterns
- Performance characteristics when connecting to databases with very large schemas (thousands of tables/columns)
- Extent of psql back-slash command support and which commands are fully implemented

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 647.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

postgres cli client, postgresql repl, sql auto-completion, postgres terminal interface, interactive postgres shell, postgres command line tool, sql syntax highlighting, postgres-client, repl, cli-tool

[View on SkillFed](https://skillfed.io/packages/pgcli) · [View on PyPI](https://pypi.org/project/pgcli/)