claude-code-token-saver 0.1.3 → 0.1.5

package/README.md

@@ -28,7 +28,7 @@ curl -fsSL https://raw.githubusercontent.com/NgTrgGiang/claude-code-token-saver/
 bash setup-claude-code.sh
 ```
 
-Cả 3 cách đều **không ghi đè** file đã tồn tại. Toàn bộ nội dung nằm trong `.claude/` (+ `CLAUDE.md` ở gốc), an toàn để commit và chia sẻ cho cả team.
+Cả 3 cách đều **không ghi đè** file đã tồn tại. Toàn bộ nội dung nằm trong `.claude/` (+ `CLAUDE.md` ở gốc). Đây là **đồ dùng local, tái tạo được** — cần đâu cài đó, nên tool tự thêm chúng vào `.gitignore` để repo dự án của bạn luôn sạch.
 
 > Mọi cách đều cần **bash** trên máy. Trên Windows: dùng Git Bash / WSL, hoặc cài [Git for Windows](https://git-scm.com/download/win).
 
@@ -67,12 +67,9 @@ Xong bước này, dự án của bạn sẽ mọc ra `CLAUDE.md` + thư mục `
 
 Mở `CLAUDE.md`, viết ngắn gọn phần **Architecture** (code nằm đâu), **Conventions** (quy ước riêng), và **lệnh dev/run**. Đây là phần Claude đọc mỗi lượt nên giữ thật gọn.
 
-### Bước 3 — Commit cho cả team
+### Bước 3 — Không cần commit gì
 
-```bash
-git add CLAUDE.md .claude/
-git commit -m "Add Claude Code rails"
-```
+Tool đã tự thêm `.claude/` và `CLAUDE.md` vào `.gitignore`, nên repo dự án của bạn vẫn sạch. Cần dùng ở máy/dự án khác thì **chạy lại installer** là có ngay — không phải commit hay chia sẻ gì cả.
 
 ### Bước 4 — Làm việc trong Claude Code
 
@@ -97,7 +94,7 @@ Trong lúc đó các hook tự chạy ngầm: chặn lệnh nguy hiểm, tự fo
 | Đường dẫn | Công dụng |
 |-----------|-----------|
 | `CLAUDE.md` | Bộ nhớ dự án gọn (< ~200 dòng): commands, kiến trúc, quy ước, gotchas, workflow |
-| `.claude/settings.json` | Hooks + danh sách chặn quyền (chặn đọc `.env`, `secrets/`) — **nên commit** |
+| `.claude/settings.json` | Hooks + danh sách chặn quyền (chặn đọc `.env`, `secrets/`) + status line |
 | `.claude/hooks/guard-bash.sh` | Chặn lệnh shell nguy hiểm (`rm -rf /`, fork bomb, `git push --force`, `chmod -R 777`, pipe script từ mạng vào shell) |
 | `.claude/hooks/format-file.sh` | Tự động format file sau khi Claude ghi (prettier / ruff / gofmt / rustfmt) |
 | `.claude/hooks/statusline.js` | Vẽ thanh usage 5 giờ ở đáy phiên (chỉ khi bật usage; xem mục bên dưới) |

package/bin/cli.js

@@ -22,32 +22,42 @@ if (!fs.existsSync(script)) {
   process.exit(1);
 }
 
-// Candidate bash locations. First hit that runs wins.
+// WSL's bash is often first on the Windows PATH, but it cannot open C:/... paths
+// (it needs /mnt/c/...). So on Windows we prefer Git Bash (MSYS), which does
+// understand C:/... paths, and only fall back to plain `bash` / WSL afterwards.
+const WSL_BASH = "C:\\Windows\\System32\\bash.exe";
+
 function candidateBashes() {
-  const list = ["bash"];
-  if (process.platform === "win32") {
-    const pf = process.env["ProgramFiles"] || "C:\\Program Files";
-    const pf86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
-    const local = process.env["LOCALAPPDATA"] || "";
-    list.push(
-      path.join(pf, "Git", "bin", "bash.exe"),
-      path.join(pf, "Git", "usr", "bin", "bash.exe"),
-      path.join(pf86, "Git", "bin", "bash.exe"),
-      local && path.join(local, "Programs", "Git", "bin", "bash.exe"),
-      "C:\\Windows\\System32\\bash.exe" // WSL
-    );
-  }
-  return list.filter(Boolean);
+  if (process.platform !== "win32") return ["bash"];
+  const pf = process.env["ProgramFiles"] || "C:\\Program Files";
+  const pf86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
+  const local = process.env["LOCALAPPDATA"] || "";
+  return [
+    path.join(pf, "Git", "bin", "bash.exe"),
+    path.join(pf, "Git", "usr", "bin", "bash.exe"),
+    path.join(pf86, "Git", "bin", "bash.exe"),
+    local && path.join(local, "Programs", "Git", "bin", "bash.exe"),
+    "bash", // PATH (may be WSL; tried only if no Git Bash is present)
+    WSL_BASH, // WSL, last resort
+  ].filter(Boolean);
 }
 
 const args = process.argv.slice(2);
 
-// Pass a forward-slash path to bash. On Windows the script path uses
-// backslashes (C:\Users\...), which bash would treat as escape sequences and
-// mangle (C:UsersAdmin...). Git Bash / MSYS accept C:/Users/... just fine.
-const scriptArg = script.replace(/\\/g, "/");
+// Pass a forward-slash path to bash. On Windows the script path uses backslashes
+// (C:\Users\...), which bash would treat as escape sequences and mangle
+// (C:UsersAdmin...). Git Bash / MSYS accept C:/Users/... just fine.
+const scriptFwd = script.replace(/\\/g, "/");
+
+// WSL needs a /mnt/<drive>/... path instead of C:/...
+function toWslPath(p) {
+  return p.replace(/^([A-Za-z]):\//, function (_m, d) {
+    return "/mnt/" + d.toLowerCase() + "/";
+  });
+}
 
 for (const bash of candidateBashes()) {
+  const scriptArg = bash === WSL_BASH ? toWslPath(scriptFwd) : scriptFwd;
   const res = spawnSync(bash, [scriptArg, ...args], {
     stdio: "inherit",
     cwd: process.cwd(),
@@ -55,6 +65,9 @@ for (const bash of candidateBashes()) {
   if (res.error && res.error.code === "ENOENT") {
     continue; // this bash isn't here, try the next candidate
   }
+  if (res.status === 127) {
+    continue; // bash ran but couldn't open the script (e.g. WSL + C:/ path) → next
+  }
   process.exit(res.status == null ? 1 : res.status);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-token-saver",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "One-shot installer that adds token-saving Claude Code rails (CLAUDE.md, hooks, subagents, slash commands, dev-docs) to any git repo.",
   "bin": {
     "claude-code-token-saver": "bin/cli.js",

package/setup-claude-code.sh

@@ -10,8 +10,9 @@
 #     bash setup-claude-code.sh
 #
 # It never overwrites existing files unless you pass --force.
-# Everything it writes lives under .claude/ (+ CLAUDE.md at the root),
-# so it is safe to commit to your repo and share with your team.
+# Everything it writes lives under .claude/ (+ CLAUDE.md at the root) and is a
+# local, regenerable scaffold — the installer git-ignores it so your repo stays
+# clean; just re-run it wherever you want the rails.
 # ---------------------------------------------------------------------------
 
 set -euo pipefail
@@ -144,7 +145,7 @@ EOF
 
 # ===========================================================================
 # 2. Hooks + permissions  — .claude/settings.json
-#    (safe to commit; secrets go in settings.local.json)
+#    (local scaffold, git-ignored; personal overrides go in settings.local.json)
 # ===========================================================================
 # Quality gate: block `git commit` unless tests pass.
 # Safety gate: block obviously destructive shell commands.
@@ -414,16 +415,18 @@ and compaction. Update with `/save`. Resume a session with:
 Files (per active task): plan.md, context.md, tasks.md, and SPEC.md (from /plan).
 EOF
 
-# Add ignore hints for personal/local settings, without clobbering an existing file.
+# These rails are a local, regenerable scaffold (re-run this installer anytime to
+# recreate them), so keep them out of the project's git. Add the ignore lines
+# without clobbering an existing .gitignore.
 if [[ -f .gitignore ]]; then
-  for line in ".claude/settings.local.json" ".claude/dev-docs/*.local.md"; do
+  for line in ".claude/" "CLAUDE.md"; do
     grep -qxF "$line" .gitignore 2>/dev/null || { echo "$line" >> .gitignore; ok ".gitignore += $line"; }
   done
 else
   write_file ".gitignore" <<'EOF'
-# Claude Code — personal/local overrides (keep out of git)
-.claude/settings.local.json
-.claude/dev-docs/*.local.md
+# Claude Code rails (installed by claude-code-token-saver; re-run to regenerate)
+.claude/
+CLAUDE.md
 EOF
 fi
 
@@ -435,7 +438,7 @@ info "Done. Here's what got installed:"
 cat <<EOF
 
   CLAUDE.md                         lean project memory (fill in the blanks)
-  .claude/settings.json             hooks + permission deny-list (commit this)
+  .claude/settings.json             hooks + permission deny-list + status line
   .claude/hooks/guard-bash.sh       blocks destructive shell commands
   .claude/hooks/format-file.sh      auto-formats files Claude writes
   .claude/agents/explorer.md        read-only investigator (own context)
@@ -448,7 +451,7 @@ cat <<EOF
 
 ${c_ylw}Next:${c_reset}
   1. Open CLAUDE.md and fill in Architecture / Conventions / dev command.
-  2. Commit .claude/ and CLAUDE.md so your team gets the same rails.
+  2. These rails are git-ignored (local + regenerable) — re-run this anytime.
   3. In Claude Code: run /hooks to confirm hooks are registered.
   4. Try the habits: /plan → /clear → build → /verify → /save.