---
name: neonctl
slug: neonctl
type: github
source_url: https://github.com/neondatabase/neonctl
organization: Neon
organization_slug: neon
total_releases: 86
latest_version: v2.22.0
latest_date: 2026-03-16
last_updated: 2026-04-19
tracking_since: 2023-07-18
canonical: https://releases.sh/neon/neonctl
organization_url: https://releases.sh/neon
---

<Release version="v2.22.0" date="March 16, 2026" published="2026-03-16T18:48:06.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.22.0">
# [2.22.0](https://github.com/neondatabase/neonctl/compare/v2.21.2...v2.22.0) (2026-03-16)


### Features

* update neon-init package version to support more agents ([4a3df83](https://github.com/neondatabase/neonctl/commit/4a3df839af2cc56cd0f6821fd3a4923d8b732222))




</Release>

<Release version="v2.21.2" date="February 26, 2026" published="2026-02-26T11:43:38.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.21.2">
## [2.21.2](https://github.com/neondatabase/neonctl/compare/v2.21.1...v2.21.2) (2026-02-26)


### Bug Fixes

* add additional analytics middlware for auth error ([3ffb649](https://github.com/neondatabase/neonctl/commit/3ffb64984b5333c33cbcc8227f032651147e669f))
* run auth middleware before analytics ([5483365](https://github.com/neondatabase/neonctl/commit/5483365a842ba4aaffe516e07dfd68c8ede707f2))




</Release>

<Release version="v2.21.1" date="February 25, 2026" published="2026-02-25T17:45:44.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.21.1">
## [2.21.1](https://github.com/neondatabase/neonctl/compare/v2.21.0...v2.21.1) (2026-02-25)


### Bug Fixes

* enable telemetry for neon-init ([6d74f9a](https://github.com/neondatabase/neonctl/commit/6d74f9a2db5cf5ff83247d665c625abc8aa1dd9a))




</Release>

<Release version="v2.21.0" date="February 19, 2026" published="2026-02-19T20:05:12.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.21.0">
# [2.21.0](https://github.com/neondatabase/neonctl/compare/v2.20.3...v2.21.0) (2026-02-19)


### Bug Fixes

* change bun.lock ([fe22d79](https://github.com/neondatabase/neonctl/commit/fe22d79edee5d005de3cadc992527e75391f6c3a))


### Features

* allow agent flags for neon init ([2d89432](https://github.com/neondatabase/neonctl/commit/2d89432d6b5229675ba874d479553dfe106b2e75))




</Release>

<Release version="v2.20.3" date="February 19, 2026" published="2026-02-19T09:06:13.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.20.3">
## [2.20.3](https://github.com/neondatabase/neonctl/compare/v2.20.2...v2.20.3) (2026-02-19)


### Bug Fixes

* update skills to install specific neon skill ([55102f0](https://github.com/neondatabase/neonctl/commit/55102f0bc157b3d6d1d853a0d877190eeeae6664))




</Release>

<Release version="v2.20.1" date="January 29, 2026" published="2026-01-29T16:18:02.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.20.1">
## [2.20.1](https://github.com/neondatabase/neonctl/compare/v2.20.0...v2.20.1) (2026-01-12)


### Bug Fixes

* bump neon-init version to support node v24 ([b44e485](https://github.com/neondatabase/neonctl/commit/b44e485eab6f2a56640f005faf41c69fc70cc549))




</Release>

<Release version="v2.20.0" date="January 29, 2026" published="2026-01-29T16:18:01.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.20.0">
# [2.20.0](https://github.com/neondatabase/neonctl/compare/v2.19.1...v2.20.0) (2026-01-09)


### Features

* bump neon-init version to incorporate extension ([4e2ae9d](https://github.com/neondatabase/neonctl/commit/4e2ae9d2e016f2a130b1a2b75aab2797b4010061))




</Release>

<Release version="v2.20.2" date="January 29, 2026" published="2026-01-29T10:27:22.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.20.2">
## [2.20.2](https://github.com/neondatabase/neonctl/compare/v2.20.1...v2.20.2) (2026-01-29)


### Bug Fixes

* add cotent permissions to release gh app ([d60484f](https://github.com/neondatabase/neonctl/commit/d60484f3b8375b5bd2a90602a35dbfbba7f64032))




</Release>

<Release version="v2.19.1" date="January 9, 2026" published="2026-01-09T13:40:28.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.19.1">
## [2.19.1](https://github.com/neondatabase/neonctl/compare/v2.19.0...v2.19.1) (2026-01-09)


### Bug Fixes

* resolve misleading "org_id is required" error for project-scoped commands ([7738d83](https://github.com/neondatabase/neonctl/commit/7738d83abbd1d0978bd92c5304114cdfcd647064)), closes [#382](https://github.com/neondatabase/neonctl/issues/382)




</Release>

<Release version="v2.19.0" date="December 11, 2025" published="2025-12-11T12:25:09.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.19.0">
# [2.19.0](https://github.com/neondatabase/neonctl/compare/v2.18.1...v2.19.0) (2025-12-11)


### Features

* add --recoverable-only flag to projects list command ([7786b2b](https://github.com/neondatabase/neonctl/commit/7786b2b7ec2086e84a07229cc0b73a2c82599dfc))
* add recover command for deleted projects ([b735342](https://github.com/neondatabase/neonctl/commit/b73534227f75464ff870daa2ea631234f5773a3c))




</Release>

<Release version="v2.18.1" date="November 18, 2025" published="2025-11-18T14:52:49.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.18.1">
## [2.18.1](https://github.com/neondatabase/neonctl/compare/v2.18.0...v2.18.1) (2025-11-18)


### Bug Fixes

* change description text ([eb2dbe6](https://github.com/neondatabase/neonctl/commit/eb2dbe6c1c745a920143dea20e31518312084ef5))
* fix description text ([f4739bc](https://github.com/neondatabase/neonctl/commit/f4739bc896c8dd25284d11a34574deb353c0f72f))




</Release>

<Release version="v2.18.0" date="November 14, 2025" published="2025-11-14T14:32:52.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.18.0">
# [2.18.0](https://github.com/neondatabase/neonctl/compare/v2.17.1...v2.18.0) (2025-11-14)


### Bug Fixes

* branches list when there is ttl branch ([1a6ec5b](https://github.com/neondatabase/neonctl/commit/1a6ec5b7b9b94fea633fdfb4906a455c77f12b49)), closes [#379](https://github.com/neondatabase/neonctl/issues/379)


### Features

* branches list displays meta icons ([116d9c9](https://github.com/neondatabase/neonctl/commit/116d9c9c8d1474297ddcc16704df0e3370e18c94))




</Release>

<Release version="v2.17.1" date="November 4, 2025" published="2025-11-04T13:44:15.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.17.1">
## [2.17.1](https://github.com/neondatabase/neonctl/compare/v2.17.0...v2.17.1) (2025-11-04)


### Bug Fixes

* send a user id for anonymous users ([0bb4c18](https://github.com/neondatabase/neonctl/commit/0bb4c182bde30c126bd8c9cd6437c397722f15d0))




</Release>

<Release version="v2.17.0" date="October 31, 2025" published="2025-10-31T17:31:38.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.17.0">
# [2.17.0](https://github.com/neondatabase/neonctl/compare/v2.16.3...v2.17.0) (2025-10-31)


### Features

* use mcp resource instead of agent rules in init command ([92e2947](https://github.com/neondatabase/neonctl/commit/92e2947612564be547ebbae921b9ab302a3caab0))




</Release>

<Release version="v2.16.3" date="October 30, 2025" published="2025-10-30T13:00:23.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.16.3">
## [2.16.3](https://github.com/neondatabase/neonctl/compare/v2.16.2...v2.16.3) (2025-10-30)


### Bug Fixes

* update pkg to @yao/pkg due to deprecation and compatibilty issues ([b547966](https://github.com/neondatabase/neonctl/commit/b5479661abb37782af6ec03e3ef5b9ce3c58edfa))




</Release>

<Release version="v2.16.2" date="October 29, 2025" published="2025-10-29T09:21:05.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.16.2">
## [2.16.2](https://github.com/neondatabase/neonctl/compare/v2.16.1...v2.16.2) (2025-10-29)


### Bug Fixes

* delete package-log ([254c7cb](https://github.com/neondatabase/neonctl/commit/254c7cbefd1ec579ad4ed14f5037ac430bc86291))
* skip auth and bundle in neon-init ([413d3f6](https://github.com/neondatabase/neonctl/commit/413d3f61d4b9fcbf2344b79031bb9721e24c2b9a))
* update lockfile ([9a74d3b](https://github.com/neondatabase/neonctl/commit/9a74d3b78c5562b2b0a5784ddba90d1296dcdc06))
* update neon-init package version ([373e89e](https://github.com/neondatabase/neonctl/commit/373e89e2ed4c1b6d3df870b0a57d072bad6f5622))




</Release>

<Release version="v2.16.1" date="October 24, 2025" published="2025-10-24T15:46:42.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.16.1">
## [2.16.1](https://github.com/neondatabase/neonctl/compare/v2.16.0...v2.16.1) (2025-10-24)


### Bug Fixes

* downgrade execa to avoid breaking standalone binary ([9821b95](https://github.com/neondatabase/neonctl/commit/9821b95956a2642b3025bd0683c610fb72cdfb61))




</Release>

<Release version="v2.16.0" date="October 23, 2025" published="2025-10-23T14:38:51.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.16.0">
# [2.16.0](https://github.com/neondatabase/neonctl/compare/v2.15.1...v2.16.0) (2025-10-23)


### Bug Fixes

* add lockfile changes ([f28603f](https://github.com/neondatabase/neonctl/commit/f28603f7d1498ed775670278beba8a41bb4784a2))
* change lockfile used to bun.lock ([dd6e66b](https://github.com/neondatabase/neonctl/commit/dd6e66bf9ebc1b59cba6fe02ae84fc4ee0b257dd))
* update snapshot ([d2c76b3](https://github.com/neondatabase/neonctl/commit/d2c76b35ba5a5f2f66f1883a7d0179897a468dca))


### Features

* add init command to neonctl ([901b51f](https://github.com/neondatabase/neonctl/commit/901b51f08f6895fece80ca8db62c8f9838d26075))
* update init logic ([23b4849](https://github.com/neondatabase/neonctl/commit/23b48491bffc318b369655398f1e063e3ce276d5))
* use execa and clean up code ([40a678c](https://github.com/neondatabase/neonctl/commit/40a678c05b4b194da5b6e95eadf7d5c6791e6424))




</Release>

<Release version="v2.15.1" date="October 8, 2025" published="2025-10-08T09:54:08.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.15.1">
## [2.15.1](https://github.com/neondatabase/neonctl/compare/v2.15.0...v2.15.1) (2025-10-08)


### Bug Fixes

* allow parent branches with numeric characters ([13b93cf](https://github.com/neondatabase/neonctl/commit/13b93cfc73ecf2f6b2adce16fda13091163e4350))
* tests ([273ed24](https://github.com/neondatabase/neonctl/commit/273ed24d3be786a85d4ae36489ccf212bef00b8f))
* tests ([931a841](https://github.com/neondatabase/neonctl/commit/931a841e99e8de80fd042cf8c27e9a70d6f5583f))




</Release>

<Release version="v2.15.0" date="August 14, 2025" published="2025-08-14T11:44:22.000Z" url="https://github.com/neondatabase/neonctl/releases/tag/v2.15.0">
# [2.15.0](https://github.com/neondatabase/neonctl/compare/v2.14.0...v2.15.0) (2025-08-14)


### Features

* show `set-expiration` command in the help output ([631a945](https://github.com/neondatabase/neonctl/commit/631a945c1e78f0111dabbf071d637eb3ecb44dfe))




</Release>

<Pagination page="1" total-pages="5" total-items="86" next="https://releases.sh/neon/neonctl.md?page=2" />