{"schemaVersion":"opencli.cli.v1","slug":"bq","name":"bq CLI","shortName":"bq","binaryName":"bq","maker":{"slug":"google","name":"Google","type":"org","url":"https://google.com","officialPlatformMaker":true,"featuredBuilder":false},"category":"Data","description":"The official CLI from Google. BigQuery, data warehouse, and sql analytics from the terminal. Supports structured output — good for scripts and agents.","tagline":"BigQuery, data warehouse, and sql analytics from the terminal.","install":{"packageManager":"brew","command":"brew install --cask google-cloud-sdk","packageName":null,"npmPackage":null,"brewFormula":null,"brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"bq ls --format=json","signal":"Returns accessible BigQuery datasets as JSON."},"quickStart":"bq ls --format=json","exampleWorkflow":["bq ls --format=json"],"agent":{"readiness":{"label":"Great for agents","score":75,"reasons":["Structured output is available for parsing.","Supports non-interactive/scripted use.","Works well in CI or repeatable automation."],"guardrails":["Verify identity/account before running task commands.","Network access is required; avoid leaking secrets in logs.","Require confirmation before apply, delete, deploy, transfer, merge, or write actions."]},"packUrl":"https://opencli.co/cli/bq/agent.md","packMarkdown":"# OpenCLI Agent Pack: bq CLI\n\nUse this when an AI agent needs to work with `bq`.\n\n## What this CLI is for\nThe official CLI from Google. BigQuery, data warehouse, and sql analytics from the terminal. Supports structured output — good for scripts and agents.\n\nBest for: bigquery, data warehouse, and sql analytics from the terminal.\n\n## Agent readiness\nGreat for agents (75/100)\n- Structured output is available for parsing.\n- Supports non-interactive/scripted use.\n- Works well in CI or repeatable automation.\n\n## Install\n```sh\nbrew install --cask google-cloud-sdk\n```\n\n## Verify before real work\n```sh\nbq ls --format=json\n```\nExpected signal: Returns accessible BigQuery datasets as JSON.\n\n## Safe starting commands\n```sh\nbq ls --format=json\n```\n\n## Guardrails for agents\n- Verify identity/account before running task commands.\n- Network access is required; avoid leaking secrets in logs.\n- Require confirmation before apply, delete, deploy, transfer, merge, or write actions.\n\n## Suggested agent instruction\nYou may use bq CLI (`bq`) for bigquery, data warehouse, and sql analytics 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":"bigquery, data warehouse, and sql analytics from the terminal.","useThisIf":"You want data processing you can script with structured output.","skipIf":"You're not comfortable with a tool that can write to production.","whatHappensNext":"Run `bq ls --format=json` and see what comes back."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":true,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":true,"requiresNetwork":true,"ciFriendly":true,"localFirst":false,"destructivePotential":"high"},"taxonomy":{"useCases":["BigQuery","Data warehouse","SQL analytics"],"aliases":[],"keywords":["bigquery","data","sql"],"tags":[]},"links":{"website":"https://cloud.google.com/bigquery/docs/bq-command-line-tool","github":"https://github.com/google-cloud-sdk-unofficial/google-cloud-sdk","docs":"https://cloud.google.com/bigquery/docs/bq-command-line-tool","opencli":"https://opencli.co/cli/bq","markdown":"https://opencli.co/cli/bq/agent.md","json":"https://opencli.co/cli/bq.json"},"metrics":{"githubStars":20,"latestRelease":"2026-05-28T04:50:44Z","license":"NOASSERTION","metricLabel":"Homebrew installs (30d)","metricValue":58223,"metricSource":"homebrew","metricAsOf":"2026-06-08T11:01:06.967Z"}}