@cleocode/adapters 2026.4.88 → 2026.4.92

package/dist/providers/claude-code/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAiCvB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoBjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAiCvB"}

package/dist/providers/codex/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAajG;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}

package/dist/providers/cursor/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAajG;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/providers/opencode/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CA8B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAajG;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CA8B9B"}

package/dist/providers/opencode/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA+CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA+ExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAkB3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA+CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA+ExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

package/dist/providers/pi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBjG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CA+B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiCjG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CA+B9B"}

package/dist/providers/shared/paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Path utilities for adapter install providers.
+ *
+ * These helpers mirror the equivalent functions in `@cleocode/core/paths`
+ * but are duplicated here to avoid a circular dependency
+ * (`@cleocode/core` → `@cleocode/adapters` → `@cleocode/core`).
+ *
+ * @remarks
+ * Keep the implementation in sync with `getCleoTemplatesTildePath` in
+ * `packages/core/src/paths.ts` if the logic ever changes.
+ *
+ * @task T916
+ */
+/**
+ * Get the CLEO templates directory as a tilde-prefixed path for use in
+ * `@` references (AGENTS.md, CLAUDE.md, etc.). Cross-platform: replaces
+ * the user's home directory with `~` so the reference works when loaded
+ * by LLM providers that resolve `~` at runtime.
+ *
+ * @returns Tilde-prefixed path like `"~/.local/share/cleo/templates"` on Linux,
+ *   `"~/Library/Application Support/cleo/templates"` on macOS, etc.
+ *
+ * @example
+ * ```typescript
+ * const ref = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+ * // "@~/.local/share/cleo/templates/CLEO-INJECTION.md"  (Linux)
+ * ```
+ *
+ * @task T916
+ */
+export declare function getCleoTemplatesTildePath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/providers/shared/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwCH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CASlD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.4.88",
+  "version": "2026.4.92",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -14,8 +14,8 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.2.108",
     "@openai/agents": "0.8.3",
-    "@cleocode/caamp": "2026.4.88",
-    "@cleocode/contracts": "2026.4.88"
+    "@cleocode/caamp": "2026.4.92",
+    "@cleocode/contracts": "2026.4.92"
   },
   "license": "MIT",
   "engines": {

package/src/__tests__/claude-code-adapter.test.ts

@@ -168,7 +168,8 @@ describe('ClaudeCodeInstallProvider — integration', () => {
   it('creates CLAUDE.md with @-references', async () => {
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
@@ -180,18 +181,22 @@ describe('ClaudeCodeInstallProvider — integration', () => {
     const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
     expect(content).toContain('# Project');
     expect(content).toContain('@AGENTS.md');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
   it('does not duplicate existing references', async () => {
-    const existing = '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n';
+    // Pre-seed with the dynamically-resolved reference so dedup logic fires
+    const { getCleoTemplatesTildePath } = await import('../providers/shared/paths.js');
+    const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+    const existing = `${injectionRef}\n@.cleo/memory-bridge.md\n`;
     writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
 
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
     // Should not have duplicated lines
-    const injectionCount = content.split('@~/.cleo/templates/CLEO-INJECTION.md').length - 1;
+    const injectionCount = (content.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
     expect(injectionCount).toBe(1);
   });
 

package/src/__tests__/cursor-adapter.test.ts

@@ -156,7 +156,8 @@ describe('CursorInstallProvider — integration', () => {
 
     const content = readFileSync(mdcPath, 'utf-8');
     expect(content).toContain('alwaysApply: true');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
@@ -190,7 +191,8 @@ describe('CursorInstallProvider — integration', () => {
     const content = readFileSync(legacyPath, 'utf-8');
     expect(content).toContain('# Project Rules');
     expect(content).toContain('Use TypeScript.');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
@@ -201,16 +203,15 @@ describe('CursorInstallProvider — integration', () => {
 
   it('does not duplicate references in legacy .cursorrules', async () => {
     const legacyPath = join(testDir, '.cursorrules');
-    writeFileSync(
-      legacyPath,
-      '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n',
-      'utf-8',
-    );
+    // Pre-seed with the dynamically-resolved reference so dedup logic fires
+    const { getCleoTemplatesTildePath } = await import('../providers/shared/paths.js');
+    const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+    writeFileSync(legacyPath, `${injectionRef}\n@.cleo/memory-bridge.md\n`, 'utf-8');
 
     await install.ensureInstructionReferences(testDir);
 
     const content = readFileSync(legacyPath, 'utf-8');
-    const injectionCount = content.split('@~/.cleo/templates/CLEO-INJECTION.md').length - 1;
+    const injectionCount = (content.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
     expect(injectionCount).toBe(1);
   });
 

package/src/__tests__/opencode-adapter.test.ts

@@ -202,7 +202,8 @@ describe('OpenCodeInstallProvider — integration', () => {
   it('creates AGENTS.md with @-references', async () => {
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
@@ -213,17 +214,21 @@ describe('OpenCodeInstallProvider — integration', () => {
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
     expect(content).toContain('# Project Agents');
-    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
+    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
   it('does not duplicate existing references', async () => {
-    const existing = '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n';
+    // Pre-seed with the dynamically-resolved reference so dedup logic fires
+    const { getCleoTemplatesTildePath } = await import('../providers/shared/paths.js');
+    const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+    const existing = `${injectionRef}\n@.cleo/memory-bridge.md\n`;
     writeFileSync(join(testDir, 'AGENTS.md'), existing, 'utf-8');
 
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
-    const injectionCount = content.split('@~/.cleo/templates/CLEO-INJECTION.md').length - 1;
+    const injectionCount = (content.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
     expect(injectionCount).toBe(1);
   });
 

package/src/providers/claude-code/install.ts

@@ -22,9 +22,17 @@ import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/** Lines that should appear in CLAUDE.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Lines that should appear in CLAUDE.md to reference CLEO.
+ * The CLEO-INJECTION.md path is resolved dynamically to support non-default
+ * XDG / OS installation locations (T916).
+ */
+const INSTRUCTION_REFERENCES = [
+  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+  '@.cleo/memory-bridge.md',
+];
 
 /** Resolve the commands directory bundled with this adapter. */
 function getAdapterCommandsDir(): string {

package/src/providers/codex/install.ts

@@ -11,9 +11,17 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Lines that should appear in AGENTS.md to reference CLEO.
+ * The CLEO-INJECTION.md path is resolved dynamically to support non-default
+ * XDG / OS installation locations (T916).
+ */
+const INSTRUCTION_REFERENCES = [
+  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+  '@.cleo/memory-bridge.md',
+];
 
 /**
  * Install provider for Codex CLI.

package/src/providers/cursor/install.ts

@@ -17,9 +17,17 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/** Lines that should appear in instruction files to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Lines that should appear in instruction files to reference CLEO.
+ * The CLEO-INJECTION.md path is resolved dynamically to support non-default
+ * XDG / OS installation locations (T916).
+ */
+const INSTRUCTION_REFERENCES = [
+  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+  '@.cleo/memory-bridge.md',
+];
 
 /**
  * Install provider for Cursor.

package/src/providers/opencode/install.ts

@@ -10,9 +10,17 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Lines that should appear in AGENTS.md to reference CLEO.
+ * The CLEO-INJECTION.md path is resolved dynamically to support non-default
+ * XDG / OS installation locations (T916).
+ */
+const INSTRUCTION_REFERENCES = [
+  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+  '@.cleo/memory-bridge.md',
+];
 
 /**
  * Install provider for OpenCode.

package/src/providers/opencode/spawn.ts

@@ -16,6 +16,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { promisify } from 'node:util';
 import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
 const execAsync = promisify(exec);
 
@@ -95,7 +96,7 @@ async function ensureSubagentDefinition(
       'You are a CLEO subagent executing a delegated task.',
       'Follow the CLEO protocol and complete the assigned work.',
       '',
-      '@~/.cleo/templates/CLEO-INJECTION.md',
+      `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
     ].join('\n');
 
   const content = buildOpenCodeAgentMarkdown(description, instructions);

package/src/providers/pi/install.ts

@@ -19,9 +19,17 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Lines that should appear in AGENTS.md to reference CLEO.
+ * The CLEO-INJECTION.md path is resolved dynamically to support non-default
+ * XDG / OS installation locations (T916).
+ */
+const INSTRUCTION_REFERENCES = [
+  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+  '@.cleo/memory-bridge.md',
+];
 
 /**
  * Resolve the Pi global state root directory.

package/src/providers/shared/paths.ts

@@ -0,0 +1,79 @@
+/**
+ * Path utilities for adapter install providers.
+ *
+ * These helpers mirror the equivalent functions in `@cleocode/core/paths`
+ * but are duplicated here to avoid a circular dependency
+ * (`@cleocode/core` → `@cleocode/adapters` → `@cleocode/core`).
+ *
+ * @remarks
+ * Keep the implementation in sync with `getCleoTemplatesTildePath` in
+ * `packages/core/src/paths.ts` if the logic ever changes.
+ *
+ * @task T916
+ */
+
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/**
+ * Resolve the XDG / OS-appropriate global CLEO data directory.
+ *
+ * Respects `CLEO_HOME` env var; otherwise uses the platform default:
+ * - Linux:   `~/.local/share/cleo`
+ * - macOS:   `~/Library/Application Support/cleo`
+ * - Windows: `%LOCALAPPDATA%\cleo\Data` (approximate)
+ *
+ * @returns Absolute path to the CLEO data directory
+ *
+ * @internal
+ */
+function getAdapterCleoHome(): string {
+  if (process.env['CLEO_HOME']) {
+    return process.env['CLEO_HOME'];
+  }
+  const home = homedir();
+  if (process.platform === 'darwin') {
+    return join(home, 'Library', 'Application Support', 'cleo');
+  }
+  if (process.platform === 'win32') {
+    const localAppData = process.env['LOCALAPPDATA'];
+    if (localAppData) {
+      return join(localAppData, 'cleo', 'Data');
+    }
+    return join(home, 'AppData', 'Local', 'cleo', 'Data');
+  }
+  // Linux / XDG
+  const xdgData = process.env['XDG_DATA_HOME'];
+  if (xdgData) {
+    return join(xdgData, 'cleo');
+  }
+  return join(home, '.local', 'share', 'cleo');
+}
+
+/**
+ * Get the CLEO templates directory as a tilde-prefixed path for use in
+ * `@` references (AGENTS.md, CLAUDE.md, etc.). Cross-platform: replaces
+ * the user's home directory with `~` so the reference works when loaded
+ * by LLM providers that resolve `~` at runtime.
+ *
+ * @returns Tilde-prefixed path like `"~/.local/share/cleo/templates"` on Linux,
+ *   `"~/Library/Application Support/cleo/templates"` on macOS, etc.
+ *
+ * @example
+ * ```typescript
+ * const ref = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+ * // "@~/.local/share/cleo/templates/CLEO-INJECTION.md"  (Linux)
+ * ```
+ *
+ * @task T916
+ */
+export function getCleoTemplatesTildePath(): string {
+  const absPath = join(getAdapterCleoHome(), 'templates');
+  const home = homedir();
+  if (absPath.startsWith(home)) {
+    // Always use forward slash after tilde for cross-platform @-reference resolution
+    const relative = absPath.slice(home.length).replace(/\\/g, '/');
+    return `~${relative}`;
+  }
+  return absPath;
+}