neon 3.1.1 → 3.2.0

package/README.md

@@ -352,6 +352,19 @@ How today's `set-context` uses map onto `link`:
 
 The key difference: `link` resolves and **verifies** before writing (so you never get a half-written or stale `.neon`), whereas `set-context` writes whatever you give it verbatim. The closest like-for-like replacement for the old raw write is `link --no-checks`.
 
+### open
+
+`open` launches the linked project's page in the Neon Console. It reads the closest `.neon` file without authenticating or calling the Neon API, so it works from any sub-directory of a linked project.
+
+```bash
+neon open
+
+# Open a project without changing the linked context
+neon open --project-id polished-snowflake-12345678
+```
+
+A branch pinned in `.neon` does not change the destination. `.neon` stores the branch as a name, while the Console route requires its ID; resolving it would turn this local command into an authenticated API call.
+
 ### checkout
 
 `checkout [id|name]` pins a branch in the local context so subsequent commands target it — it's the focused companion to `link` for the common "switch the branch I'm working on" case (`link` resolves org + project; `checkout` pins the branch). It resolves the branch (by name or id) against the project, then **heals** the `.neon` file: it always (re)writes `projectId`, `branch`, and `orgId` (when the project has one), so a `.neon` that was missing fields or drifted ends up complete and consistent. The branch is stored as its **name** when known (matching `link`). When `orgId` isn't already known (from `--org-id` or the existing `.neon`), it's looked up from the project itself.
@@ -1044,6 +1057,7 @@ API keys in org-7
 | checkout                                                                   |                                                                                                              | Pin a branch in `.neon`            |
 | diff                                                                       |                                                                                                              | Git-style schema diff vs a branch  |
 | [link](https://neon.com/docs/reference/cli-link)                           |                                                                                                              | Link a directory to a project      |
+| open                                                                       |                                                                                                              | Open the linked project in Console |
 | config                                                                     | `init`, `status`, `plan`, `apply`                                                                            | Drive a branch from `neon.ts`      |
 | deploy                                                                     |                                                                                                              | Alias for `config apply`           |
 | bootstrap                                                                  |                                                                                                              | Scaffold a project from a template |

package/dist/commands/auth.js

@@ -174,6 +174,7 @@ const ensureAuth = async (props) => {
 	if (isCurrentBranchProbe(props)) return;
 	if (isConfigInit(props)) return;
 	if (isProfileCommand(props)) return;
+	if (props._[0] === "open") return;
 	const isLocalDev = props._[0] === "dev";
 	const isBootstrap = props._[0] === "bootstrap";
 	const isInit = props._[0] === "init";

package/dist/commands/index.js

@@ -21,6 +21,7 @@ import { t as inspect_exports } from "./inspect.js";
 import { t as ip_allow_exports } from "./ip_allow.js";
 import { t as logs_exports } from "./logs.js";
 import { t as neon_auth_exports } from "./neon_auth.js";
+import { t as open_exports } from "./open.js";
 import { t as operations_exports } from "./operations.js";
 import { t as orgs_exports } from "./orgs.js";
 import { t as profile_exports } from "./profile.js";
@@ -55,6 +56,7 @@ var commands_default = [
 	set_context_exports,
 	checkout_exports,
 	link_exports,
+	open_exports,
 	init_exports,
 	data_api_exports,
 	functions_exports,

package/dist/commands/open.js

@@ -0,0 +1,33 @@
+import { t as __exportAll } from "../_chunks/rolldown-runtime-D7D4PA-g.js";
+import { log } from "../log.js";
+import { getCliName } from "../utils/cli_name.js";
+import open from "open";
+//#region src/commands/open.ts
+var open_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler,
+	projectConsoleUrl: () => projectConsoleUrl
+});
+const command = "open";
+const describe = "Open the linked project in the Neon Console";
+const builder = (argv) => argv.usage("$0 open [options]").option("project-id", {
+	describe: "Project ID (defaults to the project linked in .neon)",
+	type: "string"
+}).example("$0 open", describe);
+const projectConsoleUrl = (projectId) => `https://console.neon.tech/app/projects/${encodeURIComponent(projectId)}`;
+const handler = async (props) => {
+	if (!props.projectId) throw new Error(`No Neon project linked. Run \`${getCliName()} link\` to link this directory to a project.`);
+	const url = projectConsoleUrl(props.projectId);
+	log.info("Opening %s in your browser.", url);
+	const subprocess = await open(url);
+	await new Promise((resolve, reject) => {
+		subprocess.once("spawn", resolve);
+		subprocess.once("error", (error) => {
+			reject(/* @__PURE__ */ new Error(`Failed to open the Neon Console in your browser. Open ${url} manually. ${error.message}`));
+		});
+	});
+};
+//#endregion
+export { builder, command, describe, handler, projectConsoleUrl, open_exports as t };

package/dist/index.js

@@ -27,6 +27,7 @@ const NO_SUBCOMMANDS_VERBS = [
 	"set-context",
 	"checkout",
 	"link",
+	"open",
 	"init",
 	"dev",
 	"deploy",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -97,8 +97,8 @@
     "typescript": "^5.9.0",
     "vitest": "^3.0.9",
     "@neon-internals/cli-core": "0.0.0",
-    "@neon-internals/env-core": "0.0.0",
-    "@neon/e2e-harness": "0.0.0"
+    "@neon/e2e-harness": "0.0.0",
+    "@neon-internals/env-core": "0.0.0"
   },
   "publishConfig": {
     "access": "public",