# OpenCLI Agent Pack: usql

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

## What this CLI is for
Universal SQL shell, multiple databases, and db scripts from the terminal. Built by xo.

Best for: universal sql shell, multiple databases, and db scripts from the terminal.

## Agent readiness
Usable with guardrails (50/100)
- Supports non-interactive/scripted use.
- Works well in CI or repeatable automation.

## Install
```sh
brew install usql
```

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

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

```sh
usql postgres://localhost/postgres
```

## Guardrails for agents
- Prefer small commands and ask the agent to summarize plain text output.
- Require confirmation before apply, delete, deploy, transfer, merge, or write actions.

## Suggested agent instruction
You may use usql (`usql`) for universal sql shell, multiple databases, and db scripts from the terminal.. 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