@yuchenrx/pmt-cli 0.1.2 → 0.1.3

package/README.md

@@ -2,115 +2,116 @@
 
 Prompt/spec manager CLI that keeps shared rules synchronized across projects.
 
-[中文文档](./README.zh.md)
+English | [简体中文](./README.zh.md)
 
-## What it does
+[![npm version](https://img.shields.io/npm/v/@yuchenrx/pmt-cli)](https://www.npmjs.com/package/@yuchenrx/pmt-cli)
+[![release](https://github.com/YuChenRX/pmt/actions/workflows/release.yml/badge.svg)](https://github.com/YuChenRX/pmt/actions/workflows/release.yml)
+[![platform](https://img.shields.io/badge/platform-windows-blue)](#)
+
+## Overview
 
 - Centralizes prompt/spec files in a global repo (`prompts_root`).
 - Creates link files in any project (hardlink -> symlink -> meta-link fallback).
 - Tracks link moves/renames in background (no full-disk scans).
 - Shows link status without scanning the filesystem.
 
-## Install
+## Quickstart
 
-### npm (Windows)
+1) Initialize a global prompt repo:
 
 ```bash
-npm i -g @yuchenrx/pmt-cli
+pmt init
 ```
 
-This package publishes a Windows binary. For other platforms, build from source.
-
-### From source
+2) Pick a prompt interactively and create a link:
 
 ```bash
-bun install
+pmt link
 ```
 
-## Run (global)
+3) Or link a specific prompt name:
 
 ```bash
-pmt
+pmt link rules
 ```
 
-## Run (dev)
+4) Or link to a specific target path:
 
 ```bash
-bun run pmt
+pmt link rules docs/AGENTS.md
 ```
 
-## Build
+5) Check link status:
 
 ```bash
-bun run build
+pmt status
 ```
 
-Output: `dist/pmt.exe`
-
-## Quick Start
+## Installation
 
-### 1) Init
-
-Global prompt repo:
+### npm (Windows)
 
 ```bash
-pmt init
+npm i -g @yuchenrx/pmt-cli
 ```
 
-`init` initializes the global prompt repo and runs `git init` under `prompts_root` if needed.
+This package ships a Windows binary. For other platforms, build from source.
 
-### 2) Link
+### From source
 
-Create a link file using the source filename as default:
+Requirements: Bun.
 
 ```bash
-pmt link 规范
+bun install
+bun run pmt
 ```
 
-Create to a specific path:
+## Commands
 
-```bash
-pmt link 规范 docs/AGENTS.md
-```
+Common commands:
 
-Interactive search:
+- `pmt init`: initialize global config / prompt root
+- `pmt set <name> <file> [scope]`: save a named source (path/URL)
+- `pmt use <name> [scope]`: switch current source
+- `pmt link [name] [file] [scope]`: create a link file (omit `name` to pick from a list; use `-i` to force interactive)
+- `pmt status`: show link status
+- `pmt open-config [scope]` (alias `open`): open config folder
+- `pmt insert <file>`: insert placeholder
+- `pmt apply [files...]`: apply current source to target files
 
-```bash
-pmt link
-pmt link -i
-```
-
-### 3) Status
+For full options:
 
 ```bash
-pmt status
+pmt --help
+pmt <command> --help
 ```
 
-Example output:
-
-```
-docs/AGENTS.md -> C:\...\prompts\规范.md [hardlink] ok
-AGENTS.md -> C:\...\prompts\rules.md [meta] missing
-roots: C:\repo, D:\shared
-```
-
-## Config
+## Configuration
 
 Config files:
 
 - Project: `.promptslotrc.json`
 - Global: `~/.promptslotrc.json`
 - Link store: `.promptslot-links.json`
-- Link index: `.promptslot-index.json`
+- Index: `.promptslot-index.json`
 
 Common keys:
 
 - `prompts_root`: global prompt repo directory
 - `prompts_dir`: project prompt directory (fallback)
 - `link_default`: default link filename
-- `sources`: name → file path/URL
+- `sources`: name -> file path/URL
 - `current`: active source name
 
+Minimal example (`.promptslotrc.json`):
+
+```json
+{
+  "prompts_root": "C:/Users/you/prompts",
+  "link_default": "AGENTS.md"
+}
+```
+
 ## Link modes
 
 1) **Hardlink**: real-time sync at filesystem level
@@ -125,10 +126,38 @@ Meta-link is for read-only or cross-device cases (e.g. URL sources).
 - It only watches directories that already contain link files.
 - No full-disk scanning; updates `.promptslot-links.json` on rename.
 
-## CLI name override
+## Build
 
 ```bash
-CLI_NAME=pmt
+bun run build
 ```
 
+Output: `dist/pmt.exe`
+
+## Release (Maintainers)
+
+Releases are automated via GitHub Actions on tag push.
 
+1) Create and push a semver tag:
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+2) The workflow `.github/workflows/release.yml` will:
+
+- run `bun test`
+- build `dist/pmt.exe`
+- create a GitHub Release with the binary attached
+- publish the npm package (`npm publish --access public`)
+
+Notes:
+
+- If your npm account enforces 2FA for publishing, CI must use an npm token that can bypass OTP (Automation token or granular token with bypass 2FA enabled). Otherwise `npm publish` fails with `EOTP`.
+
+## CLI name override
+
+```bash
+CLI_NAME=pmt
+```

package/README.zh.md

@@ -2,96 +2,88 @@
 
 用于统一管理/同步规范与提示文件的 CLI。
 
-[English](./README.md)
+[English](./README.md) | 简体中文
 
-## 功能概述
+[![npm version](https://img.shields.io/npm/v/@yuchenrx/pmt-cli)](https://www.npmjs.com/package/@yuchenrx/pmt-cli)
+[![release](https://github.com/YuChenRX/pmt/actions/workflows/release.yml/badge.svg)](https://github.com/YuChenRX/pmt/actions/workflows/release.yml)
+[![platform](https://img.shields.io/badge/platform-windows-blue)](#)
+
+## 概览
 
 - 全局集中管理 prompt/spec 文件（`prompts_root`）。
-- 在任意项目创建 link 文件（硬链接 → 软链接 → meta-link 降级）。
+- 在任意项目创建 link 文件（硬链接 -> 软链接 -> meta-link 降级）。
 - 后台追踪 link 重命名/移动（只监听已有目录，不全盘扫描）。
 - `status` 查看所有 link 状态（不扫描磁盘）。
 
-## 安装
+## 快速开始
 
-### npm（Windows）
+1）初始化全局 prompt 仓库：
 
 ```bash
-npm i -g @yuchenrx/pmt-cli
+pmt init
 ```
 
-该包发布的是 Windows 二进制文件，其他平台请从源码构建。
-
-### 源码安装
+2）交互选择一个 prompt 并创建 link：
 
 ```bash
-bun install
+pmt link
 ```
 
-## 运行（全局）
+3）或指定 prompt 名：
 
 ```bash
-pmt
+pmt link rules
 ```
 
-## 运行（开发）
+4）或指定目标路径：
 
 ```bash
-bun run pmt
+pmt link rules docs/AGENTS.md
 ```
 
-## 构建
+5）查看 link 状态：
 
 ```bash
-bun run build
+pmt status
 ```
 
-输出：`dist/pmt.exe`
-
-## 快速开始
-
-### 1）初始化
+## 安装
 
-全局 prompt 仓库：
+### npm（Windows）
 
 ```bash
-pmt init
+npm i -g @yuchenrx/pmt-cli
 ```
 
-`init` 会在 `prompts_root` 下自动执行 `git init`（若未初始化）。
+该包发布的是 Windows 二进制文件，其他平台请从源码构建。
 
-### 2）创建链接
+### 源码安装
 
-默认使用源文件名作为目标名：
+要求：Bun。
 
 ```bash
-pmt link 规范
+bun install
+bun run pmt
 ```
 
-指定目标路径：
+## 命令
 
-```bash
-pmt link 规范 docs/AGENTS.md
-```
+常用命令：
 
-交互搜索：
+- `pmt init`：初始化全局配置 / prompt root
+- `pmt set <name> <file> [scope]`：保存一个命名 source（本地路径/URL）
+- `pmt use <name> [scope]`：切换当前 source
+- `pmt link [name] [file] [scope]`：创建 link 文件（不传 `name` 默认交互选择；`-i` 可强制交互）
+- `pmt status`：查看 link 状态
+- `pmt open-config [scope]`（别名 `open`）：打开配置所在文件夹
+- `pmt insert <file>`：插入占位符
+- `pmt apply [files...]`：将当前 source 应用到目标文件
 
-```bash
-pmt link
-pmt link -i
-```
-
-### 3）查看状态
+查看完整参数：
 
 ```bash
-pmt status
-```
-
-示例输出：
-
-```
-docs/AGENTS.md -> C:\...\prompts\规范.md [hardlink] ok
-AGENTS.md -> C:\...\prompts\rules.md [meta] missing
-roots: C:\repo, D:\shared
+pmt --help
+pmt <command> --help
 ```
 
 ## 配置
@@ -108,9 +100,18 @@ roots: C:\repo, D:\shared
 - `prompts_root`：全局 prompt 仓库目录
 - `prompts_dir`：项目 prompts 目录（fallback）
 - `link_default`：默认 link 文件名
-- `sources`：name → 文件路径/URL
+- `sources`：name -> 文件路径/URL
 - `current`：当前激活的 source 名
 
+最小示例（`.promptslotrc.json`）：
+
+```json
+{
+  "prompts_root": "C:/Users/you/prompts",
+  "link_default": "AGENTS.md"
+}
+```
+
 ## 链接模式
 
 1）**硬链接**：文件系统级实时同步
@@ -125,6 +126,36 @@ Meta-link 用于跨盘、只读或 URL 等场景。
 - 仅监听已有 link 文件所在目录。
 - 不做全盘扫描，仅更新 `.promptslot-links.json`。
 
+## 构建
+
+```bash
+bun run build
+```
+
+输出：`dist/pmt.exe`
+
+## 发布（维护者）
+
+通过 GitHub Actions 自动发布：push tag 即触发。
+
+1）创建并推送 semver tag：
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+2）工作流 `.github/workflows/release.yml` 会：
+
+- 执行 `bun test`
+- 构建 `dist/pmt.exe`
+- 创建 GitHub Release，并上传二进制
+- 发布 npm 包（`npm publish --access public`）
+
+注意：
+
+- 如果 npm 账号开启了“发布需要 2FA”，CI 必须使用可绕过 OTP 的 token（Automation token 或启用 bypass 2FA 的 granular token），否则 `npm publish` 会报 `EOTP`。
+
 ## CLI 名称覆盖
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuchenrx/pmt-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "pmt": "dist/pmt.exe"

package/src/cli.ts

@@ -1,31 +1,92 @@
 #!/usr/bin/env bun
-import { Command } from 'commander'
+import { Command, CommanderError } from 'commander'
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
 import { getCliName } from './cli-name'
 import { initCompletion } from './completion'
 import { registerCommands } from './commands'
 import { autoRepairLinks } from './link-repair'
 
-const program = new Command()
+declare const PMT_VERSION: string | undefined
 
-program
-  .name(getCliName())
-  .description('占位符 prompt 管理 CLI')
-  .helpOption('-h, --help', '显示帮助')
-  .version('0.1.0', '-v, --version', '显示版本')
+const readPackageVersion = (packageJsonPath: string) => {
+  try {
+    const raw = readFileSync(packageJsonPath, 'utf8')
+    const parsed = JSON.parse(raw) as { version?: unknown }
+    if (typeof parsed.version !== 'string') return null
+    const trimmed = parsed.version.trim()
+    return trimmed ? trimmed : null
+  } catch {
+    return null
+  }
+}
+
+const getCliVersion = () => {
+  if (typeof PMT_VERSION === 'string') {
+    const trimmed = PMT_VERSION.trim()
+    if (trimmed) return trimmed
+  }
+
+  const candidates = [
+    path.resolve(path.dirname(process.execPath), '..', 'package.json'),
+    path.resolve(process.cwd(), 'package.json'),
+  ]
 
-registerCommands(program)
-initCompletion()
+  for (const packageJsonPath of candidates) {
+    const version = readPackageVersion(packageJsonPath)
+    if (version) return version
+  }
 
-const args = process.argv.slice(2)
-if (!args.length) {
-  program.outputHelp()
-  process.exit(0)
+  return '0.0.0'
 }
 
-if (args.length === 1 && (args[0] === '-h' || args[0] === '--help')) {
-  program.outputHelp()
-  process.exit(0)
+const run = async () => {
+  const program = new Command()
+
+  program
+    .name(getCliName())
+    .description('Prompt/spec manager CLI')
+    .helpOption('-h, --help', 'Show help')
+    .version(getCliVersion(), '-v, --version', 'Show version')
+    .showHelpAfterError('(use --help for additional information)')
+    .showSuggestionAfterError(true)
+    .configureHelp({ sortSubcommands: true, sortOptions: true })
+    .addHelpText(
+      'afterAll',
+      `\nExamples:\n  ${getCliName()} init\n  ${getCliName()} link\n  ${getCliName()} link rules docs/AGENTS.md\n`,
+    )
+    .exitOverride()
+
+  registerCommands(program)
+  initCompletion()
+
+  const args = process.argv.slice(2)
+  if (!args.length) {
+    program.outputHelp()
+    return
+  }
+
+  if (args.length === 1 && (args[0] === '-h' || args[0] === '--help')) {
+    program.outputHelp()
+    return
+  }
+
+  try {
+    await autoRepairLinks()
+    await program.parseAsync(process.argv)
+  } catch (err) {
+    if (err instanceof CommanderError) {
+      if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {
+        return
+      }
+
+      process.exitCode = err.exitCode
+      return
+    }
+
+    console.error(err)
+    process.exitCode = 1
+  }
 }
 
-await autoRepairLinks()
-await program.parseAsync(process.argv)
+await run()

package/src/command-apply.ts

@@ -14,7 +14,7 @@ const fail = (text: string) => {
 const requireMergedConfig = async () => {
   const merged = await loadMergedConfig()
   if (!merged.hasConfig) {
-    fail(`未找到配置文件，请先运行: ${formatCommand('init')}`)
+    fail(`Config file not found. Run: ${formatCommand('init')}`)
     return null
   }
   return merged
@@ -22,7 +22,7 @@ const requireMergedConfig = async () => {
 
 export const insertPlaceholder = async (target?: string) => {
   if (!target) {
-    fail(`用法: ${formatCommand('insert <file>')}`)
+    fail(`Usage: ${formatCommand('insert <file>')}`)
     return
   }
 
@@ -32,19 +32,19 @@ export const insertPlaceholder = async (target?: string) => {
   const resolved = resolvePath(target)
   const exists = await fileExists(resolved)
   if (!exists) {
-    fail(`文件不存在: ${resolved}`)
+    fail(`File does not exist: ${resolved}`)
     return
   }
 
   const content = await fs.readFile(resolved, 'utf8')
   if (content.includes(merged.config.placeholder)) {
-    log('文件已包含占位符')
+    log('File already contains placeholder')
     return
   }
 
   const next = content.replace(/\s*$/, `\n${merged.config.placeholder}\n`)
   await fs.writeFile(resolved, next)
-  log(`已插入占位符: ${target}`)
+  log(`Inserted placeholder: ${target}`)
 }
 
 export const applyCurrent = async (targets: string[]) => {
@@ -53,20 +53,20 @@ export const applyCurrent = async (targets: string[]) => {
 
   const current = merged.config.current
   if (!current) {
-    fail(`未设置当前值，请先运行: ${formatCommand('set <name> <file>')}`)
+    fail(`No current source set. Run: ${formatCommand('set <name> <file>')}`)
     return
   }
 
   const sourcePath = merged.resolvedSources[current]
   if (!sourcePath) {
-    fail(`当前值未配置路径: ${current}`)
+    fail(`Current source has no path: ${current}`)
     return
   }
 
   if (!isUrl(sourcePath)) {
     const sourceExists = await fileExists(sourcePath)
     if (!sourceExists) {
-      fail(`当前文件不存在: ${sourcePath}`)
+        fail(`Current source file does not exist: ${sourcePath}`)
       return
     }
   }
@@ -76,9 +76,9 @@ export const applyCurrent = async (targets: string[]) => {
   const changed = await applyToFiles(allTargets, value, merged.config)
 
   if (!changed.length) {
-    log('未找到需要替换的文件')
+    log('No files to update')
     return
   }
 
-  log(`已更新 ${changed.length} 个文件`)
+  log(`Updated ${changed.length} files`)
 }

package/src/command-completion.ts

@@ -11,8 +11,8 @@ export const completionInstall = async () => {
     installCompletion()
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
-    fail(`自动安装失败: ${message}`)
-    fail(`可手动执行: ${formatCommand('completion show')}`)
+    fail(`Auto-install failed: ${message}`)
+    fail(`Run manually: ${formatCommand('completion show')}`)
   }
 }
 
@@ -21,7 +21,7 @@ export const completionCleanup = async () => {
     cleanupCompletion()
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
-    fail(`自动卸载失败: ${message}`)
+    fail(`Auto-uninstall failed: ${message}`)
   }
 }
 

package/src/command-config.ts

@@ -26,7 +26,7 @@ const requireConfig = async (scope: ConfigScope) => {
   const config = await readConfigFile(scope)
   if (!config) {
     const configPath = getConfigPathByScope(scope)
-    fail(`未找到配置文件: ${configPath}`)
+    fail(`Config file not found: ${configPath}`)
     return null
   }
   return config
@@ -72,8 +72,8 @@ const ensurePromptRepo = async (promptsRoot: string) => {
   const { spawnSync } = await import('node:child_process')
   const result = spawnSync('git', ['init'], { cwd: promptsRoot, encoding: 'utf8' })
   if (result.status !== 0) {
-    const message = result.stderr || result.stdout || 'git init 失败'
-    log(`初始化 git 失败: ${message.trim()}`)
+    const message = result.stderr || result.stdout || 'git init failed'
+    log(`git init failed: ${message.trim()}`)
   }
 }
 
@@ -81,22 +81,22 @@ export const initConfig = async (scope: ConfigScope) => {
   const configPath = getConfigPathByScope(scope)
   const exists = await fileExists(configPath)
   if (exists) {
-    log(`配置已存在: ${configPath}`)
+    log(`Config already exists: ${configPath}`)
     return
   }
 
   const config = createDefaultConfig()
   if (scope === 'global') {
     const rootDefault = '.promptslot/prompts'
-    const promptRoot = await ask('全局 prompts 目录', rootDefault)
+    const promptRoot = await ask('Global prompts directory', rootDefault)
     config.prompts_root = promptRoot
   } else {
     const dirDefault = 'prompts'
-    const promptDir = await ask('项目 prompts 目录', dirDefault)
+    const promptDir = await ask('Project prompts directory', dirDefault)
     config.prompts_dir = promptDir
   }
 
-  const linkDefault = await ask('默认 link 文件名', config.link_default ?? 'AGENTS.md')
+  const linkDefault = await ask('Default link filename', config.link_default ?? 'AGENTS.md')
   config.link_default = linkDefault
 
 
@@ -116,12 +116,12 @@ export const initConfig = async (scope: ConfigScope) => {
     await ensurePromptRepo(promptsRoot)
   }
 
-  log(`已生成配置: ${configPath}`)
+  log(`Created config: ${configPath}`)
 }
 
 export const setSource = async (name: string, source: string, scope: ConfigScope) => {
   if (!name || !source) {
-    fail(`用法: ${formatCommand('set <name> <file>')}`)
+    fail(`Usage: ${formatCommand('set <name> <file>')}`)
     return
   }
 
@@ -132,7 +132,7 @@ export const setSource = async (name: string, source: string, scope: ConfigScope
     loaded.config.sources[name] = source
     loaded.config.current = name
     await writeConfigFile(scope, loaded.config)
-    log(`已设置 ${name} -> ${source}`)
+    log(`Set ${name} -> ${source}`)
     return
   }
 
@@ -155,15 +155,15 @@ export const setSource = async (name: string, source: string, scope: ConfigScope
   if (!resolved) {
     const suggestions = await listPromptSuggestions(promptsRoot)
     if (suggestions.length) {
-      log(`可选文件: ${suggestions.join(', ')}`)
+      log(`Available files: ${suggestions.join(', ')}`)
     }
-    fail(`文件不存在: ${baseResolved}`)
+    fail(`File does not exist: ${baseResolved}`)
     return
   }
 
   const isFilePath = await isFile(resolved)
   if (!isFilePath) {
-    fail(`目标不是文件: ${resolved}`)
+    fail(`Target is not a file: ${resolved}`)
     return
   }
   let relativeToPrompts: string | null = null
@@ -179,12 +179,12 @@ export const setSource = async (name: string, source: string, scope: ConfigScope
   loaded.config.sources[name] = stored
   loaded.config.current = name
   await writeConfigFile(scope, loaded.config)
-  log(`已设置 ${name} -> ${stored}`)
+  log(`Set ${name} -> ${stored}`)
 }
 
 export const useSource = async (name: string, scope: ConfigScope) => {
   if (!name) {
-    fail(`用法: ${formatCommand('use <name>')}`)
+    fail(`Usage: ${formatCommand('use <name>')}`)
     return
   }
 
@@ -193,24 +193,24 @@ export const useSource = async (name: string, scope: ConfigScope) => {
     if (!loaded) return
 
     if (!loaded.config.sources[name]) {
-      fail(`未找到命名值: ${name}`)
+      fail(`Source not found: ${name}`)
       return
     }
 
     loaded.config.current = name
     await writeConfigFile(scope, loaded.config)
-    log(`已切换到 ${name}`)
+    log(`Switched to ${name}`)
     return
   }
 
   const merged = await loadMergedConfig()
   if (!merged.hasConfig) {
-    fail(`未找到配置文件，请先运行: ${formatCommand('init')}`)
+    fail(`Config file not found. Run: ${formatCommand('init')}`)
     return
   }
 
   if (!merged.resolvedSources[name]) {
-    fail(`未找到命名值: ${name}`)
+    fail(`Source not found: ${name}`)
     return
   }
 
@@ -218,19 +218,19 @@ export const useSource = async (name: string, scope: ConfigScope) => {
   if (!project) return
   project.config.current = name
   await writeConfigFile(scope, project.config)
-  log(`已切换到 ${name}`)
+  log(`Switched to ${name}`)
 }
 
 export const listSources = async () => {
   const merged = await loadMergedConfig()
   if (!merged.hasConfig) {
-    fail(`未找到配置文件，请先运行: ${formatCommand('init')}`)
+    fail(`Config file not found. Run: ${formatCommand('init')}`)
     return
   }
 
   const entries = Object.entries(merged.resolvedSources)
   if (!entries.length) {
-    log('未配置任何 source')
+    log('No sources configured')
     return
   }
 

package/src/command-link.ts

@@ -64,26 +64,26 @@ const resolveLinkSource = async (root: string, name: string) => {
 
   const suggestions = await listPromptNames(root)
   if (suggestions.length) {
-    log(`可选文件: ${suggestions.join(', ')}`)
+    log(`Available files: ${suggestions.join(', ')}`)
   }
   return null
 }
 
 export const linkFile = async (name: string, target?: string, scope?: ConfigScope) => {
   if (!name) {
-    fail(`用法: ${formatCommand('link <name> [file] [scope]')}`)
+    fail(`Usage: ${formatCommand('link <name> [file] [scope]')}`)
     return
   }
 
   const root = await resolveRoot(scope)
   if (!root && !isUrl(name)) {
-    fail('未配置 prompts_root，请先运行 init 配置全局目录')
+    fail(`prompts_root is not configured. Run ${formatCommand('init')} first.`)
     return
   }
 
   const sourcePath = await resolveLinkSource(root ?? '', name)
   if (!sourcePath) {
-    fail(`未找到 prompt 文件: ${name}`)
+    fail(`Prompt not found: ${name}`)
     return
   }
 
@@ -93,7 +93,7 @@ export const linkFile = async (name: string, target?: string, scope?: ConfigScop
   } else {
     const defaultName = await resolveDefaultTargetName(sourcePath)
     if (!defaultName) {
-      fail('无法确定目标文件名，请显式传入目标路径')
+      fail('Unable to determine target filename. Provide an explicit target path.')
       return
     }
     baseTarget = resolveTargetPath(defaultName, defaultName)
@@ -102,7 +102,7 @@ export const linkFile = async (name: string, target?: string, scope?: ConfigScop
   const targetPath = ensureTargetExtension(baseTarget, sourcePath)
   const exists = await fileExists(targetPath)
   if (exists) {
-    fail(`目标文件已存在: ${targetPath}`)
+    fail(`Target file already exists: ${targetPath}`)
     return
   }
 
@@ -112,15 +112,15 @@ export const linkFile = async (name: string, target?: string, scope?: ConfigScop
   await recordLink(sourcePath, targetPath, process.cwd())
 
   if (mode === 'hardlink') {
-    log(`已创建硬链接: ${targetPath}`)
+    log(`Created hardlink: ${targetPath}`)
     return
   }
 
   if (mode === 'symlink') {
-    log(`已创建软链接: ${targetPath}`)
+    log(`Created symlink: ${targetPath}`)
     return
   }
 
-  log(`已创建 link 文件: ${targetPath}`)
+  log(`Created link file: ${targetPath}`)
   void ensureRenameDaemon()
 }

package/src/command-open.ts

@@ -38,7 +38,7 @@ const resolveConfigPath = async (scope?: ConfigScope) => {
 export const openConfigFolder = async (scope?: ConfigScope) => {
   const config = await resolveConfigPath(scope)
   if (!config) {
-    fail(`未找到配置文件，请先运行: ${formatCommand('init')}`)
+    fail(`Config file not found. Run: ${formatCommand('init')}`)
     return
   }
 

package/src/command-search.ts

@@ -19,7 +19,7 @@ const pickFromList = async (names: string[]) => {
 
   const prompt = new AutoComplete({
     name: 'prompt',
-    message: '选择 prompt 文件',
+    message: 'Select a prompt file',
     choices: names,
     limit: 10,
   })
@@ -32,19 +32,19 @@ const pickFromList = async (names: string[]) => {
 export const searchAndLink = async (target?: string, scope?: ConfigScope) => {
   const info = await loadPromptRoot(scope)
   if (!info) {
-    fail(`未配置 prompts_root，请先运行: ${formatCommand('init')}`)
+    fail(`prompts_root is not configured. Run: ${formatCommand('init')} (this creates your global config and prompts_root)`)
     return
   }
 
   const names = await listFiles(info.root)
   if (!names.length) {
-    log('未找到任何 prompt 文件')
+    log('No prompt files found')
     return
   }
 
   const selected = await pickFromList(names.sort())
   if (!selected) {
-    log('未选择任何文件')
+    log('No file selected')
     return
   }
 

package/src/command-status.ts

@@ -9,7 +9,7 @@ export const statusLinks = async () => {
   const links = await readLinks()
   const entries = Object.entries(links)
   if (!entries.length) {
-    log('未发现 link 记录')
+    log('No links found')
     return
   }
 

package/src/commands.ts

@@ -13,17 +13,17 @@ import type { ConfigScope } from './config'
 export const registerCommands = (program: Command) => {
   program
     .command('init')
-    .description('初始化全局配置')
+    .description('Initialize global config')
     .action(async () => {
       await initConfig('global')
     })
 
   program
     .command('set')
-    .description('设置并切换值')
-    .argument('<name>', '命名 key，如 spec')
-    .argument('<file>', 'prompt 文件路径')
-    .argument('[scope]', 'project | global，默认 global')
+    .description('Save and switch source')
+    .argument('<name>', 'Source name, e.g. spec')
+    .argument('<file>', 'Prompt file path or URL')
+    .argument('[scope]', 'project | global (default: global)')
     .action(async (name, file, scopeInput) => {
       const { scope, error } = resolveScope(scopeInput)
       if (error) {
@@ -36,9 +36,9 @@ export const registerCommands = (program: Command) => {
 
   program
     .command('use')
-    .description('切换到已保存的值')
-    .argument('<name>', '命名 key，如 spec')
-    .argument('[scope]', 'project | global，默认 global')
+    .description('Switch to a saved source')
+    .argument('<name>', 'Source name, e.g. spec')
+    .argument('[scope]', 'project | global (default: global)')
     .action(async (name, scopeInput) => {
       const { scope, error } = resolveScope(scopeInput)
       if (error) {
@@ -52,27 +52,27 @@ export const registerCommands = (program: Command) => {
 
   program
     .command('insert')
-    .description('插入占位符')
-    .argument('<file>', '目标文件路径')
+    .description('Insert placeholder')
+    .argument('<file>', 'Target file path')
     .action(async (file) => {
       await insertPlaceholder(file)
     })
 
   program
     .command('apply')
-    .description('应用当前值')
-    .argument('[files...]', '指定要替换的文件列表')
+    .description('Apply current source')
+    .argument('[files...]', 'Files to apply (optional)')
     .action(async (files: string[] = []) => {
       await applyCurrent(files)
     })
 
   program
     .command('link')
-    .description('创建 link 文件')
-    .argument('[name]', 'prompt 文件名（可省略进入交互）')
-    .argument('[file]', '目标文件路径')
-    .argument('[scope]', 'project | global，默认 global')
-    .option('-i', '交互搜索')
+    .description('Create link file')
+    .argument('[name]', 'Prompt name (omit for interactive)')
+    .argument('[file]', 'Target file path')
+    .argument('[scope]', 'project | global (default: global)')
+    .option('-i', 'Interactive search')
     .action(async (name, file, scopeInput, options) => {
       const interactive = options.i || !name || name === '-'
       let targetFile = file
@@ -111,10 +111,10 @@ export const registerCommands = (program: Command) => {
     })
 
   program
-    .command('search')
-    .description('交互搜索并创建 link')
-    .argument('[file]', '目标文件路径')
-    .argument('[scope]', 'project | global，默认 global')
+    .command('search', { hidden: true })
+    .description('Alias for `link -i` (deprecated)')
+    .argument('[file]', 'Target file path')
+    .argument('[scope]', 'project | global (default: global)')
     .action(async (file, scopeInput) => {
       let scope: ConfigScope | undefined
       if (scopeInput) {
@@ -131,8 +131,8 @@ export const registerCommands = (program: Command) => {
 
   program
     .command('open-config')
-    .description('打开配置所在文件夹')
-    .argument('[scope]', 'project | global，默认 global')
+    .description('Open config folder')
+    .argument('[scope]', 'project | global (default: global)')
     .action(async (scopeInput) => {
       let scope: ConfigScope | undefined
       if (scopeInput) {
@@ -150,14 +150,14 @@ export const registerCommands = (program: Command) => {
 
   program
     .command('status')
-    .description('查看 link 状态')
+    .description('Show link status')
     .action(async () => {
       await statusLinks()
     })
 
   program
     .command('rename-daemon', { hidden: true })
-    .description('内部重命名监听')
+    .description('Internal rename watcher')
     .action(async () => {
       await runRenameDaemon()
     })

package/src/content-source.ts

@@ -5,7 +5,7 @@ export const readSourceText = async (sourcePath: string) => {
   if (isUrl(sourcePath)) {
     const response = await fetch(sourcePath)
     if (!response.ok) {
-      throw new Error(`无法读取远程文件: ${response.status}`)
+      throw new Error(`Failed to fetch remote file: ${response.status}`)
     }
     return response.text()
   }

package/src/link-manager.ts

@@ -21,7 +21,7 @@ const readSource = async (sourcePath: string) => {
 const readRemote = async (sourcePath: string) => {
   const response = await fetch(sourcePath)
   if (!response.ok) {
-    throw new Error(`无法读取远程文件: ${response.status}`)
+    throw new Error(`Failed to fetch remote file: ${response.status}`)
   }
   const content = await response.text()
   return { content, hash: hashContent(content) }
@@ -77,7 +77,7 @@ export const pullLink = async (sourcePath: string, targetPath: string) => {
 const resolveConflict = (sourceHash: string, linkHash: string | null, payloadHash: string) => {
   if (!linkHash) return null
   if (sourceHash !== linkHash && payloadHash !== linkHash) {
-    return '检测到冲突，请先 pull 更新后再写入'
+    return 'Conflict detected. Pull latest changes before writing.'
   }
   return null
 }
@@ -85,20 +85,20 @@ const resolveConflict = (sourceHash: string, linkHash: string | null, payloadHas
 const resolveScopeChange = (sourceHash: string, linkHash: string | null, payloadHash: string) => {
   if (!linkHash) return null
   if (sourceHash !== linkHash && payloadHash === linkHash) {
-    return '源文件已更新，请先 pull 同步'
+    return 'Source updated upstream. Pull latest changes first.'
   }
   return null
 }
 
 export const pushLink = async (sourcePath: string, targetPath: string) => {
   if (isRemote(sourcePath)) {
-    throw new Error('远程文件不支持写入')
+    throw new Error('Remote sources are read-only.')
   }
 
   const lockPath = getLockPath(sourcePath)
   const link = await readLinkMeta(targetPath)
   if (!link) {
-    throw new Error('文件不是 link 文件')
+    throw new Error('Target is not a link file.')
   }
 
   const payload = stripLinkHeader(link.content)
@@ -128,13 +128,13 @@ export const pushLink = async (sourcePath: string, targetPath: string) => {
 
 export const syncLink = async (sourcePath: string, targetPath: string) => {
   if (isRemote(sourcePath)) {
-    throw new Error('远程文件不支持写入')
+    throw new Error('Remote sources are read-only.')
   }
 
   const lockPath = getLockPath(sourcePath)
   const link = await readLinkMeta(targetPath)
   if (!link) {
-    throw new Error('文件不是 link 文件')
+    throw new Error('Target is not a link file.')
   }
 
   const payload = stripLinkHeader(link.content)

package/src/lock.ts

@@ -29,7 +29,7 @@ export const waitForUnlock = async (lockPath: string) => {
 
     const elapsed = Date.now() - start
     if (elapsed >= LOCK_TIMEOUT_MS) {
-      throw new Error('写入锁等待超时，请稍后重试')
+      throw new Error('Timed out waiting for write lock. Please try again.')
     }
 
     await sleep(LOCK_INTERVAL_MS)
@@ -45,7 +45,7 @@ export const withLock = async <T>(lockPath: string, task: () => Promise<T>) => {
 
     const elapsed = Date.now() - start
     if (elapsed >= LOCK_TIMEOUT_MS) {
-      throw new Error('写入锁等待超时，请稍后重试')
+      throw new Error('Timed out waiting for write lock. Please try again.')
     }
 
     await sleep(LOCK_INTERVAL_MS)

package/src/scope.ts

@@ -9,5 +9,5 @@ export const resolveScope = (input?: string): ScopeResult => {
   if (!input) return { scope: 'global', error: null }
   if (input === 'global') return { scope: 'global', error: null }
   if (input === 'project') return { scope: 'project', error: null }
-  return { scope: 'global', error: 'scope 必须是 project 或 global' }
+  return { scope: 'global', error: 'scope must be project or global' }
 }