# OpenCLI Agent Pack: Harlequin

Use this when an AI agent needs to work with `harlequin`.

## What this CLI is for
A SQL IDE for DuckDB, SQLite, and Postgres in the terminal. Built by Ted Conbeer. Start with `harlequin` and go from there. Runs entirely on your machine.

Best for: Exploring local SQL visually when a prompt-only shell is too cramped.

## Agent readiness
Human-first CLI (10/100)
- Can run locally with less credential exposure.

## Install
```sh
brew install harlequin
```

## Verify before real work
```sh
harlequin --version
```
Expected signal: harlequin responds locally and is ready for the first real command.

## Safe starting commands
```sh
harlequin --version
```

```sh
harlequin
```

```sh
harlequin --adapter sqlite
```

```sh
harlequin --help
```

## Guardrails for agents
- Prefer small commands and ask the agent to summarize plain text output.
- Expect prompts; keep a human in the loop for interactive flows.
- Start read-only, then ask before mutations.

## Suggested agent instruction
You may use Harlequin (`harlequin`) for exploring local sql visually when a prompt-only shell is too cramped.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.

Source: OpenCLI