@minuque/no-pi-no-gang 0.0.3

package/.next/types/routes.d.ts

@@ -0,0 +1,94 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+
+type AppRoutes = "/"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cwd/validate" | "/api/default-cwd" | "/api/files/[...path]" | "/api/home" | "/api/models" | "/api/models-config" | "/api/models-config/test" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/context" | "/api/sessions/new" | "/api/skills" | "/api/skills/install" | "/api/skills/search"
+type PageRoutes = never
+type LayoutRoutes = "/"
+type RedirectRoutes = never
+type RewriteRoutes = never
+type Routes = AppRoutes | PageRoutes | LayoutRoutes | RedirectRoutes | RewriteRoutes | AppRouteHandlerRoutes
+
+
+interface ParamMap {
+  "/": {}
+  "/api/agent/[id]": { "id": string; }
+  "/api/agent/[id]/events": { "id": string; }
+  "/api/agent/new": {}
+  "/api/auth/all-providers": {}
+  "/api/auth/api-key/[provider]": { "provider": string; }
+  "/api/auth/login/[provider]": { "provider": string; }
+  "/api/auth/logout/[provider]": { "provider": string; }
+  "/api/auth/providers": {}
+  "/api/cwd/validate": {}
+  "/api/default-cwd": {}
+  "/api/files/[...path]": { "path": string[]; }
+  "/api/home": {}
+  "/api/models": {}
+  "/api/models-config": {}
+  "/api/models-config/test": {}
+  "/api/sessions": {}
+  "/api/sessions/[id]": { "id": string; }
+  "/api/sessions/[id]/context": { "id": string; }
+  "/api/sessions/new": {}
+  "/api/skills": {}
+  "/api/skills/install": {}
+  "/api/skills/search": {}
+}
+
+
+export type ParamsOf<Route extends Routes> = ParamMap[Route]
+
+interface LayoutSlotMap {
+  "/": never
+}
+
+
+export type { AppRoutes, PageRoutes, LayoutRoutes, RedirectRoutes, RewriteRoutes, ParamMap, AppRouteHandlerRoutes }
+
+declare global {
+  /**
+   * Props for Next.js App Router page components
+   * @example
+   * ```tsx
+   * export default function Page(props: PageProps<'/blog/[slug]'>) {
+   *   const { slug } = await props.params
+   *   return <div>Blog post: {slug}</div>
+   * }
+   * ```
+   */
+  interface PageProps<AppRoute extends AppRoutes> {
+    params: Promise<ParamMap[AppRoute]>
+    searchParams: Promise<Record<string, string | string[] | undefined>>
+  }
+
+  /**
+   * Props for Next.js App Router layout components
+   * @example
+   * ```tsx
+   * export default function Layout(props: LayoutProps<'/dashboard'>) {
+   *   return <div>{props.children}</div>
+   * }
+   * ```
+   */
+  type LayoutProps<LayoutRoute extends LayoutRoutes> = {
+    params: Promise<ParamMap[LayoutRoute]>
+    children: React.ReactNode
+  } & {
+    [K in LayoutSlotMap[LayoutRoute]]: React.ReactNode
+  }
+
+  /**
+   * Context for Next.js App Router route handlers
+   * @example
+   * ```tsx
+   * export async function GET(request: NextRequest, context: RouteContext<'/api/users/[id]'>) {
+   *   const { id } = await context.params
+   *   return Response.json({ id })
+   * }
+   * ```
+   */
+  interface RouteContext<AppRouteHandlerRoute extends AppRouteHandlerRoutes> {
+    params: Promise<ParamMap[AppRouteHandlerRoute]>
+  }
+}

package/.next/types/validator.ts

@@ -0,0 +1,268 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+// This file validates that all pages and layouts export the correct types
+
+import type { AppRoutes, LayoutRoutes, ParamMap, AppRouteHandlerRoutes } from "./routes.js"
+import type { ResolvingMetadata, ResolvingViewport } from "next/types.js"
+import type { NextRequest } from 'next/server.js'
+
+type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
+  default: React.ComponentType<{ params: Promise<ParamMap[Route]> } & any> | ((props: { params: Promise<ParamMap[Route]> } & any) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
+  default: React.ComponentType<LayoutProps<Route>> | ((props: LayoutProps<Route>) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRoutes> = {
+  GET?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  POST?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PUT?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PATCH?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  DELETE?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  HEAD?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  OPTIONS?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+}
+
+
+// Validate ../../app/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/agent/[id]/events/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]/events">> = Specific
+  const handler = {} as typeof import("../../app/api/agent/[id]/events/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/agent/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/agent/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/agent/new/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/new">> = Specific
+  const handler = {} as typeof import("../../app/api/agent/new/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/auth/all-providers/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/auth/all-providers">> = Specific
+  const handler = {} as typeof import("../../app/api/auth/all-providers/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/auth/api-key/[provider]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/auth/api-key/[provider]">> = Specific
+  const handler = {} as typeof import("../../app/api/auth/api-key/[provider]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/auth/login/[provider]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/auth/login/[provider]">> = Specific
+  const handler = {} as typeof import("../../app/api/auth/login/[provider]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/auth/logout/[provider]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/auth/logout/[provider]">> = Specific
+  const handler = {} as typeof import("../../app/api/auth/logout/[provider]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/auth/providers/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/auth/providers">> = Specific
+  const handler = {} as typeof import("../../app/api/auth/providers/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/cwd/validate/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/cwd/validate">> = Specific
+  const handler = {} as typeof import("../../app/api/cwd/validate/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/default-cwd/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/default-cwd">> = Specific
+  const handler = {} as typeof import("../../app/api/default-cwd/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/files/[...path]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/files/[...path]">> = Specific
+  const handler = {} as typeof import("../../app/api/files/[...path]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/home/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/home">> = Specific
+  const handler = {} as typeof import("../../app/api/home/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/models-config/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models-config">> = Specific
+  const handler = {} as typeof import("../../app/api/models-config/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/models-config/test/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models-config/test">> = Specific
+  const handler = {} as typeof import("../../app/api/models-config/test/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/models/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models">> = Specific
+  const handler = {} as typeof import("../../app/api/models/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/sessions/[id]/context/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]/context">> = Specific
+  const handler = {} as typeof import("../../app/api/sessions/[id]/context/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/sessions/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/sessions/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/sessions/new/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/new">> = Specific
+  const handler = {} as typeof import("../../app/api/sessions/new/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/sessions/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions">> = Specific
+  const handler = {} as typeof import("../../app/api/sessions/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/skills/install/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills/install">> = Specific
+  const handler = {} as typeof import("../../app/api/skills/install/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/skills/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills">> = Specific
+  const handler = {} as typeof import("../../app/api/skills/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/skills/search/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills/search">> = Specific
+  const handler = {} as typeof import("../../app/api/skills/search/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+
+
+
+
+// Validate ../../app/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agegr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# no-pi-no-gang
+
+<p align="center">
+  <img src="public/pi-logo-on-dark.svg" alt="pi logo" width="100" />
+</p>
+
+<p align="center">
+  <strong><a href="https://github.com/badlogic/pi-mono">pi.dev</a></strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.0.1-blue" alt="version" />
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
+  <img src="https://img.shields.io/badge/Bun-≥1.0-fbf0df?logo=bun&logoColor=000" alt="Bun" />
+  <img src="https://img.shields.io/badge/Next.js-16-black" alt="Next.js 16" />
+  <img src="https://img.shields.io/badge/React-19-149eca" alt="React 19" />
+</p>
+
+## 概述
+
+no-pi-no-gang 是 [pi.dev](https://github.com/badlogic/pi-mono) 的 Web UI——浏览器中的完整会话体验，附带图形化会话浏览、文件工作台和模型配置。沿用 pi 的 `.jsonl` + `AgentSession` 事实源模型，不引入额外持久层。
+
+## 功能
+
+| 能力 | 说明 |
+|---|---|
+| 会话浏览 | 按工作目录聚合本地 pi 会话，读取历史消息和分支树 |
+| 实时对话 | SSE 流式响应、工具调用、思考/压缩态可视化 |
+| Fork / Branch | 文件级 Fork + 同文件内消息分支切换 |
+| 模型配置 | 界面内切换模型、配置工具集、管理供应商 |
+| 技能管理 | 搜索、安装、查看技能配置 |
+| 文件工作台 | 侧边栏浏览工作目录，辅助上下文追溯 |
+| 运行态恢复 | 刷新后自动检测并重连 SSE |
+
+## 安装
+
+```bash
+# 配置 GitHub Packages registry（仅需一次）
+npm config set @minuque:registry https://npm.pkg.github.com/
+
+# Unix: 从 bash 读取 GH_TOKEN
+npm login --registry=https://npm.pkg.github.com
+# Username: 你的 GitHub 用户名
+# Password: GitHub personal access token（需 write:packages 权限）
+
+# 安装为项目依赖
+npm install @minuque/no-pi-no-gang
+
+# 或直接运行
+npx @minuque/no-pi-no-gang
+```
+
+## 本地开发
+
+```bash
+bun install
+bun run dev                     # → http://localhost:7777
+
+bun run build
+bun run start                   # → http://localhost:7777
+```
+
+## 架构
+
+no-pi-no-gang 是基于 pi 的 Web UI：浏览器负责交互，Next.js API 层转发命令，`AgentSession` 运行智能体逻辑，`~/.pi/agent/` 落盘历史。
+
+![架构总览](docs/architecture.svg)
+
+### 数据目录
+
+复用 pi 的本地数据，无需额外配置：
+
+```text
+~/.pi/agent/
+  sessions/<cwd>/<timestamp>_<uuid>.jsonl   # 会话历史
+  models.json                                # 模型配置
+  settings.json                              # 用户偏好
+```
+
+### 三条主链路
+
+| 链路 | 入口 | 核心 | 输出 |
+|---|---|---|---|
+| 历史读取 | `GET /api/sessions` | `session-reader.ts` 扫描解析 `.jsonl` | 会话树、消息列表、分支上下文 |
+| 命令发送 | `POST /api/agent/*` | `rpc-manager.ts` 管理 `AgentSession` 生命周期 | prompt / fork / navigate 等动作 |
+| 事件流 | `GET /api/agent/[id]/events` | `session.subscribe()` + SSE | 流式消息、工具调用、状态变更 |
+
+### 模块边界
+
+| 层级 | 负责 | 不负责 |
+|---|---|---|
+| 浏览器 UI | 展示会话、发送命令、消费 SSE | 直接读写 `.jsonl` 或执行智能体逻辑 |
+| Next.js API | 校验请求、读取本地文件、管理 SSE | 保存额外业务数据库 |
+| `session-reader.ts` | 只读解析历史会话 | 创建 `AgentSession` |
+| `rpc-manager.ts` | `AgentSession` 生命周期和命令分发 | 解析会话列表 |
+| `AgentSession` | 执行 pi 动作、写入会话事实 | 管理 Web UI 状态 |
+
+## 项目结构
+
+```text
+app/api/
+  agent/          # 新建会话、消息、Fork/Branch、压缩、SSE
+  sessions/       # 会话列表、详情、上下文
+  files/          # 工作目录文件读取
+  models/         # 可用模型列表
+  models-config/  # models.json 读写与测试
+  auth/           # provider、OAuth、API Key 登录
+  skills/         # 技能搜索、安装和列表
+components/       # 三栏 UI、聊天流、会话树、文件工作台
+hooks/            # 前端状态机与会话事件处理
+lib/
+  session-reader.ts  # .jsonl 读取、解析、规范化
+  rpc-manager.ts     # AgentSession 包装、生命周期、命令分发
+  normalize.ts       # 消息字段兼容和 toolCall 规范化
+docs/             # 补充文档
+bin/              # npm CLI 启动入口
+```
+
+## 脚本
+
+| 命令 | 说明 |
+|---|---|
+| `bun run dev` | 开发服务 `localhost:7777` |
+| `bun run build` | 生产构建 |
+| `bun run start` | 启动构建产物 |
+| `bun run lint` | ESLint 全仓检查 |
+| `node_modules/.bin/tsc --noEmit` | 类型检查 |
+
+提交前验收：
+
+```bash
+bun run build && bun run start
+```
+
+## 相关文档
+
+- [ROADMAP.md](ROADMAP.md) — 系统架构、数据流、迭代路线
+- [TODO.md](TODO.md) — 按优先级组织的任务包
+- [Pi_SDK.md](Pi_SDK.md) — pi SDK 接口说明
+- [AGENTS.md](AGENTS.md) — 协作、验证和文档约束
+
+## 致谢
+
+本项目 fork 自 [agegr/pi-web](https://github.com/agegr/pi-web)，感谢原作者的杰出贡献。
+
+## License
+
+[MIT](LICENSE)

package/bin/no-pi-no-gang.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+"use strict";
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { spawn } = require("child_process");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const path = require("path");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const fs = require("fs");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { parseArgs } = require("util");
+
+const pkgDir = path.join(__dirname, "..");
+const nextDir = path.join(pkgDir, ".next");
+
+// Resolve next's CLI entry directly to avoid relying on .bin symlinks (which
+// may not exist when installed via npx).
+let nextBin;
+try {
+  nextBin = require.resolve("next/dist/bin/next", { paths: [pkgDir] });
+} catch {
+  // Fallback: locate next package root and derive the bin path manually.
+  try {
+    const nextPkg = require.resolve("next/package.json", { paths: [pkgDir] });
+    nextBin = path.join(path.dirname(nextPkg), "dist", "bin", "next");
+  } catch {
+    nextBin = path.join(pkgDir, "node_modules", "next", "dist", "bin", "next");
+  }
+}
+
+const { values: cliArgs } = parseArgs({
+  options: {
+    port: { type: "string", short: "p" },
+    hostname: { type: "string", short: "H" },
+  },
+  strict: false,
+});
+
+const port = cliArgs.port ?? process.env.PORT ?? "30141";
+const hostname = cliArgs.hostname ?? process.env.HOSTNAME ?? null;
+
+if (!fs.existsSync(nextDir)) {
+  console.error("Build artifacts not found. Please report this issue.");
+  process.exit(1);
+}
+
+const nextArgs = ["start", "-p", port];
+if (hostname) nextArgs.push("-H", hostname);
+
+// Always run next's JS entry with node directly — avoids .bin symlink issues
+// and path-with-spaces problems on Windows when shell: true is used.
+const child = spawn(process.execPath, [nextBin, ...nextArgs], {
+  cwd: pkgDir,
+  stdio: ["inherit", "pipe", "inherit"],
+  env: { ...process.env },
+});
+
+let browserOpened = false;
+const url = `http://${hostname ?? "localhost"}:${port}`;
+
+child.stdout.on("data", (chunk) => {
+  const text = chunk.toString();
+  process.stdout.write(text);
+  if (!browserOpened && text.includes("Ready")) {
+    browserOpened = true;
+    const isWindows = process.platform === "win32";
+    const isMac = process.platform === "darwin";
+    const openCmd = isWindows ? "start" : isMac ? "open" : "xdg-open";
+    spawn(openCmd, [url], { shell: isWindows, stdio: "ignore", detached: true }).unref();
+  }
+});
+
+child.on("exit", (code) => process.exit(code ?? 0));