# OpenCLI Agent Pack: neonctl

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

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

Best for: serverless postgres, projects, and branches from the terminal.

## Agent readiness
Great for agents (75/100)
- Structured output is available for parsing.
- Supports non-interactive/scripted use.
- Works well in CI or repeatable automation.

## Install
```sh
brew install neonctl
```

## Verify before real work
```sh
neonctl --help
```
Expected signal: neonctl responds locally; authenticate before real work.

## Safe starting commands
```sh
neonctl --help
```

```sh
neonctl auth && neonctl projects list
```

## Guardrails for agents
- 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.

## Suggested agent instruction
You 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.

Source: OpenCLI