codexkit 1.0.3 → 1.0.5

package/.template-manifest.json

@@ -1,14 +1,14 @@
 {
-  "version": "1.0.3",
+  "version": "1.0.4",
   "generator": "codexkit",
   "files": {
     "templates/global/AGENTS.override.md": "11039408f8776171820ce34165b5da6d52a703d26a938fb773e231a159eefe2c",
     "templates/global/.codex-config-template.toml": "aa3490d544eded2ab1eff3eee89823884d1d0085c502eceb604d89408a94848d",
     "templates/project/.codex-config-template.toml": "dc8ded8af4deaf39155d5fdddeabf0763af5293f24e3477ec871d59fd8530e80",
     "templates/project/AGENTS.md.template": "acb5ea31fd561ddbbc79c6baf6de98b990bbac693ba6d836406d270a1f27a981",
-    ".codex/config.toml": "32644bd80c9804612a851907c900ccc2edd84683a3470b224d173e29ee318a6a",
+    ".codex/config.toml": "2079664ff35b0b5b05187c1fa5e6b4fdb0b8df24fff5e69ab9297956459d1b16",
     ".codex/.env.example": "1827612829279fad025404b763ea214412bd5cd53474ad315909a8c275f12b84",
-    ".codex/.version": "f5e5c9534532840fcd45bb002e69ed85c61dba2753450e26b448b7df1481e24d",
+    ".codex/.version": "d1b77b88f4b9f675a900e4143ac768a21218623cfe1703ca43162388c3271bd6",
     ".codex/agents/builder.toml": "b4e887e5ad5202337b0fda9815588db0eec2deee8fdfbdb8dad6bf2df6bf3d30",
     ".codex/agents/debugger.toml": "e67fdaee1807c2d8c40b2752737d6e1f535a0c52d863cc76eb9c8059f292bc13",
     ".codex/agents/general.toml": "274489e5d726ee11fc5d9ec43d44c4b7bc1ac22b435ad536af8818c6d430d46c",
@@ -17,7 +17,7 @@
     ".codex/agents/refactorer.toml": "0de4d73931352edbef9dcff4bfd6ad4fb61ff10ba5fcf330d724e5f4193fdd67",
     ".codex/agents/reviewer.toml": "8634aac733cbf2e9c8d5ad81fc22a17c239156c1d78edb15e94b6f63488c1177",
     ".codex/agents/runner.toml": "cb3baca8eb358ace7c4b63f39ec6de0833b6e46655ccf816b0a553ec25faa677",
-    ".codex/agents/scout.toml": "e06fa68c87261d0bfa8f2e61f34117f2291702236ca98df49d25b2faedeaf55c",
+    ".codex/agents/scout.toml": "ff411e1a10f9ff99cdc92e345be92e5bfa674f6d9dd03ca03dab7d5b31895252",
     ".codex/agents/shipper.toml": "940c3ffd2c467e11def4c4d87bae4c5244deee42bc48009cabbf1a07009eac4b",
     ".codex/agents/vision.toml": "430a3b9ae1f8d2322791b2683ea7cf1ca5dad353f00f2b6c2c09fd8bfe9acbe4",
     ".codex/prompts/compound.md": "2f3f713031c6a2591cf257a47f8909874ff0f94cf7a6663eeb8fe30fc1ae2a2e",
@@ -31,8 +31,9 @@
     ".codex/prompts/plan.md": "f47aeb00d01167d5fee372115043fbfcac86216d59987ec16f67e7058aad6c42",
     ".codex/prompts/pr.md": "0866ed92ac74447ce01c955f49b00f055c5a244f80bd12a5f679f3860b776212",
     ".codex/prompts/research.md": "0ab8c8652d789ffc62a13ef6f7d533f63db77d8292dfaba4888a13a8eddb9d23",
-    ".codex/prompts/resume.md": "e3d9c00cb1eb05eb367f627a039c0519c694458cf5be83b5ed9873e623e4c8e3",
+    ".codex/prompts/resume.md": "02b286294fcd2c58a2e3c0a77995eefc9c76319dbbc54e35fc1208f06c7fca99",
     ".codex/prompts/review-codebase.md": "07f6ea450c02f820871edb2c5432d364dfa8e87bd662f13ba305ccb2cc25a5de",
+    ".codex/prompts/search.md": "f648fbfa84e16654981e262fb233a1e23b2525790f0698da5bc2bbc8aea60ad0",
     ".codex/prompts/ship.md": "bf0eee8272c2ffab78574aef940be07e7dcf4129b7aa9d1368d850be16cde099",
     ".codex/prompts/start.md": "4abc1166ae6657070ec3162610504e8e4ba19df595e4552fe30bae70561999e3",
     ".codex/prompts/status.md": "c742f0b64b08f59fceb3eb90e1693a81de421c2311eb553f85793faed19e1bca",
@@ -323,12 +324,12 @@
     ".codex/skills/cloudflare/references/zaraz/README.md": "c1fd43e131dd57576c84b10c4bc12b92d17ce8a837d042c0ed0e9ec5ab2fd256",
     ".codex/skills/code-navigation/SKILL.md": "bd35077d9afd8becb5f0813e9ced5c214daf6e5aad3926270091cb731fe58e28",
     ".codex/skills/code-review/SKILL.md": "3f7d6b61adbe4eb68bc6907721d1ad7d74c474a6eb0a6784ea0163945d272cad",
-    ".codex/skills/compaction/SKILL.md": "0d623d5c435d62d8bc5082b40b52871080a22be47f14418ce5ffd17d0fe4985b",
+    ".codex/skills/compaction/SKILL.md": "d85f33180d26148d500ef6501e421513bec349f9078d4a5a47f70341088a2a01",
     ".codex/skills/condition-based-waiting/SKILL.md": "cf3c747488745c6e51e62bbf1e84b3cb868aac05ff3f8c245e65aa9ab4a0c5a8",
     ".codex/skills/condition-based-waiting/example.ts": "e35f816255c50db93421c8b5f165a6efbc3baa0856ce66a44edc7b34c0bd3608",
     ".codex/skills/context-engineering/SKILL.md": "1dcd750d778aebbf11f5ac09ace26b5ebd69f4d7e68994f53c22464a74e430b5",
     ".codex/skills/context-initialization/SKILL.md": "5fbf8502303789fffba37f62fa274f9e7fece31935859d5c9f0be3bfd3b14764",
-    ".codex/skills/context-management/SKILL.md": "1666a72e8388e4cbd4a3addf52546966122d617d9091b1eb983b520ae0177dae",
+    ".codex/skills/context-management/SKILL.md": "e6e39288a95776860126c1b65a8b4143046858455960b9b1b19f055de6d24fb8",
     ".codex/skills/core-data-expert/SKILL.md": "f8db3769edd501b86795d3ea43dd32060060dd1ab9f905055fea9301f07009a6",
     ".codex/skills/core-data-expert/references/batch-operations.md": "96ab160c97b15b661de854bd24a2e5e3a9b8ec05a51009f5fe98ad887e52e0e7",
     ".codex/skills/core-data-expert/references/cloudkit-integration.md": "550039d328a43519a2fb50ce3d8d8572a2ab8253991aa919ec33b849b60b56a8",
@@ -455,7 +456,7 @@
     ".codex/skills/root-cause-tracing/SKILL.md": "ff1002204c1ec1b1de54a77886edb0cd7c7d1d97a2b571a861818b2a466bba85",
     ".codex/skills/root-cause-tracing/find-polluter.sh": "6462747eae9b175ac145b78bcfaeab755654a75e32637f08eb633f065a9e1d7c",
     ".codex/skills/safe-implementation/SKILL.md": "fd92709e320b3ccbaa76fe5259424439ab769a67e8d72830f780fde8210ce2da",
-    ".codex/skills/session-management/SKILL.md": "57353a9f7f75f9ac1a7e658b0218780e3c51e51f200fd5c88fc82cd884e77b93",
+    ".codex/skills/session-management/SKILL.md": "53532fa06e003a7dfd62afa0b8b7d4f1c8ac0967b35f1d5bd8734668417d276b",
     ".codex/skills/sharing-skills/SKILL.md": "c662da5bd3907b987121854efddd90a266db902d1662e62b4e6054e3f03d07dd",
     ".codex/skills/skill-creator/SKILL.md": "c574e634e616905287338f6cad0359ef471a6f241cd888cabcebfa1710d2a71d",
     ".codex/skills/source-code-research/SKILL.md": "0ec5a37e92c81505de40e37c190f1d64c870e8c5e75636ea76901f1d05fc265f",
@@ -585,10 +586,10 @@
     ".codex/hooks/stop.sh": "7008c4a7a6fba302b0f589c65370b0bf8444a2c7b2114117521b9ea09041cfc3",
     ".codex/scripts/append_worklog.sh": "44b7d6f00f4be6aec77081c7c74d9891cb12b6096f29204903ae544991172591",
     ".codex/scripts/apply_worklog_archive.sh": "416958f91d760a09183235c2d7a67faa0a006351652bf743da7045273129c49c",
-    ".codex/scripts/audit_memory_hygiene.sh": "aab875482c959e85d7d2d27434639849bed27ed77d74514d2ac60e2fe0e33083",
+    ".codex/scripts/audit_memory_hygiene.sh": "9739a42d176db2002d81f0626c3458eda2004a4fdeeefe2c0b2797d10cb240b1",
     ".codex/scripts/build_memory_index.sh": "247ecaed52d305dcf6651f137c8e762e7b4661781af16df8a296b3da19ad96b8",
     ".codex/scripts/build_prior_related_work.sh": "08d226f318eb4859529f774b9e03daaee4c70d17e814422cddb6f1c1efd52313",
-    ".codex/scripts/build_startup_brief.sh": "880a7156e0999d94729e9cea174ccb4291ef5752d4a572851dc24c7eb9818f92",
+    ".codex/scripts/build_startup_brief.sh": "7130ae1c5a56c79f66c6450a558f3f6b9642ed34df8696b2fde82d1d287caddf",
     ".codex/scripts/close_bead.sh": "90944f59945a440280b958924858e1bb515e60bbc36805e26387da77ef657022",
     ".codex/scripts/detect_changed_files.sh": "10633eda525c32ac0a1410239117f8ede5d23ae7faba4108b3f3e9096ffed366",
     ".codex/scripts/ensure_beads.sh": "9f69036f7fdb332f2089b4a58afdc55d982612cc004d98628bfd0b311f74e078",
@@ -599,10 +600,10 @@
     ".codex/scripts/sync_bead_context.sh": "6b8d6908cffbbf8fdbf5bf548e09788d504daddce092bd7112eee695882a64a7",
     ".codex/scripts/validate_memory_docs.sh": "a0a2b184db21dae92c88a0ea837be8bcaf7a47150392034d3110842f266c4afc",
     ".codex/scripts/verify_bead.sh": "16571365aa54f300ec2554573f13bd74c37b22bfc54e1c09d5b55553855a0add",
-    ".codex/mcp/README.md": "06c66bf958de327cdb3e14367beb4ad7d82d1ba4a93eb4a2191fe134678ba430",
+    ".codex/mcp/README.md": "e03cb3c5cd228692c5f573b1ead8e2b0f2effda361ec43721617029d561f3083",
     ".codex/mcp/basic-memory.toml.example": "b40ef19861a8f29d3d78d7b166474cc4d44e79362bf5fc81942754609ff4ee3c",
-    ".codex/mcp/context7.toml.example": "d016f67a43a1e578bb2c0311ba61a6e63e58aff3dc783b084eb082141f79a42b",
-    ".codex/mcp/exa.toml.example": "7aea5ab1c227ca3cf4ca9c976ec270897f39526954e8618c89764a47ec23f69b",
+    ".codex/mcp/context7.toml.example": "658967017443c6c9d6b181694767c3f97180c2febdc050cc3747de2b3ae2b761",
+    ".codex/mcp/exa.toml.example": "bc746ddc0fc9e88cbaa14d8b6cff1b3d3a5e04e587722b7a82d79d18a6cd21d4",
     ".codex/mcp/memory-bridge.toml.example": "3689f1b04410463c2e648e437e16c30901a7b1c5e165255e03b3552c9a4b03e8",
     ".codex/mcp/memory.toml.example": "3c5575ebd822729023220c7a6c7f7a6a7e0ac9e43edbf7e0665d4e06938fb8e7",
     ".codex/mcp/ref.toml.example": "a7a5d84b04f9d7a35282e91eb45111a0d7ddb185cdc8326461a8306d9b5d802b",
@@ -621,15 +622,15 @@
     ".codex/memory/_templates/gotcha.md": "bf06bb72050dd71afb543d9ac9480f35ac240100fe8221ae855cf286dc94c0a7",
     ".codex/memory/_templates/handoff.md": "1d83137e655733453a2895b8a2f6cb29238eeff26ed276250164ebeecdd5e204",
     ".codex/memory/_templates/prd.md": "11f80e3af46896c7980bef37088381350e5cbc90e2f22399c50ed9dcab3f2bc1",
-    ".codex/memory/_templates/project.md": "9481f5cf842ff23e7d8d09288a83df023e969f702309edf7a3ba65536dc6a8b5",
+    ".codex/memory/_templates/project.md": "21e720af0d9bbe600f6707ca6bdc88af75e4d134563b825680738d9aa2d2499e",
     ".codex/memory/_templates/proposal.md": "5ad769245bd83279bbd70fc37976b23c08190d2a4b416eb46cb696b22d437e19",
     ".codex/memory/_templates/research.md": "6966290f90233087979cca5c49c075216c817b9c63c0ae444fea0f4b667ed016",
     ".codex/memory/_templates/roadmap.md": "6945f7fa459554d7195104bc1e8f1debdd3c5d37f869e63ae2a60ecb37065045",
-    ".codex/memory/_templates/session-context.md": "515d6be5bbbb9dfb2d97618f0ca6a0c895c1a91a5c036d9667d658ea113d9551",
-    ".codex/memory/_templates/state.md": "4af203c29a565479547fcba0945118cd66014e32710f0ba75c9f0572e65d46b1",
+    ".codex/memory/_templates/session-context.md": "fb39fb199be3323d1417982ecdfd7eb758a5a3ef06662eab5df10696d6c3eba5",
+    ".codex/memory/_templates/state.md": "98286fa2aa00e216dc29dcc7fe7d9da1401cb33d36af5a482f88e8188bcc788c",
     ".codex/memory/_templates/tasks.md": "54119ce84fd0aa6ecd0148355f33808c061147da774475c94bf7e47bb18f73dd",
-    ".codex/memory/_templates/tech-stack.md": "06cfafa736d9f32876aecfad9cfe54785a4db7dcecf94abdb09b7895761d763f",
-    ".codex/memory/_templates/user.md": "4156bd3195edab1b196ac3f398ca7ec90295b91c3a5b028673be065463e5fdaf",
+    ".codex/memory/_templates/tech-stack.md": "38c0e2255360cc777295bcb89202510f3e0ee0927d7a23422ca55b33a6ef9448",
+    ".codex/memory/_templates/user.md": "d12ba5cdc382dbeeda5128a0b0ffe81993fbebfd882edaa46e6778cf7088cf73",
     ".codex/memory/project/gotchas.md": "05ce128ced24deffbb51a8b7167000c4e4816c4e3275a98f439fddb0e95c2bd6",
     ".codex/memory/project/project.md": "94a76028472946ba9782534de4920e9a77cfdf0f4daa063a97569660ccc06e21",
     ".codex/memory/project/roadmap.md": "6027b3bd3eaeed02b16a59037e760200ce8505f3007375faf2543b4b58bcee6e",

package/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.5] — 2026-03-18
+
+### Fixed
+
+- **Windows compatibility**: CLI entry point changed from bash script (`bin/codexkit`) to Node.js wrapper (`bin/codexkit.js`), fixing `The term '/bin/bash.exe' is not recognized` error when installing via `npm install -g`, `pnpm add -g`, or `bun add -g` on Windows
+- Node.js wrapper auto-detects bash from Git for Windows, MSYS2, WSL, or PATH; provides clear error message with install links if bash is not found
+- Works cross-platform with all major package managers (npm, pnpm, bun, yarn)
+
+## [1.0.4] — 2026-03-18
+
+### Added
+
+- New `/prompts:search` workflow entrypoint for querying durable project memory, prior decisions, and related context
+- Richer memory templates for project, state, session context, tech stack, and user notes
+
+### Changed
+
+- Context7 and Exa MCP documentation/examples now give clearer tool-selection and two-step lookup guidance
+- Scout agent instructions, memory docs, and session-management skills were refined for clearer research and context workflows
+- Global and project installers now emit more helpful progress output during setup and upgrades
+
+### Fixed
+
+- Install/validation coverage now better preserves customized files while checking the updated install surface
+- Supporting scripts and prompt docs were aligned with the new search and memory-management flows
+
 ## [1.0.3] — 2026-03-17
 
 ### Added

package/README.md

@@ -198,7 +198,7 @@ See [docs/profiles.md](docs/profiles.md) for detailed descriptions and customiza
 
 ## Prompts
 
-20 structured workflow entry points — the **"what"** of your development process.
+21 structured workflow entry points — the **"what"** of your development process.
 
 > **Note:** Codex prompt discovery is user-scoped at `~/.codex/prompts`. `codexkit install` bootstraps that prompt directory automatically for the current user, while `codexkit install-global` installs the full shared inventory.
 
@@ -224,6 +224,7 @@ See [docs/profiles.md](docs/profiles.md) for detailed descriptions and customiza
 |                   | `resume`          | Resume work from a previous session               |
 |                   | `status`          | Show project status dashboard                     |
 |                   | `compound`        | Extract and persist learnings                     |
+|                   | `search`          | Search project memory and context for prior knowledge |
 
 ### Standard Development Flow
 

package/bin/codexkit

@@ -28,9 +28,9 @@ usage() {
 Codexkit CLI
 
 Usage:
-  codexkit install [target-dir] [--force] [--upgrade] [--template <name>] [--full-local]
-  codexkit install-global [--force] [--upgrade]
-  codexkit upgrade [target-dir] [--auto-apply-patches]
+  codexkit install [target-dir] [--force] [--upgrade] [--template <name>] [--full-local] [--verbose]
+  codexkit install-global [--force] [--upgrade] [--verbose]
+  codexkit upgrade [target-dir] [--auto-apply-patches] [--verbose]
   codexkit run [codex args...]         # Load project .codex/.env, then exec codex
   codexkit doctor                      # Ownership + validation report
   codexkit bead-start <bead-id> [--use-current-branch]

package/bin/codexkit.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync, execSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+const BASH_SCRIPT = path.join(__dirname, "codexkit");
+
+function findBash() {
+  if (os.platform() !== "win32") {
+    return "/bin/bash";
+  }
+
+  // On Windows, try common bash locations in order
+  const candidates = [];
+
+  // Git for Windows (most common)
+  const programFiles = process.env.ProgramFiles || "C:\\Program Files";
+  const programFilesX86 =
+    process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
+  candidates.push(
+    path.join(programFiles, "Git", "bin", "bash.exe"),
+    path.join(programFilesX86, "Git", "bin", "bash.exe"),
+    path.join(programFiles, "Git", "usr", "bin", "bash.exe")
+  );
+
+  // MSYS2
+  candidates.push("C:\\msys64\\usr\\bin\\bash.exe");
+
+  // WSL
+  const system32 = path.join(
+    process.env.SystemRoot || "C:\\Windows",
+    "System32"
+  );
+  candidates.push(path.join(system32, "bash.exe"));
+
+  // Check PATH via where
+  try {
+    const result = execSync("where bash.exe", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+    if (result) {
+      const first = result.split(/\r?\n/)[0];
+      if (first && fs.existsSync(first)) {
+        return first;
+      }
+    }
+  } catch (_) {
+    // not found via where
+  }
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  console.error(
+    "Error: bash not found. Codexkit requires bash to run.\n\n" +
+      "On Windows, install one of the following:\n" +
+      "  - Git for Windows: https://git-scm.com/download/win\n" +
+      "  - WSL: wsl --install\n" +
+      "  - MSYS2: https://www.msys2.org/\n"
+  );
+  process.exit(1);
+}
+
+const bash = findBash();
+const args = process.argv.slice(2);
+
+try {
+  const result = execFileSync(bash, [BASH_SCRIPT, ...args], {
+    stdio: "inherit",
+    env: { ...process.env },
+    windowsHide: false,
+  });
+  process.exit(0);
+} catch (err) {
+  if (err.status != null) {
+    process.exit(err.status);
+  }
+  console.error(err.message);
+  process.exit(1);
+}

package/install/install-global.sh

@@ -7,10 +7,12 @@ REPO_DIR="$(dirname "$SCRIPT_DIR")"
 # Parse flags
 FORCE=false
 UPGRADE=false
+VERBOSE=false
 for arg in "$@"; do
     case "$arg" in
         --force) FORCE=true ;;
         --upgrade) UPGRADE=true ;;
+        --verbose|-v) VERBOSE=true ;;
     esac
 done
 
@@ -20,45 +22,109 @@ MANIFEST="$REPO_DIR/.codex/.template-manifest.json"
 GLOBAL_DIR="${HOME}/.codex"
 GLOBAL_AGENT_BRIDGE="${HOME}/.agents"
 
-should_copy() {
+# Counters
+_count_created=0
+_count_upgraded=0
+_count_kept=0
+_count_skipped=0
+
+# Returns: 0 = new file, 1 = skip, 2 = safe to upgrade
+check_copy_action() {
     local target="$1"
     local source_path="$2"
     local manifest_hash installed_hash
 
-    # New file → always copy
     [ ! -f "$target" ] && return 0
+    $FORCE && return 2
 
-    # Force → always copy
-    $FORCE && return 0
-
-    # Upgrade mode → check if customized
     if $UPGRADE && [ -f "$MANIFEST" ]; then
         manifest_hash=$(python3 -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
         installed_hash=$(shasum -a 256 "$target" 2>/dev/null | cut -d' ' -f1)
-
         if [ -n "$manifest_hash" ] && [ "$installed_hash" = "$manifest_hash" ]; then
-            # File matches original template → safe to update
-            return 0
+            return 2
         fi
-
-        # File was customized (or not tracked) → skip
         return 1
     fi
 
-    # Default: skip existing
     return 1
 }
 
+should_copy() {
+    local rc=0
+    check_copy_action "$1" "$2" || rc=$?
+    [ "$rc" -ne 1 ]
+}
+
+log_file_op() {
+    local display_path="$1"
+    local action="$2"
+    case "$action" in
+        created)
+            if $VERBOSE; then echo "  CREATED  $display_path"; fi
+            _count_created=$((_count_created + 1))
+            ;;
+        upgraded)
+            if $VERBOSE; then echo "  UPGRADED $display_path"; fi
+            _count_upgraded=$((_count_upgraded + 1))
+            ;;
+        kept)
+            if $VERBOSE; then echo "  KEPT     $display_path (customized)"; fi
+            _count_kept=$((_count_kept + 1))
+            ;;
+        skipped)
+            if $VERBOSE; then echo "  SKIP     $display_path (exists)"; fi
+            _count_skipped=$((_count_skipped + 1))
+            ;;
+    esac
+}
+
+copy_and_log() {
+    local target="$1"
+    local source="$2"
+    local source_path="$3"
+    local display_path="$4"
+    local rc=0
+
+    check_copy_action "$target" "$source_path" || rc=$?
+
+    if [ "$rc" -eq 0 ]; then
+        mkdir -p "$(dirname "$target")"
+        cp "$source" "$target"
+        log_file_op "$display_path" "created"
+    elif [ "$rc" -eq 2 ]; then
+        mkdir -p "$(dirname "$target")"
+        cp "$source" "$target"
+        log_file_op "$display_path" "upgraded"
+    elif $UPGRADE; then
+        log_file_op "$display_path" "kept"
+    else
+        log_file_op "$display_path" "skipped"
+    fi
+}
+
+print_summary() {
+    echo ""
+    local parts=()
+    [ "$_count_created" -gt 0 ] && parts+=("◆ Created $_count_created new files")
+    [ "$_count_upgraded" -gt 0 ] && parts+=("◆ Upgraded $_count_upgraded files")
+    [ "$_count_kept" -gt 0 ] && parts+=("● Preserved $_count_kept customized files")
+    [ "$_count_skipped" -gt 0 ] && parts+=("○ Skipped $_count_skipped existing files")
+
+    for part in "${parts[@]+"${parts[@]}"}"; do
+        echo "  $part"
+    done
+}
+
 echo "=== Codexkit Global Install ==="
 
 if $UPGRADE && [ ! -f "$MANIFEST" ] && ! $FORCE; then
-    echo "⚠ Upgrade checks unavailable (missing .template-manifest.json); existing files will be kept"
+    echo "  ⚠ Upgrade checks unavailable (missing .template-manifest.json); existing files will be kept"
 fi
 
 # Check Codex CLI
 if ! command -v codex &> /dev/null; then
-    echo "⚠ Codex CLI not found. Install from: https://github.com/openai/codex"
-    echo "  Continuing anyway..."
+    echo "  ⚠ Codex CLI not found. Install from: https://github.com/openai/codex"
+    echo "    Continuing anyway..."
 fi
 
 # Create directory
@@ -70,15 +136,7 @@ for file in "$REPO_DIR/templates/global/"*; do
     [ "$filename" = "README.md" ] && continue
     target="$GLOBAL_DIR/$filename"
     source_path="templates/global/$filename"
-
-    if should_copy "$target" "$source_path"; then
-        cp "$file" "$target"
-        echo "  INSTALLED $target"
-    elif $UPGRADE; then
-        echo "  KEPT $target (customized)"
-    else
-        echo "  SKIP $target (exists, use --force to overwrite)"
-    fi
+    copy_and_log "$target" "$file" "$source_path" "~/.codex/$filename"
 done
 
 install_shared_tree() {
@@ -86,7 +144,6 @@ install_shared_tree() {
     local dest_dir="$2"
     local source_prefix="$3"
     local label="$4"
-    local copied=0
 
     [ -d "$src_dir" ] || return 0
     mkdir -p "$dest_dir"
@@ -95,37 +152,17 @@ install_shared_tree() {
         rel_path="${file#$src_dir/}"
         target="$dest_dir/$rel_path"
         source_path="$source_prefix/$rel_path"
-        mkdir -p "$(dirname "$target")"
-
-        if should_copy "$target" "$source_path"; then
-            cp "$file" "$target"
-            if [[ "$target" == *.sh ]]; then
-                chmod +x "$target"
-            fi
-            copied=$((copied + 1))
-        elif $UPGRADE; then
-            echo "  KEPT $target (customized)"
+        copy_and_log "$target" "$file" "$source_path" "~/.codex/${dest_dir#$GLOBAL_DIR/}/$rel_path"
+        if [ -f "$target" ] && [[ "$target" == *.sh ]]; then
+            chmod +x "$target"
         fi
     done < <(find "$src_dir" -type f | sort)
-
-    if [ "$copied" -gt 0 ]; then
-        echo "  INSTALLED $copied $label → $dest_dir"
-    else
-        echo "  SKIP $label (already installed, use --force to overwrite)"
-    fi
 }
 
 # Install shared config, agents, prompts, skills, and hook helpers.
 config_source="$REPO_DIR/templates/global/.codex-config-template.toml"
 config_target="$GLOBAL_DIR/config.toml"
-if should_copy "$config_target" "templates/global/.codex-config-template.toml"; then
-    cp "$config_source" "$config_target"
-    echo "  INSTALLED $config_target"
-elif $UPGRADE; then
-    echo "  KEPT $config_target (customized)"
-else
-    echo "  SKIP $config_target (exists, use --force to overwrite)"
-fi
+copy_and_log "$config_target" "$config_source" "templates/global/.codex-config-template.toml" "~/.codex/config.toml"
 
 install_shared_tree "$REPO_DIR/.codex/agents" "$GLOBAL_DIR/agents" ".codex/agents" "agent files"
 install_shared_tree "$REPO_DIR/.codex/prompts" "$GLOBAL_DIR/prompts" ".codex/prompts" "prompt files"
@@ -135,16 +172,20 @@ install_shared_tree "$REPO_DIR/.codex/skills" "$GLOBAL_DIR/skills" ".codex/skill
 # global skill and config discovery patterns to stay consistent.
 install_shared_tree "$REPO_DIR/.codex/scripts" "$GLOBAL_DIR/scripts" ".codex/scripts" "helper scripts"
 
+# Codex CLI discovers skills at .agents/skills/ (official path).
+# Codexkit stores skills canonically at .codex/skills/.
+# This symlink bridges the two so Codex finds Codexkit skills natively.
 mkdir -p "$GLOBAL_AGENT_BRIDGE"
 if [ ! -e "$GLOBAL_AGENT_BRIDGE/skills" ]; then
     ln -s ../.codex/skills "$GLOBAL_AGENT_BRIDGE/skills"
-    echo "  INSTALLED $GLOBAL_AGENT_BRIDGE/skills → ~/.codex/skills"
+    log_file_op "~/.agents/skills → ~/.codex/skills" "created"
 elif [ -L "$GLOBAL_AGENT_BRIDGE/skills" ]; then
-    echo "  KEPT $GLOBAL_AGENT_BRIDGE/skills symlink"
+    log_file_op "~/.agents/skills symlink" "kept"
 else
-    echo "  KEPT $GLOBAL_AGENT_BRIDGE/skills directory"
+    log_file_op "~/.agents/skills directory" "kept"
 fi
 
+print_summary
 echo ""
 echo "✓ Global install complete"
 echo "  Location: $GLOBAL_DIR"