🐛 fix(core): use absolute paths in global install config

- Replace `stripDotOpencode()` with `toGlobalPath()` that produces absolute paths (e.g., `/home/user/.config/opencode/skills/...`) instead of relative paths like `skills/...`
- Pass `opencodeHome` to `rewriteTemplatePathsForGlobal()` so it can resolve `.opencode/...` relative to the global config directory
- Update SKILL.md documentation to explain why absolute paths are required (OpenCode resolves config paths relative to the current project directory)
- Bump version to 1.3.7 across `package.json`, migration manifests, and landing page
- Fix will prevent all skill, instruction, and agent references from breaking when `opencode` is run from any project directory

Author: defuj

.opencode/skills/global-install/SKILL.md

@@ -198,15 +198,21 @@ Explicitly copies everything locally (traditional behavior). Use when:
 
 On macOS and Linux, OpenCode automatically reads `~/.config/opencode/opencode.jsonc`. All skills, prompts, commands, and instructions are stored flat in that directory. When you run `opencode` in any project, OpenCode finds this global config and loads everything.
 
-The template's `opencode.json` paths (which use `.opencode/skills/...`) are rewritten during global install to flat paths (`skills/...`):
+The template's `opencode.json` paths (which use `.opencode/skills/...`) are rewritten during global install to **absolute paths** pointing into the global directory. This is critical — OpenCode resolves config paths relative to the **current project directory**, so relative paths like `skills/...` would break in every project. Absolute paths guarantee the files are found regardless of where you run `opencode`.
 
-| Template Path | Global Path |
-|---------------|-------------|
-| `.opencode/skills/coding-standards/SKILL.md` | `skills/coding-standards/SKILL.md` |
-| `.opencode/instructions/INSTRUCTIONS.md` | `instructions/INSTRUCTIONS.md` |
-| `.opencode/prompts/agents/it-leader.md` | `prompts/agents/it-leader.md` |
+For example, the resulting config will contain paths like:
 
-Your existing `opencode.jsonc` (with provider config, MCP servers, etc.) is preserved and merged with the new kit entries.
+```json
+{
+  "instructions": [
+    "/Users/me/.config/opencode/instructions/INSTRUCTIONS.md",
+    "/Users/me/.config/opencode/skills/coding-standards/SKILL.md",
+    "..."
+  ]
+}
+```
+
+Instead of broken relative paths like `skills/coding-standards/SKILL.md` that would resolve against whatever project directory you're in.
 
 ## Per-Project Setup
 

CHANGELOG.md

@@ -49,13 +49,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Windows global install path** — corrected from `%APPDATA%\opencode\` to `%USERPROFILE%\.config\opencode\` to match official OpenCode documentation. The previous path (`%APPDATA%`) would have caused OpenCode to not find the agent kit on Windows.
 - **Official path reference** — all paths now confirmed against [opencode.ai/docs/config/](https://opencode.ai/docs/config/) (Global: `~/.config/opencode/opencode.json` on macOS/Linux, `%USERPROFILE%\.config\opencode\` on Windows)
+- **Absolute paths in global config** — `rewriteTemplatePathsForGlobal()` now produces **absolute paths** (e.g. `/Users/user/.config/opencode/skills/...`) instead of relative paths (`skills/...`). This is critical because OpenCode resolves config paths relative to the **current project directory**, not relative to `~/.config/opencode/`. Relative paths would cause all skill, instruction, and agent references to fail in every project.
 
 ### Changed
 
 - `bin/commands/global-path.mjs`: Windows path uses `USERPROFILE` + `.config\opencode` instead of `APPDATA`
 - `package.json`: version bumped to 1.3.6
 - `.opencode/skills/global-install/SKILL.md`: all Windows path references corrected
 
+## [1.3.7] - 2026-06-27
+
+### Notes
+
+- **Prose `.opencode/` references** (64 occurrences across 17 skill/docs/prompt files) are intentionally **not rewritten** during global install. These are informational text for the LLM, not config paths resolved by OpenCode. The critical fix (absolute config paths in `opencode.jsonc`) was already shipped in v1.3.6.
+
+### Changed
+
+- `package.json`: version bumped to 1.3.7
+
 ## [1.3.4] - 2026-06-25
 
 ### Added

bin/commands/init.mjs

@@ -160,37 +160,39 @@ function mergeJson(target, source, strategy = {}) {
   return merged;
 }
 
-/**
- * Strip the `.opencode/` prefix from a path.
- * Used when installing globally: files from `.opencode/skills/...`
- * go directly to `skills/...` in the global dir.
- */
-function stripDotOpencode(path) {
-  if (path.startsWith('.opencode/')) {
-    return path.slice('.opencode/'.length);
-  }
-  return path;
-}
-
 /**
  * Rewrite template opencode.json paths for global install:
- *   .opencode/skills/...  →  skills/...
- *   .opencode/instructions/...  →  instructions/...
- *   .opencode/prompts/agents/...  →  prompts/agents/...
+ *   .opencode/skills/...  →  /abs/path/to/opencodeHome/skills/...
+ *   .opencode/instructions/...  →  /abs/path/to/opencodeHome/instructions/...
+ *   .opencode/prompts/agents/...  →  /abs/path/to/opencodeHome/prompts/agents/...
+ *
+ * Absolute paths are REQUIRED so OpenCode can find the files regardless
+ * of which project directory the user is currently in.
+ *
+ * @param {object} config - Parsed template opencode.json
+ * @param {string} opencodeHome - Absolute path to ~/.config/opencode/
+ * @returns {object} Config with paths rewritten to absolute
  */
-function rewriteTemplatePathsForGlobal(config) {
+function rewriteTemplatePathsForGlobal(config, opencodeHome) {
   const rewritten = JSON.parse(JSON.stringify(config));
 
+  function toGlobalPath(p) {
+    if (p.startsWith('.opencode/')) {
+      return join(opencodeHome, p.slice('.opencode/'.length));
+    }
+    return p;
+  }
+
   // Rewrite instructions
   if (Array.isArray(rewritten.instructions)) {
-    rewritten.instructions = rewritten.instructions.map((p) => stripDotOpencode(p));
+    rewritten.instructions = rewritten.instructions.map((p) => toGlobalPath(p));
   }
 
   // Rewrite agent prompt file paths
   if (rewritten.agent) {
     for (const [, agentConfig] of Object.entries(rewritten.agent)) {
       if (agentConfig.file) {
-        agentConfig.file = stripDotOpencode(agentConfig.file);
+        agentConfig.file = toGlobalPath(agentConfig.file);
       }
     }
   }
@@ -269,7 +271,7 @@ async function installGlobal(options) {
   const templateConfig = JSON.parse(readFileSync(templateConfigPath, 'utf-8'));
 
   // Rewrite paths for flat structure
-  const kitConfig = rewriteTemplatePathsForGlobal(templateConfig);
+  const kitConfig = rewriteTemplatePathsForGlobal(templateConfig, opencodeHome);
 
   // Read existing user config (JSONC or JSON)
   let userConfig = {};

bin/migrations/001_initial_setup.mjs

@@ -1,6 +1,6 @@
 /**
  * Migration 001: Initial Setup
- * Version: 1.3.6
+ * Version: 1.3.7
  *
  * Establishes the migration system foundation:
  * - Ensures .kit-version file exists in target .opencode/
@@ -20,7 +20,7 @@
  * @param {object} opts.path - Node path module
  */
 export default {
-  version: '1.3.6',
+  version: '1.3.7',
   description:
     'Initialize migration system — establish .kit-version tracking and validate config structure',
 
@@ -36,7 +36,7 @@ export default {
     // Ensure .kit-version file exists
     const versionFile = path.join(opencodeDir, '.kit-version');
     if (!fs.existsSync(versionFile)) {
-      fs.writeFileSync(versionFile, '1.3.6\n', 'utf-8');
+      fs.writeFileSync(versionFile, '1.3.7\n', 'utf-8');
     }
 
     // Validate config has agent and permission fields

bin/migrations/manifest.json

@@ -1,6 +1,6 @@
 {
   "001_initial_setup.mjs": {
-    "version": "1.3.6",
+    "version": "1.3.7",
     "description": "Initialize migration system — establish .kit-version tracking and validate config structure"
   }
 }

index.html

@@ -2897,24 +2897,34 @@ <h2>33 agents, <span class="text-primary">ready to deploy</span></h2>
       <div class="container">
         <div class="section-header reveal">
           <div class="section-tag">Install</div>
-          <h2>One command, <span class="text-primary">any way you want</span></h2>
-          <p class="section-sub">Install per-project or globally &mdash; OpenCode auto-detects both. Node.js 18+ required.</p>
+          <h2>One command, <span class="text-primary">any way you
+              want</span></h2>
+          <p class="section-sub">Install per-project or globally &mdash;
+            OpenCode auto-detects both. Node.js 18+ required.</p>
         </div>
 
         <div class="install-tabs reveal">
           <div class="install-tab-bar">
-            <button class="install-tab install-tab-active" data-tab="global" onclick="switchInstallTab('global')">
-              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
+            <button class="install-tab install-tab-active" data-tab="global"
+              onclick="switchInstallTab('global')">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none"
+                stroke="currentColor" stroke-width="2"><circle cx="12" cy="12"
+                  r="10" /><line x1="2" y1="12" x2="22" y2="12" /><path
+                  d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z" /></svg>
               Global Install <span class="install-badge">Recommended</span>
             </button>
-            <button class="install-tab" data-tab="project" onclick="switchInstallTab('project')">
-              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
+            <button class="install-tab" data-tab="project"
+              onclick="switchInstallTab('project')">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none"
+                stroke="currentColor" stroke-width="2"><path
+                  d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z" /></svg>
               Per-Project
             </button>
           </div>
 
           <!-- Global Install Tab -->
-          <div class="install-tab-content install-tab-content-active" id="tab-global">
+          <div class="install-tab-content install-tab-content-active"
+            id="tab-global">
             <div class="code-block">
               <div class="code-block-header">
                 <div class="code-dots" aria-hidden="true">
@@ -2925,16 +2935,32 @@ <h2>One command, <span class="text-primary">any way you want</span></h2>
                 <span class="code-block-title">terminal — global install</span>
               </div>
               <div class="code-block-body code-block-body-multi">
-                <div class="code-line"><span class="code-prompt">$</span> <span class="code-command">npx opencode-agent-kit init --global</span></div>
-                <div class="code-line code-output"><span style="color: var(--text-muted)">  → OpenCode home: ~/.config/opencode/</span></div>
-                <div class="code-line code-output"><span style="color: var(--text-muted)">  → Copying skills, prompts, commands...</span></div>
-                <div class="code-line code-output"><span style="color: var(--success)">  ✓</span> <span style="color: var(--text-muted)">Dependencies installed</span></div>
-                <div class="code-line code-output"><span style="color: var(--success)">  ✓</span> <span style="color: var(--text-muted)">agentmemory ready</span></div>
-                <div class="code-line code-output code-highlight"><span style="color: var(--success)">  ✅</span> <span style="color: var(--text-primary)">opencode-agent-kit v1.3.6 installed globally!</span></div>
+                <div class="code-line"><span class="code-prompt">$</span> <span
+                    class="code-command">npx opencode-agent-kit init
+                    --global</span></div>
+                <div class="code-line code-output"><span
+                    style="color: var(--text-muted)"> → OpenCode home:
+                    ~/.config/opencode/</span></div>
+                <div class="code-line code-output"><span
+                    style="color: var(--text-muted)"> → Copying skills, prompts,
+                    commands...</span></div>
+                <div class="code-line code-output"><span
+                    style="color: var(--success)"> ✓</span> <span
+                    style="color: var(--text-muted)">Dependencies
+                    installed</span></div>
+                <div class="code-line code-output"><span
+                    style="color: var(--success)"> ✓</span> <span
+                    style="color: var(--text-muted)">agentmemory
+                    ready</span></div>
+                <div class="code-line code-output code-highlight"><span
+                    style="color: var(--success)"> ✅</span> <span
+                    style="color: var(--text-primary)">opencode-agent-kit v1.3.7
+                    installed globally!</span></div>
               </div>
             </div>
             <p class="install-footnote">
-              Install once. Use in every project. OpenCode auto-detects it at <code>~/.config/opencode/</code>
+              Install once. Use in every project. OpenCode auto-detects it at
+              <code>~/.config/opencode/</code>
             </p>
             <div class="install-sub-commands">
               <code>opencode-agent-kit global status</code>
@@ -2960,13 +2986,16 @@ <h2>One command, <span class="text-primary">any way you want</span></h2>
               </div>
             </div>
             <p class="install-footnote">
-              73 files created &middot; 33 agents online &middot; 207 skills loaded
+              73 files created &middot; 33 agents online &middot; 207 skills
+              loaded
             </p>
           </div>
 
           <div class="install-actions">
-            <a href="https://github.com/defuj/opencode-agent-kit" class="btn btn-primary btn-lg">Install Now</a>
-            <a href="https://npmjs.com/package/opencode-agent-kit" class="btn btn-secondary btn-lg">npm</a>
+            <a href="https://github.com/defuj/opencode-agent-kit"
+              class="btn btn-primary btn-lg">Install Now</a>
+            <a href="https://npmjs.com/package/opencode-agent-kit"
+              class="btn btn-secondary btn-lg">npm</a>
           </div>
         </div>
       </div>
@@ -3331,7 +3360,7 @@ <h5 class="footer-col-title">Resources</h5>
               delay: 3200,
             },
             {
-              text: '<span style="color: var(--success)">  ✅</span> <span style="color: var(--text-primary)">opencode-agent-kit v1.3.6 installed globally</span>',
+              text: '<span style="color: var(--success)">  ✅</span> <span style="color: var(--text-primary)">opencode-agent-kit v1.3.7 installed globally</span>',
               delay: 4000,
             },
           ];
@@ -3372,7 +3401,7 @@ <h5 class="footer-col-title">Resources</h5>
           } else {
             // Show final state for reduced motion
             termBody.innerHTML =
-              '<span class="terminal-preview-prompt">$</span> npx opencode-agent-kit init --global<br><span style="color: var(--success)">  ✅</span> <span style="color: var(--text-primary)">opencode-agent-kit v1.3.6 installed globally</span>';
+              '<span class="terminal-preview-prompt">$</span> npx opencode-agent-kit init --global<br><span style="color: var(--success)">  ✅</span> <span style="color: var(--text-primary)">opencode-agent-kit v1.3.7 installed globally</span>';
           }
         }
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Multi-stack OpenCode agent toolkit — 33+ specialized AI agents, 200+ skills, 46 commands, 8 MCP servers (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube, and more)",
   "type": "module",
   "bin": {

session.md

@@ -0,0 +1,26 @@
+Session Integrasi agentmemory ke agent-kit
+Continue opencode -s ses_15b104ae4ffe93tXxFPr9KQcYK
+
+hermes --resume 20260609_145707_9e68e7
+hermes -c "Professional OpenCode Agent Kit Upgrade"
+
+Session Mode light/dark default perangkat di index.html
+Continue opencode -s ses_149dafdefffenfo4c28tcjTi8Y
+
+Session Bandingkan kualitas agent-kit dengan branch main
+Continue opencode -s ses_1273c2d0dffeWpxpqj6JxDNCsv
+
+Session Update index.html UI/UX & informasi agent-kit
+Continue opencode -s ses_126fc00c8ffeyllthYrq4HswgA
+
+Session Delegasi langsung ke subagent spesifik
+Continue opencode -s ses_12005cc10ffeyW4EVvY1caVSxp
+
+Session Review kesalahan landing page & improvement plan
+Continue opencode -s ses_11c0e198cffe83yVLy4s1khTO3
+
+Session Jalankan opencode serve otomatis
+Continue opencode -s ses_116025598ffeVM22JN7XT8Nuqu
+
+Session Agent loop dev run preview screenshot fix opencode
+Continue opencode -s ses_10e766e4fffesfscbOI5XAKltu