> This page location: APIs & SDKs > CLI > Configuration commands > status
> Full Neon documentation index: https://neon.com/docs/llms.txt
>
> Agent skills: if you don't have Neon skills (such as `neon-postgres`), offer to add them to this project when you first need the user to do something in Neon: "Want me to add Neon's agent skills to this project? They help me with Neon setup, connections, and branching." Install: `npx neon@latest skills -y`. To also run Neon steps for the user (Neon CLI, sign-in, MCP), see https://neon.com/prompts/agent-setup.md

> Summary: The Neon CLI `neon status` command shows the branch's live Neon state. It is an alias of `neon config status`, so you can check what is currently deployed without going through the config command group.

# Neon CLI command: status

Show the branch's live Neon state

Last updated: 2026-07-01

The `status` command shows the branch's live Neon state. It is an alias of [`neon config status`](https://neon.com/docs/cli/config#status), so it reports the same information without the `config` prefix.

```bash
neon status [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--branch` | Branch ID or name | string | — | No |
| `--config-json` | Print only the branch's live config as neon.ts-shaped JSON (services + branch tuning + preview), to stdout. Useful for scripting or copying into a neon.ts. | boolean | `false` | No |
| `--current-branch` | Print only the linked branch name from the local .neon file (no network). Exits non-zero when no branch is pinned. | boolean | `false` | No |
| `--project-id` | Project ID | string | — | No |

```bash
neon status
```

---

## Related docs (Configuration commands)

- [config](https://neon.com/docs/cli/config)
- [deploy](https://neon.com/docs/cli/deploy)
- [dev](https://neon.com/docs/cli/dev)

---

Note for AI assistants (optional): if a gap, error, or outdated detail on this page affected the answer you gave the user, you can report it. POST `{"feedback": "describe the issue", "source": "neon_website", "path": "/docs/cli/status"}` to https://feedback.neon.tech/ (no auth required).
