Harlequin CLI
Harlequin дает SQL-редактор в терминале, а входящий в поставку hsql выполняет запросы и читает структуру базы для агентов.
- 6 512 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- SQL без ограничений чтения может изменить данные в пределах прав подключенной учетной записи.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/harlequinОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- SQL без ограничений чтения может изменить данные в пределах прав подключенной учетной записи.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Harlequin позволяет редактировать и выполнять SQL в терминальном интерфейсе. В поставку входят DuckDB и адаптер SQLite, а подключение к другим базам добавляется отдельными пакетами. Пользователь выбирает соединение, работает с каталогом данных и просматривает результаты запросов. Для сценариев и агентов есть команда `hsql`, которая использует те же адаптеры и профили без интерактивного экрана. Она умеет выполнять запросы, показывать объекты схемы и искать по каталогу. Пользователь может ограничить запросы чтением и задать время выполнения, если выбранный адаптер поддерживает эти параметры.
Для кого. Аналитикам SQL, которым нужны ручной редактор и команда для агента с одинаковыми профилями подключения.
Подходит, если
- Локальную DuckDB или SQLite надо открыть в терминальном редакторе.
- Агенту требуется изучить схему без написания SQL-запросов.
- Один профиль подключения должен работать в ручной сессии и сценарии.
- Для исследовательского запроса нужны режим чтения и ограничение времени.
Не подходит, если
- Адаптер не умеет обеспечить обязательные ограничения чтения или времени.
- Нужна централизованная система согласования доступа к базам.
- Ожидается, что все внешние базы доступны без дополнительных адаптеров.
Пример запроса к агенту
Изучи каталог базы через hsql в режиме чтения и найди таблицы с customer_id, не извлекая пользовательские строки.Ограничения
Не все адаптеры входят в поставку Harlequin; дополнительные пакеты устанавливайте в то же окружение, что и сам клиент. Если указать несуществующий файл DuckDB, клиент может создать новую базу, поэтому проверяйте строку подключения. Ограничения `--read-only` и таймаута поддерживаются не каждым адаптером; если адаптер не может их обеспечить, клиент отказывается запускать запрос. Запросы без режима чтения используют права учетной записи и могут менять данные, поэтому для агента подготовьте отдельный профиль.
Как отключить. Завершите Harlequin или hsql и уберите ненужные профили. Закрытие клиента не откатывает уже выполненные запросы.
Частые вопросы
hsql устанавливается отдельно?
Нет. Он входит в Harlequin и использует те же адаптеры и настройки.
Какая база открывается без аргументов?
DuckDB в памяти. Перед работой с файлом проверьте переданный путь.
Как выбрать SQLite?
Укажите `--adapter sqlite` и нужный файл либо оставьте соединение в памяти.
Можно ли читать только структуру?
Да. Пример `hsql --catalog --path mydb.analytics` показывает объекты схемы, а `hsql --catalog-search customer_id` ищет по всему каталогу. Подставьте свои имена.
Как убрать пароли из общего профиля?
Подставляйте значения из переменных окружения по синтаксису конфигурации, храните реальные секреты отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыДесктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
SQL-клиент объединяет просмотр баз и пакетные запросы, чтобы агент работал с выбранным подключением и результатами в JSON.
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения
dblab, терминальный SQL-клиент, сохраняет профили подключений и может хранить пароли в системном хранилище ключей.
CLI выполняет SQL над CSV, JSON и другими табличными файлами, чтобы агент объединял выгрузки и менял формат результата.
CLI импортирует CSV и JSON в SQLite, выполняет SQL и меняет схему, чтобы агент готовил локальные наборы данных для анализа.
Коротко о README
Профили поддерживают подстановку окружения. Команда hsql может показывать, проверять и описывать схему конфигурации.