Skip to content

neonctl

OfficialAgent-readyData & DBDatabase

Serverless Postgres, projects, and branches from the terminal.

The official CLI from Neon. Serverless Postgres, projects, and branches from the terminal. Supports structured output — good for scripts and agents.

Task fit

serverless postgres, projects, and branches from the terminal.

Lane

Inspect schemas, run safe queries, and understand your data fast.

Operator brief

Use neonctl for serverless postgres, projects, and branches from the terminal.

Run `neonctl auth && neonctl projects list` and see what comes back.

Repository family

Neon

First trust check

neonctl responds locally and you can move on to authentication or project setup.

Safe first loop

Install, verify, then run one real command.

Safe database loop

Install command

$ brew install neonctl

Operator pack

Copy or export the working notes for this CLI before handing it to an agent.

Verify

$ neonctl --help

neonctl responds locally and you can move on to authentication or project setup.

First real command

$ neonctl auth && neonctl projects list

First steps

  1. 01Install neonctl.
  2. 02Run `neonctl --help` first.
  3. 03Start with `neonctl auth && neonctl projects list`.
  4. 04Authenticate neonctl before asking the agent to do real work.

When to use / hold off when

Best for

serverless postgres, projects, and branches from the terminal.

Use this when

You want databases you can script with structured output.

Hold off when

You're not comfortable with a tool that can write to production.

Trust and constraints

trusted99/100
OfficialInstall readyTrustedCaution
JSON outputYes
Non-interactiveYes
CI-friendlyYes

Why operators pick it

  • neonctl fits data & db well, especially for serverless postgres, projects, and branches from the terminal.
  • It is the official CLI from Neon.
  • Good for scripts and agents.

Constraints

  • Sign in before real work.
  • Needs network access.
  • Start with read-only or dry-run commands.

Repository context

Other CLIs in this family

This is the only CLI surfaced from this family right now.

Facts and links

Install withbrew
Homebrew installs (30d)804
GitHub stars105
LicenseApache-2.0
UpdatedMar 16, 2026