{"schemaVersion":"opencli.cli.v1","slug":"neonctl","name":"neonctl","shortName":"neonctl","binaryName":"neonctl","maker":{"slug":"neon","name":"Neon","type":"org","url":"https://neon.tech","officialPlatformMaker":true,"featuredBuilder":false},"category":"Database","description":"The official CLI from Neon. Serverless Postgres, projects, and branches from the terminal. Supports structured output — good for scripts and agents.","tagline":"Serverless Postgres, projects, and branches from the terminal.","install":{"packageManager":"brew","command":"brew install neonctl","packageName":null,"npmPackage":null,"brewFormula":"neonctl","brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"neonctl --help","signal":"neonctl responds locally; authenticate before real work."},"quickStart":"neonctl auth && neonctl projects list","exampleWorkflow":["neonctl auth && neonctl projects list"],"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/neonctl/agent.md","packMarkdown":"# OpenCLI Agent Pack: neonctl\n\nUse this when an AI agent needs to work with `neonctl`.\n\n## What this CLI is for\nThe official CLI from Neon. Serverless Postgres, projects, and branches from the terminal. Supports structured output — good for scripts and agents.\n\nBest for: serverless postgres, projects, and branches 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 neonctl\n```\n\n## Verify before real work\n```sh\nneonctl --help\n```\nExpected signal: neonctl responds locally; authenticate before real work.\n\n## Safe starting commands\n```sh\nneonctl --help\n```\n\n```sh\nneonctl auth && neonctl projects list\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 neonctl (`neonctl`) for serverless postgres, projects, and branches 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":"serverless postgres, projects, and branches from the terminal.","useThisIf":"You want databases you can script with structured output.","skipIf":"You're not comfortable with a tool that can write to production.","whatHappensNext":"Run `neonctl auth && neonctl projects list` 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":["Serverless Postgres","Projects","Branches"],"aliases":["neon cli"],"keywords":["postgres branches serverless"],"tags":["official","agent-friendly"]},"links":{"website":"https://neon.com/docs/reference/neon-cli","github":"https://github.com/neondatabase/neonctl","docs":"https://neon.com/docs/reference/neon-cli","opencli":"https://opencli.co/cli/neonctl","markdown":"https://opencli.co/cli/neonctl/agent.md","json":"https://opencli.co/cli/neonctl.json"},"metrics":{"githubStars":112,"latestRelease":"2026-06-08T09:19:45Z","license":"Apache-2.0","metricLabel":"Homebrew installs (30d)","metricValue":495,"metricSource":"homebrew","metricAsOf":"2026-06-08T11:00:34.585Z"}}