claude-codex-code-review 0.2.0 → 0.3.0

package/README.md

@@ -13,22 +13,50 @@
 
 ## 安装
 
-### 使用 curl
+### 全局安装（默认）
 
-在目标项目根目录执行：
+安装后所有项目都可以直接使用 `/codex-review`，无需逐个项目安装。
+
+使用 npx：
+
+```bash
+npx claude-codex-code-review install
+```
+
+使用 curl：
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/lkkwxy/claude-codex-claude-codex-review-claude/main/scripts/install.sh | bash
 ```
 
+全局安装会：
+
+- 将脚本安装到 `~/.claude/scripts/codex-review.sh`
+- 将斜杠命令安装到 `~/.claude/commands/codex-review.md`
+- 将 `.ai-review/` 加入全局 gitignore，确保中间文件不会被任何项目提交
+
+如果某个项目需要自定义配置，在该项目根目录创建 `.codex-review.yml` 即可。
+
+### 项目级安装
+
+如果只想在单个项目中使用，可以在项目根目录执行：
+
+#### 使用 curl
+
+在目标项目根目录执行：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/lkkwxy/claude-codex-claude-codex-review-claude/main/scripts/install.sh | bash -s -- --local
+```
+
 注意：`curl | bash` 必须使用 `raw.githubusercontent.com` 地址，不能使用 GitHub 页面里的 `blob/main` 地址。
 
-### 使用 npx
+#### 使用 npx
 
-发布到 npm 后，可以在目标项目根目录执行：
+在目标项目根目录执行：
 
 ```bash
-npx claude-codex-code-review install
+npx claude-codex-code-review install -- --local
 ```
 
 也可以指定安装目录：
@@ -45,7 +73,7 @@ npx claude-codex-code-review install -- --force
 
 ## 使用
 
-安装后，在目标项目里打开 Claude Code，运行：
+安装后，在任意项目里打开 Claude Code，运行：
 
 ```text
 /codex-review

package/bin/codex-review

@@ -2,9 +2,17 @@
 set -u
 set -o pipefail
 
-PACKAGE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  SCRIPT_DIR="$(cd "$(dirname "$SOURCE")" && pwd -P)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ "$SOURCE" != /* ]] && SOURCE="$SCRIPT_DIR/$SOURCE"
+done
+PACKAGE_ROOT="$(cd "$(dirname "$SOURCE")/.." && pwd -P)"
 TARGET_DIR="$(pwd)"
 FORCE=0
+GLOBAL=1
+LOCAL=0
 
 usage() {
   cat <<'USAGE'
@@ -12,15 +20,17 @@ Usage:
   claude-codex-code-review install [options]
   claude-codex-code-review --help
 
-Installs the Claude Code /codex-review command into the current project.
+Installs the Claude Code /codex-review command globally (default) or into a specific project.
 
 Options:
-  --target-dir <dir>  Install into a specific project directory. Default: current directory.
-  --force             Overwrite existing codex-review files.
-  -h, --help          Show this help.
+  --local               Install into the current project instead of globally.
+  --target-dir <dir>    Install into a specific project directory (implies --local).
+  --force               Overwrite existing codex-review files.
+  -h, --help            Show this help.
 
 Examples:
   npx claude-codex-code-review install
+  npx claude-codex-code-review install -- --local
   npx claude-codex-code-review install -- --target-dir /path/to/project
   npx claude-codex-code-review install -- --force
 USAGE
@@ -65,6 +75,53 @@ append_gitignore_once() {
   fi
 }
 
+install_global() {
+  local global_commands_dir="$HOME/.claude/commands"
+  local global_scripts_dir="$HOME/.claude/scripts"
+  local script_path="$global_scripts_dir/codex-review.sh"
+  local source_template="$PACKAGE_ROOT/.claude/commands/codex-review.md"
+  local source_script="$PACKAGE_ROOT/scripts/codex-review.sh"
+
+  if [ ! -f "$source_template" ]; then
+    fail "package template is missing: $source_template"
+  fi
+  if [ ! -f "$source_script" ]; then
+    fail "package template is missing: $source_script"
+  fi
+
+  mkdir -p "$global_commands_dir"
+  mkdir -p "$global_scripts_dir"
+
+  if [ -f "$global_scripts_dir/codex-review.sh" ] && [ "$FORCE" -ne 1 ]; then
+    log "Keeping existing $global_scripts_dir/codex-review.sh"
+  else
+    cp "$source_script" "$global_scripts_dir/codex-review.sh"
+    chmod +x "$global_scripts_dir/codex-review.sh"
+    log "Installed $global_scripts_dir/codex-review.sh"
+  fi
+
+  if [ -f "$global_commands_dir/codex-review.md" ] && [ "$FORCE" -ne 1 ]; then
+    log "Keeping existing $global_commands_dir/codex-review.md"
+  else
+    sed "s|Bash(scripts/codex-review.sh:|Bash(${script_path}:|g;
+         s|scripts/codex-review.sh \"\$ARGUMENTS\"|${script_path} \"\$ARGUMENTS\"|g" \
+      "$source_template" > "$global_commands_dir/codex-review.md"
+    log "Installed $global_commands_dir/codex-review.md"
+  fi
+
+  local excludes_file
+  excludes_file="$(git config --global core.excludesFile 2>/dev/null || true)"
+  if [ -z "$excludes_file" ]; then
+    excludes_file="$HOME/.gitignore_global"
+    git config --global core.excludesFile "$excludes_file"
+    log "Set git global core.excludesFile to $excludes_file"
+  fi
+  append_gitignore_once "$excludes_file"
+
+  log "Global install complete. /codex-review is now available in all projects."
+  log "Optional: create .codex-review.yml in any project to customize settings."
+}
+
 COMMAND="${1:-install}"
 case "$COMMAND" in
   install)
@@ -81,13 +138,19 @@ esac
 
 while [ "$#" -gt 0 ]; do
   case "$1" in
+    --local)
+      GLOBAL=0
+      shift
+      ;;
     --target-dir)
       [ "$#" -ge 2 ] || fail "--target-dir requires a value."
       TARGET_DIR="$2"
+      GLOBAL=0
       shift 2
       ;;
     --target-dir=*)
       TARGET_DIR="${1#*=}"
+      GLOBAL=0
       shift
       ;;
     --force)
@@ -104,6 +167,11 @@ while [ "$#" -gt 0 ]; do
   esac
 done
 
+if [ "$GLOBAL" -eq 1 ]; then
+  install_global
+  exit 0
+fi
+
 mkdir -p "$TARGET_DIR"
 cd "$TARGET_DIR" || fail "cannot enter target directory: $TARGET_DIR"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-codex-code-review",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install a Claude Code /codex-review command that runs Codex CLI review and lets Claude apply selected fixes.",
   "license": "MIT",
   "bin": {