{"schemaVersion":"opencli.cli.v1","slug":"usql","name":"usql","shortName":"usql","binaryName":"usql","maker":{"slug":"xo","name":"xo","type":"small-team","url":"https://github.com/xo","officialPlatformMaker":false,"featuredBuilder":false},"category":"Database","description":"Universal SQL shell, multiple databases, and db scripts from the terminal. Built by xo.","tagline":"Universal SQL shell, multiple databases, and db scripts from the terminal.","install":{"packageManager":"brew","command":"brew install usql","packageName":null,"npmPackage":null,"brewFormula":"usql","brewCask":null,"crateName":"usql","pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"usql --version","signal":"usql responds locally and is ready for the first real command."},"quickStart":"usql postgres://localhost/postgres","exampleWorkflow":["usql postgres://localhost/postgres"],"agent":{"readiness":{"label":"Usable with guardrails","score":50,"reasons":["Supports non-interactive/scripted use.","Works well in CI or repeatable automation."],"guardrails":["Prefer small commands and ask the agent to summarize plain text output.","Require confirmation before apply, delete, deploy, transfer, merge, or write actions."]},"packUrl":"https://opencli.co/cli/usql/agent.md","packMarkdown":"# OpenCLI Agent Pack: usql\n\nUse this when an AI agent needs to work with `usql`.\n\n## What this CLI is for\nUniversal SQL shell, multiple databases, and db scripts from the terminal. Built by xo.\n\nBest for: universal sql shell, multiple databases, and db scripts from the terminal.\n\n## Agent readiness\nUsable with guardrails (50/100)\n- Supports non-interactive/scripted use.\n- Works well in CI or repeatable automation.\n\n## Install\n```sh\nbrew install usql\n```\n\n## Verify before real work\n```sh\nusql --version\n```\nExpected signal: usql responds locally and is ready for the first real command.\n\n## Safe starting commands\n```sh\nusql --version\n```\n\n```sh\nusql postgres://localhost/postgres\n```\n\n## Guardrails for agents\n- Prefer small commands and ask the agent to summarize plain text output.\n- Require confirmation before apply, delete, deploy, transfer, merge, or write actions.\n\n## Suggested agent instruction\nYou 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.\n\nSource: OpenCLI\n"},"fit":{"bestFor":"universal sql shell, multiple databases, and db scripts from the terminal.","useThisIf":"You need databases in both local dev and CI.","skipIf":"You don't work with databases.","whatHappensNext":"Run `usql postgres://localhost/postgres` and see what comes back."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":false,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":false,"requiresNetwork":false,"ciFriendly":true,"localFirst":false,"destructivePotential":"high"},"taxonomy":{"useCases":["Universal SQL shell","Multiple databases","DB scripts"],"aliases":["sql shell"],"keywords":["postgres mysql sqlite sql"],"tags":["builder","agent-friendly"]},"links":{"website":"https://github.com/xo/usql","github":"https://github.com/xo/usql","docs":"https://github.com/xo/usql","opencli":"https://opencli.co/cli/usql","markdown":"https://opencli.co/cli/usql/agent.md","json":"https://opencli.co/cli/usql.json"},"metrics":{"githubStars":9990,"latestRelease":"2026-04-13T16:00:06Z","license":"MIT","metricLabel":"crates recent downloads","metricValue":11,"metricSource":"crates.io","metricAsOf":"2026-06-08T11:00:49.970Z"}}