@surething/cockpit 1.0.194 → 1.0.196

package/README.md

@@ -1,110 +1,203 @@
 <p align="center">
-  <img src="public/icons/icon-128x128.png" width="80" />
+  <a href="https://cocking.cc">
+    <img src="public/icons/icon-128x128.png" width="80" alt="Cockpit logo" />
+  </a>
 </p>
 
-# The Cockpit That Drives AI
+<h1 align="center">Cockpit — A Claude Code GUI for parallel AI coding</h1>
 
-**One seat. One AI. Everything under control.**
+<p align="center">
+  <strong>One seat. One AI. Everything under control.</strong><br/>
+  <sub><code>/ˈkɒkpɪt/</code> — like an aircraft cockpit</sub>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@surething/cockpit"><img src="https://img.shields.io/npm/v/@surething/cockpit?color=12a594&label=npm&style=flat-square" alt="npm version"/></a>
+  <a href="https://www.npmjs.com/package/@surething/cockpit"><img src="https://img.shields.io/npm/dm/@surething/cockpit?color=12a594&label=downloads&style=flat-square" alt="npm downloads"/></a>
+  <a href="https://github.com/Surething-io/cockpit/stargazers"><img src="https://img.shields.io/github/stars/Surething-io/cockpit?color=12a594&style=flat-square" alt="GitHub stars"/></a>
+  <a href="https://github.com/Surething-io/cockpit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-12a594?style=flat-square" alt="MIT license"/></a>
+  <a href="https://cocking.cc"><img src="https://img.shields.io/badge/website-cocking.cc-12a594?style=flat-square" alt="website"/></a>
+  <a href="https://github.com/anthropics/anthropic-sdk-typescript"><img src="https://img.shields.io/badge/built_on-Claude%20Agent%20SDK-12a594?style=flat-square" alt="Built on Claude Agent SDK"/></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.zh.md">中文</a> · <a href="https://cocking.cc">Website</a> · <a href="https://cocking.cc/en/blog/">Blog</a>
+</p>
+
+---
+
+> **Cockpit is an open-source Claude Code GUI.** Run multiple Claude Code Agent SDK sessions in parallel across projects, with a built-in terminal, Chrome control, PostgreSQL / MySQL / Redis bubbles, code review, and slash modes — all local, zero config.
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
-A unified development cockpit built on **Claude Code (Agent SDK)** — chat, code, terminal, browser, database all in one interface. If you can run Claude Code, Cockpit works out of the box — zero config, zero cloud dependency.
+```bash
+npm i -g @surething/cockpit && cockpit
+```
+
+## Why Cockpit?
+
+Anthropic ships **Claude Code as a CLI**. That's the right call for power users — but the moment you have more than one project in flight, your terminal turns into mission control with no instruments.
+
+Cockpit is the instrument panel. It does **not** replace Claude Code; it stands on top of the official Agent SDK and gives you the things a CLI can't:
 
-**20× AI power, 20× your productivity.** Run multiple AI sessions in parallel across projects, stay in flow with notifications and red-dot badges, collaborate through shared code reviews — all from within the cockpit.
+| Pain with raw Claude Code | What Cockpit adds |
+|---|---|
+| One session at a time, terminal chaos at 3+ projects | **Multi-project tabs**, parallel agent sessions, red-dot inbox, desktop notifications |
+| Image attachments are awkward | Drop / paste images straight into chat |
+| "What was I debugging yesterday?" | Cmd+K cross-project session browser, pinning, forking |
+| Agent can't reach your browser / DB | **Smart Bubbles**: Chrome, PostgreSQL, MySQL, Redis — drivable by the agent |
+| Reviewing AI output is friction | **LAN-shared review pages**, line-level comments, send any comment back as AI context |
+| Same "do X but don't change code" prompt every day | **Slash modes** `/qa /fx /review /commit` + custom `~/.claude/commands/*.md` |
+| No automation hooks | One-time / interval / cron-based **scheduled tasks** |
+| "Cloud relay" trust concerns | **Fully local**. No telemetry. No API key beyond what `claude` already has. |
 
 ## Features
 
-### Agent — AI Chat
-- Powered by Claude Code (Agent SDK) — zero API key setup if Claude Code is already configured
-- Multi-project concurrent sessions — run multiple AI tasks in parallel, get notified when done
-- Session pinning, forking, and cross-project session browser
-- `!command` prefix to execute shell commands from chat
-- Image attachments, inline code references, token usage tracking
-
-### Explorer — Code & Files
-- Directory tree / Recent / Git Changes / Git History — 4-tab file browser
-- Syntax highlighting (Shiki) with Vi mode editing
-- Git blame, diff view, branch switching, worktree management
-- LSP integration — go to definition, find references, hover info
+### Agent — AI chat that scales
+
+- Powered by the **official Claude Agent SDK** — zero extra API key setup
+- **Multi-project concurrent sessions** with desktop notifications and red-dot badges
+- Session **pinning, forking**, cross-project session browser (Cmd+K)
+- `!command` prefix to run shell from chat — output piped back as context
+- Image attachments, code references, token usage tracking
+
+### Explorer — Code & files
+
+- **4-tab file browser**: Directory · Recent · Git Changes · Git History
+- Syntax highlighting (Shiki) with **Vi mode** editing
+- Git **blame**, diff view, branch switching, **worktree** management
+- **LSP integration** — go to definition, find references, hover info
 - Fuzzy file search (Cmd+F), JSON viewer, Markdown preview
 
-### Console — Terminal & Bubbles
-- Full terminal emulator (xterm.js) with shell integration
-- **Browser Bubble** — control Chrome via accessibility tree: click, type, navigate, screenshot, network inspection
-- **Database Bubble** — connect PostgreSQL, explore schema, run queries, export data
-- **MySQL Bubble** — connect MySQL, browse databases/tables, run queries, export data
-- **Redis Bubble** — browse keys, inspect values, execute commands
-- Drag-to-reorder bubbles, grid / maximized layout
-- Environment variables & shell aliases per tab
+### Console — Terminal & smart Bubbles
+
+- Full **xterm.js** terminal with shell integration
+- 🌐 **Browser Bubble** — control Chrome via accessibility tree (click, type, navigate, screenshot, network)
+- 🐘 **PostgreSQL Bubble** — browse schema, run queries, export
+- 🐬 **MySQL Bubble** — browse databases & tables, run queries
+- 🔴 **Redis Bubble** — browse keys, inspect values, execute commands
+- Drag-to-reorder, grid / maximized layout, per-tab env vars & shell aliases
 
-### Code Review — Team Collaboration
-- LAN-shareable review pages — team members review without installing anything
-- Line-level commenting with reply threads
-- Send comments as AI context for automated fixes
-- Red-dot badges for unread comments
+### Code Review — LAN-shared, no SaaS
 
-### Scheduled Tasks
-- One-time, interval, or cron-based task scheduling
-- Pause/resume, reorder, result tracking
+- LAN-shareable review pages — **teammates need zero install**
+- Line-level comments with reply threads
+- **Send any comment back to AI** as context for an automated fix
+- Red-dot badges keep unread feedback visible across projects
 
-### Stay in Flow
-- Three-panel swipe UI — Agent / Explorer / Console always rendered, instant switch
-- Red-dot badges & toast notifications — never miss a completed AI task
-- Multi-project workspace — each project isolated, switch without losing state
-- Dark / Light theme, English / Chinese i18n
-- Chrome extension (Manifest V3) for browser automation bridge
-- CLI tools: `cock browser` / `cock terminal` for headless automation
+### Slash modes — change the agent's posture
 
-## Try Online
+- `/qa` — **Clarify-only**: restate, ask back, never code
+- `/fx` — **Diagnose-only**: bug evidence chain, never edit
+- `/review` — read the diff, write notes, no rewrites
+- `/commit` — stage + draft a message in your repo's style + commit
+- **Custom**: drop any `*.md` into `~/.claude/commands/` or `./.claude/commands/` → instant slash command
 
-No install needed — try Cockpit in your browser (5-minute sandbox, no AI chat):
+### Scheduled tasks — Cron for AI
 
-[![Try Online](https://img.shields.io/badge/Try%20Online-Cockpit%20Demo-blue?style=for-the-badge)](https://cocking.cc/try)
+- One-time, interval, or **cron** scheduling
+- Pause / resume, reorder, track results across projects
+
+### Skills — extensibility
+
+- Drop in any `SKILL.md` to teach the agent a new trick
+- Invoke with `/skill-name` from chat
+- All managed from a single Skills sidebar
+
+## Use cases
+
+- **Solo dev, multi-repo:** "I have a refactor running in API, tests writing in Web, and a bug investigation in Pipeline — all at once, all visible."
+- **Two-person team:** Senior reviews via LAN-shared review page, no GitHub PR round-trip needed for in-progress work.
+- **Full-stack chore mode:** `/fx` in one tab on a backend bug, `/review` in another on the frontend diff, `/commit` to wrap up — three slash modes, three different agent postures.
+- **AI-driven QA:** Browser Bubble + scheduled task = "every night at 2 AM, run this UI smoke flow and post a summary".
+- **Privacy-sensitive code:** runs on your laptop, talks only to the Claude API your `claude` CLI is already configured with. No telemetry, no relay.
+
+## Try online
+
+No install, no AI chat (read-only sandbox, 5 min):
+
+[![Try Online](https://img.shields.io/badge/Try%20Online-cocking.cc%2Ftry-12a594?style=for-the-badge)](https://cocking.cc/try)
 
 ## 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`
+- **Claude Code** — [docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)
+- **Git** — for git features (blame, diff, worktree, etc.)
+- **Chrome** *(optional)* — for Browser Bubble; 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
+cockpit                # start cockpit → http://localhost:3457
+cockpit .              # open current dir as a project
+cockpit ~/my-project   # open specified dir
+cockpit -h             # help
 ```
 
-### From Source
+> 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
 
 ```bash
 git clone https://github.com/Surething-io/cockpit.git
 cd cockpit
 npm install
-npm run setup       # Build + npm link (registers `cock` command)
+npm run setup       # build + npm link (registers `cockpit` and `cock`)
 ```
 
 ## CLI
 
 ```bash
-cock browser <id> snapshot    # Capture accessibility tree
-cock browser <id> click <uid> # Click element
-cock terminal <id> exec "ls"  # Execute command
-cock terminal <id> output     # Get terminal output
+cockpit browser <id> snapshot      # capture accessibility tree
+cockpit browser <id> click <uid>   # click element
+cockpit terminal <id> exec "ls"    # execute command
+cockpit terminal <id> output       # get terminal output
 ```
 
+## Comparison
+
+| | Raw Claude Code CLI | IDE plugin (Cursor, Continue) | Aider TUI | **Cockpit** |
+|---|---|---|---|---|
+| Multi-project parallel | tmux required | multi-window | one at a time | **first-class** |
+| Cross-project search | grep | per-window | local | **Cmd+K** |
+| Browser / DB control | ❌ | usually ❌ | ❌ | **✅ Bubbles** |
+| Code review surface | git tools | PR provider | git | **LAN-shared** |
+| Slash modes | manual | per-plugin | yes | **`/qa /fx /review /commit` + custom** |
+| Local-only / no cloud relay | ✅ | varies | ✅ | **✅** |
+| Day-1 SDK features | ✅ | wait | varies | **✅ official SDK** |
+| Open source | ✅ | mostly ❌ | ✅ | **✅ MIT** |
+
+Read the long version: [Claude Code GUI: CLI vs Cockpit vs IDE plugins](https://cocking.cc/en/blog/claude-code-gui-comparison/)
+
+## Read more
+
+- 📖 [How to run 5 Claude Code sessions in parallel](https://cocking.cc/en/blog/parallel-claude-code-sessions/)
+- 📖 [Slash modes in Claude Code: /qa /fx /review /commit](https://cocking.cc/en/blog/slash-modes-claude-code/)
+- 📖 [Full blog](https://cocking.cc/en/blog/)
+- 📋 [Changelog](https://cocking.cc/en/changelog/)
+
 ## Development
 
 ```bash
-npm run dev         # Dev server → http://localhost:3456
-npm run build       # Production build
-npm run setup       # Build + npm link
+npm run dev         # dev server → http://localhost:3456
+npm run build       # production build
+npm run setup       # build + npm link
 npm run lint        # ESLint
 ```
 
-## Tech Stack
+## Tech stack
+
+Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · Shiki · i18next · Claude Agent SDK
+
+## Contributing
+
+Issues and PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) and [GUIDE.md](GUIDE.md).
+
+## License
+
+[MIT](LICENSE) © Surething
+
+---
 
-Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · Shiki · i18next
+<sub>If Cockpit saved you 10 minutes today, a ⭐️ on GitHub is the cheapest thank-you we know.</sub>

package/README.zh.md

@@ -1,107 +1,182 @@
 <p align="center">
-  <img src="public/icons/icon-128x128.png" width="80" />
+  <a href="https://cocking.cc">
+    <img src="public/icons/icon-128x128.png" width="80" alt="Cockpit logo" />
+  </a>
 </p>
 
-# 驱动 AI 的驾驶舱
+<h1 align="center">Cockpit —— 为并行 AI 编程而生的 Claude Code GUI</h1>
 
-**One seat. One AI. Everything under control.**
+<p align="center">
+  <strong>One seat. One AI. Everything under control.</strong><br/>
+  <sub><code>/ˈkɒkpɪt/</code> —— 像飞机驾驶舱</sub>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@surething/cockpit"><img src="https://img.shields.io/npm/v/@surething/cockpit?color=12a594&label=npm&style=flat-square" alt="npm version"/></a>
+  <a href="https://www.npmjs.com/package/@surething/cockpit"><img src="https://img.shields.io/npm/dm/@surething/cockpit?color=12a594&label=downloads&style=flat-square" alt="npm downloads"/></a>
+  <a href="https://github.com/Surething-io/cockpit/stargazers"><img src="https://img.shields.io/github/stars/Surething-io/cockpit?color=12a594&style=flat-square" alt="GitHub stars"/></a>
+  <a href="https://github.com/Surething-io/cockpit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-12a594?style=flat-square" alt="MIT license"/></a>
+  <a href="https://cocking.cc"><img src="https://img.shields.io/badge/website-cocking.cc-12a594?style=flat-square" alt="website"/></a>
+  <a href="https://github.com/anthropics/anthropic-sdk-typescript"><img src="https://img.shields.io/badge/built_on-Claude%20Agent%20SDK-12a594?style=flat-square" alt="Built on Claude Agent SDK"/></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.zh.md">中文</a> · <a href="https://cocking.cc">官网</a> · <a href="https://cocking.cc/zh/blog/">博客</a>
+</p>
+
+---
+
+> **Cockpit 是开源的 Claude Code GUI。** 基于官方 Claude Agent SDK，支持多项目并发会话、内置终端、Chrome 自动化、PostgreSQL / MySQL / Redis 数据库气泡、代码评审与斜杠模式 —— 全部本地化，零配置。
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
-基于 **Claude Code (Agent SDK)** 构建的一站式开发座舱 — 对话、代码、终端、浏览器、数据库全部集成在一个界面中。能跑 Claude Code 就能用，零配置、零云端依赖。
+```bash
+npm i -g @surething/cockpit && cockpit
+```
+
+## 为什么选 Cockpit？
+
+Anthropic 把 **Claude Code 默认做成 CLI**。这对硬核玩家是对的 —— 但只要你同时跟进 2+ 个项目，终端就成了"没有仪表盘的塔台"。
 
-**20× AI 算力，20× 你的效率。** 多项目 AI 会话并发执行，红点徽标和通知系统让你不错过任何完成的任务，局域网协作评审系统让团队无缝配合 — 在驾驶舱中完成所有工作，专注心流。
+Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官方 Agent SDK 之上，补齐 CLI 给不了的能力：
+
+| 裸用 Claude Code 的痛 | Cockpit 的解法 |
+|---|---|
+| 一次只能开一个会话，3+ 项目就乱 | **多项目标签页**、并发 Agent 会话、红点收件箱、桌面通知 |
+| 图片附件麻烦 | 拖拽 / 粘贴图片直接进对话 |
+| "我昨天调的那个 bug 在哪？" | Cmd+K 跨项目会话浏览，会话固定 / 分叉 |
+| Agent 够不到浏览器 / 数据库 | **智能气泡**：Chrome、PostgreSQL、MySQL、Redis —— Agent 可驱动 |
+| AI 输出审阅低效 | **局域网共享评审页**、行级评论、任意评论可回喂给 AI |
+| 每天写一遍"做 X 但不要动代码" | **斜杠模式** `/qa /fx /review /commit` + 自定义 `~/.claude/commands/*.md` |
+| 没有自动化触发器 | 一次性 / 间隔 / **Cron** **定时任务** |
+| 担心"云端中转" | **完全本地**。无遥测、无中转，复用你 `claude` CLI 已有的 API Key |
 
 ## 功能特性
 
-### Agent — AI 对话
+### Agent —— 可扩展的 AI 对话
 
-- 基于 Claude Code (Agent SDK) — 已配置 Claude Code 即可直接使用，无需额外设置
-- 多项目并发会话 — 多个 AI 任务并行执行，完成后自动通知
-- 会话固定、分叉、跨项目会话浏览器
-- `!command` 前缀执行 shell 命令，输出自动附加到对话
+- 基于**官方 Claude Agent SDK** —— 零额外 API Key 配置
+- **多项目并发会话**，桌面通知 + 红点徽标
+- 会话**固定 / 分叉**，跨项目会话浏览（Cmd+K）
+- `!command` 前缀直接执行 shell —— 输出回流为对话上下文
 - 图片附件、代码引用、Token 用量统计
 
-### Explorer — 代码与文件
+### Explorer —— 代码与文件
 
-- 目录树 / 最近浏览 / Git 变更 / Git 历史 — 四标签页文件浏览器
-- 语法高亮 (Shiki) + Vi 模式编辑
-- Git blame、Diff 视图、分支切换、Worktree 管理
-- LSP 集成 — 跳转定义、查找引用、悬浮类型信息
-- 模糊搜索 (Cmd+F)、JSON 可读视图、Markdown 预览
+- **4 标签页文件浏览器**：目录树 · 最近 · Git 变更 · Git 历史
+- 语法高亮 (Shiki) + **Vi 模式**编辑
+- Git **blame**、Diff 视图、分支切换、**Worktree** 管理
+- **LSP 集成** —— 跳转定义、查找引用、悬浮类型信息
+- 模糊搜索 (Cmd+F)、JSON 查看器、Markdown 预览
 
-### Console — 终端与气泡
+### Console —— 终端与智能气泡
 
-- 完整终端模拟器 (xterm.js)，支持 Shell 集成
-- **浏览器气泡** — 通过无障碍树控制 Chrome：点击、输入、导航、截图、网络检查
-- **数据库气泡** — 连接 PostgreSQL，浏览 Schema、执行查询、导出数据
-- **MySQL 气泡** — 连接 MySQL，浏览数据库/表、执行查询、导出数据
-- **Redis 气泡** — 浏览键值、查看数据、执行命令
-- 气泡拖拽排序、网格 / 放大布局
-- 每个标签页独立的环境变量和 Shell 别名
+- 完整 **xterm.js** 终端，Shell 集成
+- 🌐 **浏览器气泡** —— 通过无障碍树控制 Chrome（点击、输入、导航、截图、网络）
+- 🐘 **PostgreSQL 气泡** —— 浏览 Schema、执行查询、导出
+- 🐬 **MySQL 气泡** —— 浏览数据库与表、执行查询
+- 🔴 **Redis 气泡** —— 浏览键值、查看数据、执行命令
+- 拖拽排序、网格 / 放大布局，每个标签独立的环境变量与 Shell 别名
 
-### 代码评审 — 团队协作
+### 代码评审 —— 局域网共享，无需 SaaS
 
-- 局域网分享评审页面 — 团队成员无需安装即可评审
+- 局域网分享评审页面 —— **队友零安装**即可参与
 - 行级评论与回复线程
-- 评论可发送给 AI 作为上下文，自动修复
-- 未读评论红点提醒
+- **任意评论可发给 AI** 作为上下文，自动修复
+- 未读评论红点提醒，跨项目可见
+
+### 斜杠模式 —— 切换 Agent 姿态
 
-### 定时任务
+- `/qa` —— **只澄清**：复述、反问、绝不写代码
+- `/fx` —— **只诊断**：Bug 证据链分析，绝不改文件
+- `/review` —— 读 diff、写评审，不动手重写
+- `/commit` —— 暂存改动、按你仓库的风格起草 message、提交
+- **自定义**：`~/.claude/commands/` 或 `./.claude/commands/` 下任意 `*.md` 即斜杠指令
 
-- 一次性、间隔、Cron 表达式三种调度模式
-- 暂停/恢复、拖拽排序、结果追踪
+### 定时任务 —— 给 AI 的 Cron
 
-### 专注心流
+- 一次性、间隔、**Cron** 三种调度
+- 暂停 / 恢复、拖拽排序，跨项目追踪结果
 
-- 三屏滑动 UI — Agent / Explorer / Console 始终渲染，即时切换
-- 红点徽标 & Toast 通知 — 不错过任何完成的 AI 任务
-- 多项目工作区 — 项目独立隔离，切换不丢失状态
-- 深色 / 浅色主题，中英双语
-- Chrome 插件 (Manifest V3) 浏览器自动化桥接
-- CLI 工具：`cock browser` / `cock terminal` 无头自动化
+### Skills —— 可扩展性
+
+- 任意 `SKILL.md` 都能教 Agent 新技能
+- 在对话中用 `/skill-name` 直接调用
+- 所有技能在统一 Skills 侧边栏管理
+
+## 使用场景
+
+- **独立开发者多仓并行：** "API 在重构、Web 在写测试、Pipeline 在排 bug —— 同时跑、同时可见。"
+- **二人小团队：** Senior 用局域网共享评审页 review，半成品代码不用绕 GitHub PR。
+- **全栈杂活模式：** 后端 bug 一个 tab 跑 `/fx`，前端 diff 另一个 tab 跑 `/review`，最后 `/commit` 收尾 —— 三种姿态、三种 Agent 模式。
+- **AI 自动化 QA：** 浏览器气泡 + 定时任务 = "每晚 2 点跑一遍 UI 冒烟流程并发摘要"。
+- **隐私敏感代码：** 在你的笔记本上跑，仅与你 `claude` CLI 已配置的 Claude API 通信。无遥测、无中转。
 
 ## 在线体验
 
-无需安装 — 在浏览器中直接体验 Cockpit（5 分钟沙盒，无 AI 对话）：
+无需安装，只读沙盒（5 分钟）：
 
-[![在线体验](https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E4%BD%93%E9%AA%8C-Cockpit%20Demo-blue?style=for-the-badge)](https://cocking.cc/try)
+[![在线体验](https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E4%BD%93%E9%AA%8C-cocking.cc%2Ftry-12a594?style=for-the-badge)](https://cocking.cc/try)
 
 ## 前置依赖
 
-- **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` 中的扩展
+- **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 等）
+- **Chrome** *(可选)* —— 浏览器气泡需安装 `~/.cockpit/chrome-extension` 中的扩展
 
 ## 安装
 
 ```bash
 npm install -g @surething/cockpit
-cock                # 启动服务 → http://localhost:3457
-cock .              # 打开当前目录为项目
-cock ~/my-project   # 打开指定目录
-cock -h             # 查看帮助
+cockpit                # 启动驾驶舱 → http://localhost:3457
+cockpit .              # 打开当前目录为项目
+cockpit ~/my-project   # 打开指定目录
+cockpit -h             # 帮助
 ```
 
+> `cockpit`（完整名）和 `cock`（短别名）都随包安装 —— 任选其一。文档与示例统一使用 `cockpit`，老用户的肌肉记忆 `cock` 仍然好使。
+
 ### 从源码安装
 
 ```bash
 git clone https://github.com/Surething-io/cockpit.git
 cd cockpit
 npm install
-npm run setup       # 构建 + npm link（注册 cock 命令）
+npm run setup       # 构建 + npm link（注册 `cockpit` 与 `cock` 命令）
 ```
 
 ## CLI
 
 ```bash
-cock browser <id> snapshot    # 获取页面元素树
-cock browser <id> click <uid> # 点击元素
-cock terminal <id> exec "ls"  # 执行命令
-cock terminal <id> output     # 获取终端输出
+cockpit browser <id> snapshot      # 获取页面元素树
+cockpit browser <id> click <uid>   # 点击元素
+cockpit terminal <id> exec "ls"    # 执行命令
+cockpit terminal <id> output       # 获取终端输出
 ```
 
+## 与同类产品对比
+
+| | 裸 Claude Code CLI | IDE 插件（Cursor、Continue）| Aider TUI | **Cockpit** |
+|---|---|---|---|---|
+| 多项目并行 | 需 tmux | 多窗口 | 一次一个 | **一等公民** |
+| 跨项目搜索 | grep | 各窗口独立 | 本地 | **Cmd+K** |
+| 浏览器 / DB 控制 | ❌ | 通常 ❌ | ❌ | **✅ Bubbles** |
+| 代码评审面 | git 工具 | PR 平台 | git | **局域网共享** |
+| 斜杠模式 | 手动 | 各插件 | 有 | **`/qa /fx /review /commit` + 自定义** |
+| 纯本地 / 不上云 | ✅ | 不一定 | ✅ | **✅** |
+| 新 SDK 能力第一天可用 | ✅ | 等 | 不一定 | **✅ 官方 SDK** |
+| 开源 | ✅ | 多数 ❌ | ✅ | **✅ MIT** |
+
+详细对比：[Claude Code GUI 全景对比：CLI、Cursor、Aider 还是 Cockpit？](https://cocking.cc/zh/blog/claude-code-gui-comparison/)
+
+## 阅读更多
+
+- 📖 [如何同时跑 5 个 Claude Code 会话不疯掉](https://cocking.cc/zh/blog/parallel-claude-code-sessions/)
+- 📖 [Claude Code 斜杠模式实战：/qa、/fx、/review、/commit](https://cocking.cc/zh/blog/slash-modes-claude-code/)
+- 📖 [完整博客](https://cocking.cc/zh/blog/)
+- 📋 [更新日志](https://cocking.cc/zh/changelog/)
+
 ## 开发
 
 ```bash
@@ -113,4 +188,16 @@ npm run lint        # ESLint
 
 ## 技术栈
 
-Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · Shiki · i18next
+Next.js 16 · React 19 · TypeScript · TailwindCSS · xterm.js · Shiki · i18next · Claude Agent SDK
+
+## 贡献
+
+欢迎 Issue 和 PR。详见 [CONTRIBUTING.md](CONTRIBUTING.md) 与 [GUIDE.md](GUIDE.md)。
+
+## 许可证
+
+[MIT](LICENSE) © Surething
+
+---
+
+<sub>如果 Cockpit 今天给你省了 10 分钟，给一颗 ⭐️ 是我们最实惠的"谢谢"。</sub>

package/bin/cock-browser.mjs

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 
 /**
- * cock browser <id> <action> [args...]
+ * cockpit browser <id> <action> [args...]
  *
  * CLI entry point: parse arguments, send commands to browser bubble via HTTP API, print results.
  *
  * Usage examples:
- *   cock browser abcd snapshot
- *   cock browser abcd navigate --url https://example.com
- *   cock browser abcd click --ref e5
- *   cock browser abcd type --ref e3 --text "hello"
- *   cock browser abcd evaluate --js "return document.title"
- *   cock browser abcd evaluate --all-frames --js "return document.title"
- *   cock browser abcd console --level error
- *   cock browser abcd network --status 4xx,5xx
- *   cock browser abcd assert --ref e5 --visible true
- *   cock browser abcd perf --metric timing
- *   cock browser abcd list   (list all connected browsers)
+ *   cockpit browser abcd snapshot
+ *   cockpit browser abcd navigate --url https://example.com
+ *   cockpit browser abcd click --ref e5
+ *   cockpit browser abcd type --ref e3 --text "hello"
+ *   cockpit browser abcd evaluate --js "return document.title"
+ *   cockpit browser abcd evaluate --all-frames --js "return document.title"
+ *   cockpit browser abcd console --level error
+ *   cockpit browser abcd network --status 4xx,5xx
+ *   cockpit browser abcd assert --ref e5 --visible true
+ *   cockpit browser abcd perf --metric timing
+ *   cockpit browser abcd list   (list all connected browsers)
  */
 
 const args = process.argv.slice(2);
@@ -26,7 +26,7 @@ const args = process.argv.slice(2);
 function printHelp(prefix = '<id>', status = null) {
   console.log(`Control a Chrome tab — inspect elements, navigate, interact, and debug.
 
-Usage: cock browser ${prefix} <action>`);
+Usage: cockpit browser ${prefix} <action>`);
 
   if (status) {
     if (status.connected) {
@@ -86,16 +86,16 @@ Console & Debug:
   storage [--type T]          Get storage (local|session)
 
 ── Next step ──────────────────────────────────────────
-Run \`cock browser ${prefix} snapshot\` to inspect the page.
+Run \`cockpit browser ${prefix} snapshot\` to inspect the page.
 It returns an element tree with refs like [e5]. Use those
 refs to interact: click, type, fill, hover, etc.
 
 Example session:
-  cock browser ${prefix} snapshot              # 1. see the page
-  cock browser ${prefix} click e5              # 2. click a button
-  cock browser ${prefix} type e3 "hello"       # 3. type into input
-  cock browser ${prefix} evaluate "document.title"  # run JS
-  cock browser ${prefix} evaluate "await fetch('/api/data').then(r=>r.json())"
+  cockpit browser ${prefix} snapshot              # 1. see the page
+  cockpit browser ${prefix} click e5              # 2. click a button
+  cockpit browser ${prefix} type e3 "hello"       # 3. type into input
+  cockpit browser ${prefix} evaluate "document.title"  # run JS
+  cockpit browser ${prefix} evaluate "await fetch('/api/data').then(r=>r.json())"
         # fetch() inherits the browser's auth session — use it to
         # call APIs, inspect responses, or pull data for analysis.`);
 }

package/bin/cock-terminal.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * cock terminal <id> <action> [args...]
+ * cockpit terminal <id> <action> [args...]
  *
  * CLI entry point: access a running terminal bubble, read output, stream in real time, send input.
  */
@@ -22,7 +22,7 @@ function readServerPort() {
 function printHelp(prefix = '<id>', status = null) {
   console.log(`Interact with a running terminal process — read output, stream logs, and send input.
 
-Usage: cock terminal ${prefix} <action>`);
+Usage: cockpit terminal ${prefix} <action>`);
 
   if (status) {
     if (status.running) {
@@ -41,14 +41,14 @@ Actions:
   stdin <data>              Send input to process
 
 ── Next step ──────────────────────────────────────────
-Run \`cock terminal ${prefix} output\` to read the terminal output.
+Run \`cockpit terminal ${prefix} output\` to read the terminal output.
 Use \`stdin\` to send commands or input to the process.
 
 Example session:
-  cock terminal ${prefix} output               # 1. read current output
-  cock terminal ${prefix} stdin "ls -la"        # 2. send a command
-  cock terminal ${prefix} output               # 3. read new output
-  cock terminal ${prefix} follow               # stream output in real-time`);
+  cockpit terminal ${prefix} output               # 1. read current output
+  cockpit terminal ${prefix} stdin "ls -la"        # 2. send a command
+  cockpit terminal ${prefix} output               # 3. read new output
+  cockpit terminal ${prefix} follow               # stream output in real-time`);
 }
 
 if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
@@ -150,7 +150,7 @@ async function run() {
   if (action === 'stdin') {
     const inputData = extraArgs.join(' ');
     if (!inputData) {
-      console.error('Usage: cock terminal <id> stdin <data>');
+      console.error('Usage: cockpit terminal <id> stdin <data>');
       process.exit(1);
     }
     try {