@surething/cockpit 1.0.261 → 1.0.263

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

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/m" | "/project" | "/review/[id]"
-type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/config" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/prompts/config" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/snapshots" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version" | "/apps/[...path]"
+type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/config" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/prompts/config" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/restart" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/shutdown" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/snapshots" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/update" | "/api/version" | "/apps/[...path]"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -123,6 +123,7 @@ interface ParamMap {
   "/api/redis/get": {}
   "/api/redis/keys": {}
   "/api/redis/set": {}
+  "/api/restart": {}
   "/api/review": {}
   "/api/review/[id]": { "id": string; }
   "/api/review/[id]/comments": { "id": string; }
@@ -141,6 +142,7 @@ interface ParamMap {
   "/api/sessions/projects": {}
   "/api/sessions/projects/[encodedPath]": { "encodedPath": string; }
   "/api/settings": {}
+  "/api/shutdown": {}
   "/api/skills": {}
   "/api/skills/[id]": { "id": string; }
   "/api/skills/content": {}
@@ -151,6 +153,7 @@ interface ParamMap {
   "/api/terminal/bubble-order": {}
   "/api/terminal/env": {}
   "/api/terminal/history": {}
+  "/api/update": {}
   "/api/version": {}
   "/apps/[...path]": { "path": string[]; }
   "/m": {}

package/.next-prod/types/validator.ts

@@ -1082,6 +1082,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/restart/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/restart">> = Specific
+  const handler = {} as typeof import("../../src/app/api/restart/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/review/[id]/comments/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/review/[id]/comments">> = Specific
@@ -1244,6 +1253,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/shutdown/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/shutdown">> = Specific
+  const handler = {} as typeof import("../../src/app/api/shutdown/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/skills/[id]/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills/[id]">> = Specific
@@ -1334,6 +1352,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/update/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/update">> = Specific
+  const handler = {} as typeof import("../../src/app/api/update/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/version/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/version">> = Specific

package/README.md

@@ -169,6 +169,7 @@ No install, no AI chat (read-only sandbox, 5 min):
 
 ## Prerequisites
 
+- **macOS, Linux, or Windows** — Windows support is experimental ([details](#windows))
 - **Node.js ≥ 20** — [nodejs.org](https://nodejs.org/)
 - **Claude Code** — [docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code) (default engine)
 - **Git** — for git features (blame, diff, worktree, etc.)
@@ -194,6 +195,80 @@ cockpit ~/my-project   # open specified dir
 cockpit -h             # help
 ```
 
+### Running in the background
+
+`cockpit` runs in the foreground, so closing the terminal stops it. To keep it
+running:
+
+```bash
+cockpit start          # start in the background
+cockpit status         # running? which version, port, pid, uptime
+cockpit restart        # restart in place
+cockpit stop
+```
+
+`start` accepts the same flags as `cockpit` (`--port`, `--token`). Output goes
+to `~/.cockpit/logs/server.log`.
+
+`restart` asks the running server to replace itself, so the port and token it
+was started with are preserved — you do not need to repeat them.
+
+> There is no launchd/systemd integration: after a reboot, run `cockpit start`
+> again (or add it to your login items).
+
+### Updating
+
+```bash
+cockpit update
+```
+
+…or click the version pill in the sidebar when an update is available.
+
+If Cockpit is **running**, it updates in place: the server hands off to a
+helper that installs while nothing is holding the install directory, then
+relaunches with the same port and token. A failed install rolls back to the
+previous version and still restarts, so an interrupted update never leaves you
+without a working Cockpit.
+
+If it is **not running**, `cockpit update` simply installs.
+
+Once the new server is up, any browser tab left open from the old version shows
+a "reload" prompt — its cached assets belong to the previous build.
+
+### Windows
+
+Windows support is **experimental** — it is exercised by CI but has far less
+real-world mileage than macOS and Linux. Cockpit runs natively; the Console
+panel uses Git Bash when it is installed and falls back to PowerShell, the same
+order Claude Code applies on Windows.
+
+- Install [Git for Windows](https://git-scm.com/download/win) for a bash
+  terminal. Without it the Console panel runs PowerShell, and the
+  `cockpit.bash` channel used by HTML apps is unavailable.
+- The file browser, diff, review and chat panels behave as they do elsewhere.
+
+Prefer a Linux toolchain? Run *all* of Cockpit inside **WSL2**, where it is an
+ordinary Linux install:
+
+```powershell
+wsl --install          # once, from an admin PowerShell, then reboot
+```
+
+```bash
+wsl                                  # enter your Linux shell
+npm install -g @surething/cockpit    # install Node ≥ 20 inside WSL first
+cockpit
+```
+
+Either way, open `http://localhost:3457` in your Windows browser — WSL2
+forwards localhost automatically.
+
+> **Pick one side and stay there.** Running Cockpit on Windows while your
+> project lives inside WSL (or the reverse) gives the agent one set of paths
+> and its terminal another: the same directory is `C:\Users\me\proj` on one
+> side and `/mnt/c/Users/me/proj` on the other, so paths passed between them
+> do not resolve. Keep Cockpit and your code in the same world.
+
 > Both `cockpit` (full name) and `cock` (short alias) ship with the package — use whichever you prefer. Docs and examples use `cockpit`; existing muscle memory keeps working.
 
 ### From source

package/README.zh.md

@@ -169,6 +169,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 
 ## 前置依赖
 
+- **macOS、Linux 或 Windows** —— Windows 支持为实验性（[详见](#windows)）
 - **Node.js ≥ 20** —— [nodejs.org](https://nodejs.org/)
 - **Claude Code** —— [docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)（默认引擎）
 - **Git** —— 用于 Git 相关功能（blame、diff、worktree 等）
@@ -196,6 +197,69 @@ cockpit -h             # 帮助
 
 > `cockpit`（完整名）和 `cock`（短别名）都随包安装 —— 任选其一。文档与示例统一使用 `cockpit`，老用户的肌肉记忆 `cock` 仍然好使。
 
+### 后台运行
+
+`cockpit` 默认在前台运行，关掉终端服务就停了。想让它常驻：
+
+```bash
+cockpit start          # 后台启动
+cockpit status         # 是否在跑：版本、端口、pid、运行时长
+cockpit restart        # 原地重启
+cockpit stop
+```
+
+`start` 支持与 `cockpit` 相同的参数（`--port`、`--token`）。输出写入
+`~/.cockpit/logs/server.log`。
+
+`restart` 是让运行中的服务自己完成替换，因此启动时用的端口和 token 会被保留 ——
+不需要重新指定一遍。
+
+> 没有集成 launchd/systemd：重启电脑后需要再次执行 `cockpit start`（或把它加进系统的登录启动项）。
+
+### 升级
+
+```bash
+cockpit update
+```
+
+也可以在有新版本时点击侧边栏的版本药丸。
+
+如果 Cockpit **正在运行**，升级会原地完成：服务把工作交接给一个辅助进程，由它在无人
+占用安装目录的情况下安装，然后用相同的端口和 token 重新拉起。安装失败会回滚到原版本
+并照常重启 —— 中断的升级不会让你失去一个可用的 Cockpit。
+
+如果**没有运行**，`cockpit update` 就是单纯地安装。
+
+新服务起来后，此前一直开着的浏览器标签页会出现"刷新"提示 —— 它持有的是旧版本的静态资源。
+
+### Windows
+
+Windows 支持为**实验性** —— CI 会覆盖，但实际使用量远少于 macOS 和 Linux。Cockpit
+以原生方式运行；Console 面板在装有 Git Bash 时使用它，否则回落到 PowerShell，与
+Claude Code 在 Windows 上的优先级一致。
+
+- 安装 [Git for Windows](https://git-scm.com/download/win) 可获得 bash 终端。不装的话
+  Console 面板会运行 PowerShell，且 HTML 应用使用的 `cockpit.bash` 通道不可用。
+- 文件浏览、diff、review、chat 等面板的行为与其他平台一致。
+
+想要 Linux 工具链？把**整个** Cockpit 放进 **WSL2** 运行，那里它就是一个普通的 Linux 安装：
+
+```powershell
+wsl --install          # 管理员 PowerShell 里执行一次，然后重启
+```
+
+```bash
+wsl                                  # 进入 Linux shell
+npm install -g @surething/cockpit    # 先在 WSL 内装好 Node ≥ 20
+cockpit
+```
+
+两种方式都在 Windows 浏览器里打开 `http://localhost:3457` —— WSL2 会自动转发 localhost。
+
+> **选一边，别混用。** 在 Windows 上跑 Cockpit 而项目放在 WSL 里（或者反过来），会让
+> agent 和它的终端拿到两套路径：同一个目录一边是 `C:\Users\me\proj`，另一边是
+> `/mnt/c/Users/me/proj`，互相传递的路径无法解析。让 Cockpit 和你的代码待在同一个世界里。
+
 ### 从源码安装
 
 ```bash