pgcli CLI
pgcli, терминальный клиент PostgreSQL, подсказывает имена по контексту SQL: таблицы после FROM и столбцы после WHERE.
- 13 434 ★ репозитория
- Последний коммит
- BSD-3-Clause
Расширенный доступ
Почему такой уровень
- Клиент выполняет SQL с правами подключенной роли, включая изменения данных при наличии разрешений.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/pgcliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Клиент выполняет SQL с правами подключенной роли, включая изменения данных при наличии разрешений.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pgcli, клиент PostgreSQL для терминала, открывает интерактивную SQL-сессию с подсказками по структуре базы. При наборе запроса он дополняет имена таблиц и столбцов, а подсветка помогает читать выражение до выполнения. Результат выводится в виде таблицы. Клиент поддерживает параметры подключения и переменные окружения, знакомые пользователям psql. Для нескольких баз можно сохранить именованные настройки. Агент может помочь подготовить запрос и подключение, а человек проверить его в терминальной сессии.
Для кого. Аналитикам PostgreSQL, которые вручную исследуют таблицы и составляют запросы в терминале.
Подходит, если
- Схема незнакомой базы большая, и при наборе SQL нужны подсказки имен.
- Длинный запрос удобнее проверять с подсветкой синтаксиса.
- Широкий результат нужно показать вертикально, чтобы прочитать значения.
- Работа переключается между несколькими заранее настроенными базами.
Не подходит, если
- Требуется установить сам сервер PostgreSQL и организовать хранение базы.
- Сценарий ожидает полную совместимость всех служебных команд psql.
- Учетной записи выданы права записи, хотя задача допускает только чтение.
Пример запроса к агенту
Подготовь подключение pgcli к тестовой базе с правами чтения и SQL для проверки структуры таблицы. Пароль в команду не вставляй.Ограничения
Нужны установленное Python-окружение и доступ к PostgreSQL с подходящими учетными данными. Поддержка служебных команд psql ограничена, поэтому сложные сценарии следует проверять отдельно. Для автодополнения клиент обычно открывает дополнительное соединение. Флаг `--single-connection` отключает отдельное подключение для подсказок. Предупреждение перед разрушительным запросом настраивается, но не заменяет роль базы с ограниченными правами и проверку выбранного соединения.
Как отключить. Завершите сессию Ctrl-D и удалите pgcli через выбранный менеджер пакетов. Сохраненные настройки подключений удаляются отдельно.
Частые вопросы
Как открыть локальную базу?
Выполните `pgcli local_database`, заменив имя своей базы. Проверьте сервер и пользователя в приглашении сессии.
Откуда берутся подсказки?
Клиент учитывает SQL и структуру подключенной базы. После FROM он показывает имена таблиц, после WHERE — столбцов.
Можно ли использовать переменные libpq?
Да. Поддерживаются `PGHOST`, `PGPORT` и другие переменные подключения. Проверьте их значения без вывода пароля.
Где находится конфигурация?
При первом запуске создается `~/.config/pgcli/config`. В нем описаны доступные настройки.
Как запросить пароль интерактивно?
Укажите `-W`: клиент запросит пароль при подключении. Значение не придется включать в аргументы командной строки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и скиллы от TigerData, с которыми агент пишет схемы и запросы PostgreSQL по актуальной документации и практикам
dblab, терминальный SQL-клиент, сохраняет профили подключений и может хранить пароли в системном хранилище ключей.
MCP-сервер для PostgreSQL с несколькими базами сразу, описаниями таблиц из каталога, подсказками по PostGIS и pgvector и планами запросов
SQL-клиент объединяет просмотр баз и пакетные запросы, чтобы агент работал с выбранным подключением и результатами в JSON.
Утилита Postgres Professional для резервного копирования и восстановления PostgreSQL с инкрементальными бэкапами и PITR
vi-sql — терминальный клиент для SQL-баз со встроенным MCP-сервером: агент видит схему и пишет запросы прямо в ваш редактор
Коротко о README
Приглашение SQL-сессии можно настроить под свои подключения. Для работы с клиентом внутри IPython есть отдельное расширение.