@surething/cockpit 1.0.177 → 1.0.178

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":12289657,"timestamp":186497466,"id":17,"parentId":1,"tags":{},"startTime":1774469568953,"traceId":"ca408d37aed33337"},{"name":"run-typescript","duration":14200676,"timestamp":198792546,"id":1412,"parentId":1,"tags":{},"startTime":1774469581248,"traceId":"ca408d37aed33337"},{"name":"static-check","duration":738101,"timestamp":213011578,"id":1415,"parentId":1,"tags":{},"startTime":1774469595467,"traceId":"ca408d37aed33337"},{"name":"static-generation","duration":5139764,"timestamp":214329971,"id":1615,"parentId":1,"tags":{},"startTime":1774469596785,"traceId":"ca408d37aed33337"},{"name":"collect-build-traces","duration":18054692,"timestamp":213750398,"id":1612,"parentId":1,"tags":{},"startTime":1774469596206,"traceId":"ca408d37aed33337"},{"name":"telemetry-flush","duration":58,"timestamp":231808234,"id":1624,"parentId":1,"tags":{},"startTime":1774469614264,"traceId":"ca408d37aed33337"},{"name":"next-build","duration":45684808,"timestamp":186123498,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1774469568579,"traceId":"ca408d37aed33337"}]
+[{"name":"run-webpack","duration":11649582,"timestamp":135689337,"id":17,"parentId":1,"tags":{},"startTime":1774508096181,"traceId":"f2d23f9ead8f3bf6"},{"name":"run-typescript","duration":13425343,"timestamp":147342493,"id":1412,"parentId":1,"tags":{},"startTime":1774508107834,"traceId":"f2d23f9ead8f3bf6"},{"name":"static-check","duration":730191,"timestamp":160788440,"id":1415,"parentId":1,"tags":{},"startTime":1774508121280,"traceId":"f2d23f9ead8f3bf6"},{"name":"static-generation","duration":5296546,"timestamp":161692933,"id":1615,"parentId":1,"tags":{},"startTime":1774508122185,"traceId":"f2d23f9ead8f3bf6"},{"name":"collect-build-traces","duration":17187755,"timestamp":161519340,"id":1612,"parentId":1,"tags":{},"startTime":1774508122011,"traceId":"f2d23f9ead8f3bf6"},{"name":"telemetry-flush","duration":52,"timestamp":178710150,"id":1624,"parentId":1,"tags":{},"startTime":1774508139202,"traceId":"f2d23f9ead8f3bf6"},{"name":"next-build","duration":43376548,"timestamp":135333665,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1774508095826,"traceId":"f2d23f9ead8f3bf6"}]

package/README.md

@@ -53,13 +53,21 @@ A unified development cockpit built on **Claude Code (Agent SDK)** — chat, cod
 - Chrome extension (Manifest V3) for browser automation bridge
 - CLI tools: `cock browser` / `cock terminal` for headless automation
 
+## Prerequisites
+
+- **Node.js ≥ 20** — [nodejs.org](https://nodejs.org/)
+- **Claude Code** — [docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code) (Cockpit uses Claude Code Agent SDK under the hood)
+- **Git** — for git features (blame, diff, branch switching, etc.)
+- **Chrome** — (optional) for Browser Bubble automation, install the bundled extension from `~/.cockpit/chrome-extension`
+
 ## Install
 
 ```bash
 npm install -g @surething/cockpit
 cock                # Start server → http://localhost:3457
+cock .              # Open current directory as project
+cock ~/my-project   # Open specified directory
 cock -h             # Show help
-cock -v             # Show version
 ```
 
 ### From Source

package/README.zh.md

@@ -59,13 +59,21 @@
 - Chrome 插件 (Manifest V3) 浏览器自动化桥接
 - CLI 工具：`cock browser` / `cock terminal` 无头自动化
 
+## 前置依赖
+
+- **Node.js ≥ 20** — [nodejs.org](https://nodejs.org/)
+- **Claude Code** — [docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code)（Cockpit 底层使用 Claude Code Agent SDK）
+- **Git** — 用于 Git 相关功能（blame、diff、分支切换等）
+- **Chrome** —（可选）浏览器气泡自动化，需安装 `~/.cockpit/chrome-extension` 中的扩展
+
 ## 安装
 
 ```bash
 npm install -g @surething/cockpit
 cock                # 启动服务 → http://localhost:3457
+cock .              # 打开当前目录为项目
+cock ~/my-project   # 打开指定目录
 cock -h             # 查看帮助
-cock -v             # 查看版本
 ```
 
 ### 从源码安装

package/bin/cock.mjs

@@ -13,19 +13,21 @@ if (process.argv[2] === '--help' || process.argv[2] === '-h' || process.argv[2]
   const pkg = JSON.parse(readFileSync(resolve(PROJECT_ROOT, 'package.json'), 'utf8'));
   console.log(`Cockpit v${pkg.version} - One seat. One AI. Everything under control.
 
-Usage: cock [command]
+Usage: cock [path] [options]
 
 Commands:
-  (default)                    Start Cockpit server (port 3457)
-  browser <id> <action>        Control browser bubbles
-  terminal <id> <action>       Control terminal bubbles
-  update                       Update to latest version
+  cock                           Start server, open last project
+  cock .                         Start server, open current directory
+  cock <path>                    Start server, open specified directory
+  browser <id> <action>          Control browser bubbles
+  terminal <id> <action>         Control terminal bubbles
+  update                         Update to latest version
 
 Options:
-  --port <port>                Set server port (default: 3457)
-  --no-open                    Don't open browser after start
-  -v, --version                Show version
-  -h, --help                   Show this help`);
+  --port <port>                  Set server port (default: 3457)
+  --no-open                      Don't open browser after start
+  -v, --version                  Show version
+  -h, --help                     Show this help`);
   process.exit(0);
 }
 
@@ -58,8 +60,7 @@ if (!process.env.COCKPIT_PORT) {
 
 // Subcommand routing
 if (process.argv[2] === 'browser') {
-  // cock browser <id> <action> [args...] → delegate to cock-browser.mjs
-  process.argv.splice(2, 1); // Remove 'browser' so cock-browser.mjs parses from argv[2]
+  process.argv.splice(2, 1);
   const mod = await import('./cock-browser.mjs');
   await mod.done;
   process.exit(0);
@@ -83,17 +84,72 @@ if (process.argv[2] === 'update') {
   process.exit(result.status ?? 1);
 }
 
-// Start (foreground, Ctrl+C to stop)
+// ============================================
+// Resolve project directory (if provided)
+// ============================================
+const { existsSync, mkdirSync } = await import('fs');
+const { homedir } = await import('os');
+
+const knownCommands = new Set(['browser', 'terminal', 'update', 'help']);
+const arg = process.argv[2];
+let projectDir = null;
+
+// 第一个参数不是 flag 且不是已知子命令 → 视为目录路径
+if (arg && !arg.startsWith('-') && !knownCommands.has(arg)) {
+  // 展开 ~ 为 home 目录
+  const raw = arg.startsWith('~') ? arg.replace(/^~/, homedir()) : arg;
+  projectDir = resolve(raw);
+  // 目录不存在则创建
+  if (!existsSync(projectDir)) {
+    mkdirSync(projectDir, { recursive: true });
+    console.log(`Created ${projectDir}`);
+  }
+}
+
+// ============================================
+// Check if server is already running
+// ============================================
+const port = process.env.PORT || process.env.COCKPIT_PORT || '3457';
+
+async function isServerRunning() {
+  try {
+    const res = await fetch(`http://localhost:${port}/api/version`, { signal: AbortSignal.timeout(1000) });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+const { exec } = await import('child_process');
+const running = await isServerRunning();
+
+if (running) {
+  // 服务已运行 → 打开浏览器，立即退出
+  const base = `http://localhost:${port}`;
+  const url = projectDir ? `${base}/?cwd=${encodeURIComponent(projectDir)}` : base;
+  if (!process.env.COCKPIT_NO_OPEN) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+    exec(`${cmd} ${url}`);
+  }
+  console.log(`Cockpit is already running → ${url}`);
+  process.exit(0);
+}
+
+// ============================================
+// Start server (foreground, Ctrl+C to stop)
+// ============================================
 const isDev = process.env.COCKPIT_ENV === 'dev';
-const { existsSync } = await import('fs');
-// prod mode requires a pre-built artifact; dev mode is compiled on-the-fly by Next.js
 if (!isDev && !existsSync(resolve(PROJECT_ROOT, '.next-prod', 'BUILD_ID'))) {
   console.error('No production build found.\n');
   console.error('Run: npm run build');
   process.exit(1);
 }
 
+// 传递项目目录给 server.mjs，让它打开正确的 URL
+if (projectDir) {
+  process.env.COCKPIT_OPEN_PROJECT = projectDir;
+}
+
 console.log('Starting Cockpit...');
-// dev: tsx for on-the-fly TS compilation; prod: pre-compiled dist/
 const args = isDev ? ['--import', 'tsx', 'server.mjs'] : ['server.mjs'];
 spawnSync('node', args, { cwd: PROJECT_ROOT, stdio: 'inherit' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surething/cockpit",
-  "version": "1.0.177",
+  "version": "1.0.178",
   "description": "The Cockpit That Drives AI",
   "author": "Robert",
   "license": "MIT",

package/server.mjs

@@ -71,8 +71,10 @@ app.prepare().then(async () => {
 
     // prod 模式自动打开浏览器（--no-open 禁用）
     if (!dev && !process.env.COCKPIT_NO_OPEN) {
+      const openProject = process.env.COCKPIT_OPEN_PROJECT;
+      const openUrl = openProject ? `${url}/?cwd=${encodeURIComponent(openProject)}` : url;
       const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-      exec(`${cmd} ${url}`);
+      exec(`${cmd} ${openUrl}`);
     }
   });