cubby db

Manage Neon Postgres databases for your apps. These commands require a Builder (

9.99/mo) or Pro (

19.99/mo) plan. SQLite apps do not use these commands — SQLite databases are auto-managed with no additional CLI needed.

Subcommands

Command	Description
`cubby db export`	Export database as SQL or CSV
`cubby db branch`	Create or delete a database branch
`cubby db branches`	List database branches
`cubby db snapshot`	Create a point-in-time snapshot
`cubby db snapshots`	List snapshots
`cubby db restore`	Restore from a snapshot

cubby db export

Export a Neon database as SQL or CSV. Output goes to stdout by default, or to a file with --output.

Usage

cubby db export [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required
`--format`	`-f`	Export format (`sql` or `csv`)	`sql`
`--output`	`-o`	Output file path (defaults to stdout)	—

Examples

# Export as SQL to stdout
cubby db export --app my-app

# Export as SQL to a file
cubby db export --app my-app --output backup.sql

# Export as CSV
cubby db export --app my-app --format csv

# Pipe to another tool
cubby db export --app my-app | psql local-db

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

SQLite apps: The cubby db export CLI command is for Neon Postgres apps only. To export a SQLite database, use the Export Data button in the dashboard. SQLite export requires the app to be running.

Stopped apps: If your app was stopped due to a plan downgrade, you can still export your Neon database from the dashboard regardless of your current plan.

cubby db branch

Create or delete a Neon database branch. Branches let you experiment with schema or data changes without affecting your main database.

Usage

cubby db branch [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required
`--branch-name`	—	Name for the new branch	Auto-generated
`--delete`	—	Delete a branch by name	—

Examples

# Create a branch with auto-generated name
cubby db branch --app my-app

# Create a named branch
cubby db branch --app my-app --branch-name feature-test

# Delete a branch
cubby db branch --app my-app --delete feature-test

Output

On success, the command prints the branch name and a connection string you can use to connect directly to the branch.

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

cubby db branches

List all database branches for an app.

Usage

cubby db branches [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required

Examples

cubby db branches --app my-app

Output

NAME                                CREATED                   DEFAULT
main                                Apr 1, 2026, 10:30 AM     yes
feature-test                        Apr 2, 2026, 02:15 PM

2 branch(es)

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

cubby db snapshot

Create a point-in-time snapshot of your Neon database. Use snapshots as restore points before risky migrations or data changes.

Usage

cubby db snapshot [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required

Examples

# Create a snapshot before running a migration
cubby db snapshot --app my-app

Output

Snapshot created
  Snapshot ID: snap-abc123
  Timestamp:   2026-04-02T14:30:00Z
  App:         my-app

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

cubby db snapshots

List all database snapshots for an app.

Usage

cubby db snapshots [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required

Examples

cubby db snapshots --app my-app

Output

ID                        NAME                                CREATED
snap-abc123               pre-migration-backup                Apr 1, 2026, 10:30 AM
snap-def456               weekly-backup                       Mar 25, 2026, 08:00 AM

2 snapshot(s)

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

cubby db restore

Restore a Neon database from a snapshot. This is a non-destructive operation — it creates a new branch at the snapshot point. Your original data is unchanged.

Usage

cubby db restore [flags]

Flags

Flag	Short	Description	Default
`--app`	`-a`	App name	Required
`--snapshot`	`-s`	Snapshot ID to restore from	Required

Examples

# Restore from a specific snapshot
cubby db restore --app my-app --snapshot snap-abc123

Output

Restore complete
  Branch:     restore-snap-abc123
  Connection: postgres://...
  Restored:   from snapshot snap-abc123

Note: This is a non-destructive restore. A new branch was created
at the snapshot point. Your original data is unchanged.

Tier

Builder (

9.99/mo) or Pro (

19.99/mo) required.

Troubleshooting

”403 Forbidden” or “PLAN_LIMIT_REACHED”

Your plan does not include Neon Postgres. Upgrade to Builder (

9.99/mo) or Pro (

19.99/mo) at app.cubby.pro/billing.

”App not found”

Check your app name with:

cubby apps

“No database configured”

This app uses SQLite, not Neon Postgres. The cubby db commands only work with Neon Postgres apps. SQLite databases are auto-managed and do not require CLI commands.

”Not logged in”

Authenticate first:

cubby login

cubby deploy — Deploy your app
cubby secrets — Manage environment variables
cubby apps — List your apps

​cubby db

​Subcommands

​cubby db export

​Usage

​Flags

​Examples

​Tier

​cubby db branch

​Usage

​Flags

​Examples

​Output

​Tier

​cubby db branches

​Usage

​Flags

​Examples

​Output

​Tier

​cubby db snapshot

​Usage

​Flags

​Examples

​Output

​Tier

​cubby db snapshots

​Usage

​Flags

​Examples

​Output

​Tier

​cubby db restore

​Usage

​Flags

​Examples

​Output

​Tier

​Troubleshooting

​”403 Forbidden” or “PLAN_LIMIT_REACHED”

​”App not found”

​“No database configured”

​”Not logged in”

​Related Commands

cubby db

Subcommands

cubby db export

Usage

Flags

Examples

Tier

cubby db branch

Usage

Flags

Examples

Output

Tier

cubby db branches

Usage

Flags

Examples

Output

Tier

cubby db snapshot

Usage

Flags

Examples

Output

Tier

cubby db snapshots

Usage

Flags

Examples

Output

Tier

cubby db restore

Usage

Flags

Examples

Output

Tier

Troubleshooting

”403 Forbidden” or “PLAN_LIMIT_REACHED”

”App not found”

“No database configured”

”Not logged in”

Related Commands