clavix 5.9.2 → 5.10.1

package/dist/config/integrations.json

@@ -173,6 +173,16 @@
       "rootDir": ".llxprt",
       "type": "standard"
     },
+    {
+      "name": "vibe",
+      "displayName": "Vibe CLI",
+      "directory": ".vibe/skills",
+      "filenamePattern": "clavix-{name}-skill",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".vibe",
+      "type": "standard"
+    },
     {
       "name": "agents-md",
       "displayName": "AGENTS.md",

package/dist/core/adapters/vibe-adapter.d.ts

@@ -0,0 +1,50 @@
+import { BaseAdapter } from './base-adapter.js';
+import { CommandTemplate } from '../../types/agent.js';
+import { ClavixConfig } from '../../types/config.js';
+/**
+ * Vibe CLI agent adapter
+ *
+ * Generates SKILL.md files for Vibe CLI integration.
+ * Each Clavix slash command becomes a separate Vibe skill.
+ *
+ * Skills are generated in ./.vibe/skills/ directory which has
+ * priority over global ~/.vibe/skills/ in Vibe's skill resolution.
+ */
+export declare class VibeAdapter extends BaseAdapter {
+    readonly name = "vibe";
+    readonly displayName = "Vibe CLI";
+    readonly directory = ".vibe/skills";
+    readonly fileExtension = ".md";
+    readonly features: {
+        supportsSubdirectories: boolean;
+    };
+    protected readonly userConfig?: ClavixConfig;
+    constructor(userConfig?: ClavixConfig);
+    /**
+     * Detect if Vibe CLI is available in the project
+     * Checks for .vibe directory
+     */
+    detectProject(): Promise<boolean>;
+    /**
+     * Get command path for Vibe CLI
+     */
+    getCommandPath(): string;
+    /**
+     * Generate target filename for Vibe skill
+     * Format: clavix-{command}-skill.md
+     * Example: clavix-improve-skill.md
+     */
+    getTargetFilename(name: string): string;
+    /**
+     * Determine if a file is a Clavix-generated Vibe skill
+     * Matches pattern: clavix-{command}-skill.md where {command} is at least one char
+     */
+    protected isClavixGeneratedCommand(filename: string): boolean;
+    /**
+     * Format command content for Vibe CLI
+     * SKILL.md files are plain markdown with AI instructions
+     * No special formatting needed - template content is already markdown
+     */
+    protected formatCommand(template: CommandTemplate): string;
+}
+//# sourceMappingURL=vibe-adapter.d.ts.map

package/dist/core/adapters/vibe-adapter.js

@@ -0,0 +1,63 @@
+import { BaseAdapter } from './base-adapter.js';
+import { FileSystem } from '../../utils/file-system.js';
+/**
+ * Vibe CLI agent adapter
+ *
+ * Generates SKILL.md files for Vibe CLI integration.
+ * Each Clavix slash command becomes a separate Vibe skill.
+ *
+ * Skills are generated in ./.vibe/skills/ directory which has
+ * priority over global ~/.vibe/skills/ in Vibe's skill resolution.
+ */
+export class VibeAdapter extends BaseAdapter {
+    name = 'vibe';
+    displayName = 'Vibe CLI';
+    directory = '.vibe/skills';
+    fileExtension = '.md';
+    features = {
+        supportsSubdirectories: false,
+    };
+    userConfig;
+    constructor(userConfig) {
+        super();
+        this.userConfig = userConfig;
+    }
+    /**
+     * Detect if Vibe CLI is available in the project
+     * Checks for .vibe directory
+     */
+    async detectProject() {
+        return await FileSystem.exists('.vibe');
+    }
+    /**
+     * Get command path for Vibe CLI
+     */
+    getCommandPath() {
+        return this.directory;
+    }
+    /**
+     * Generate target filename for Vibe skill
+     * Format: clavix-{command}-skill.md
+     * Example: clavix-improve-skill.md
+     */
+    getTargetFilename(name) {
+        return `clavix-${name}-skill${this.fileExtension}`;
+    }
+    /**
+     * Determine if a file is a Clavix-generated Vibe skill
+     * Matches pattern: clavix-{command}-skill.md where {command} is at least one char
+     */
+    isClavixGeneratedCommand(filename) {
+        return /^clavix-.+-skill\.md$/.test(filename);
+    }
+    /**
+     * Format command content for Vibe CLI
+     * SKILL.md files are plain markdown with AI instructions
+     * No special formatting needed - template content is already markdown
+     */
+    formatCommand(template) {
+        // Return content as-is - SKILL.md is just markdown instructions
+        return template.content;
+    }
+}
+//# sourceMappingURL=vibe-adapter.js.map

package/dist/core/agent-manager.js

@@ -2,6 +2,7 @@ import { ClaudeCodeAdapter } from './adapters/claude-code-adapter.js';
 import { GeminiAdapter } from './adapters/gemini-adapter.js';
 import { QwenAdapter } from './adapters/qwen-adapter.js';
 import { LlxprtAdapter } from './adapters/llxprt-adapter.js';
+import { VibeAdapter } from './adapters/vibe-adapter.js';
 import { UniversalAdapter } from './adapters/universal-adapter.js';
 import { getSimpleAdapters } from './adapter-registry.js';
 import { IntegrationError } from '../types/errors.js';
@@ -23,6 +24,7 @@ export class AgentManager {
         this.registerAdapter(new GeminiAdapter(userConfig)); // TOML format
         this.registerAdapter(new QwenAdapter(userConfig)); // TOML format
         this.registerAdapter(new LlxprtAdapter(userConfig)); // TOML format
+        this.registerAdapter(new VibeAdapter(userConfig)); // Vibe CLI skills
         // Register simple adapters from config (using UniversalAdapter factory)
         for (const config of getSimpleAdapters()) {
             // Skip adapters that have special handlers registered above

package/dist/templates/slash-commands/_canonical/archive.md

@@ -274,7 +274,7 @@ Result: Project permanently deleted
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/implement.md

@@ -524,7 +524,7 @@ I'll explain what's wrong and what you might need to do:
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/improve.md

@@ -524,7 +524,7 @@ Wait for the user to decide what to do next.
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/plan.md

@@ -229,7 +229,7 @@ Present the plan and ask:
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/prd.md

@@ -354,7 +354,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/refine.md

@@ -415,7 +415,7 @@ I'll update the PRD and add this to the refinement history. Confirm?
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/start.md

@@ -230,7 +230,7 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/summarize.md

@@ -409,7 +409,7 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
 
 ---
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_canonical/verify.md

@@ -123,7 +123,7 @@ Implementation: BLOCKED - I'll analyze and report, not modify or fix
 
 ----
 
-## Agent Transparency (v5.9.2)
+## Agent Transparency (v5.10.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/types/agent.d.ts

@@ -40,5 +40,5 @@ export interface ManagedBlock {
     content: string;
     targetFile: string;
 }
-export type AgentType = 'agents-md' | 'amp' | 'augment' | 'claude-code' | 'cline' | 'codex' | 'codebuddy' | 'copilot-instructions' | 'crush' | 'cursor' | 'custom' | 'droid' | 'gemini' | 'kilocode' | 'llxprt' | 'octo-md' | 'opencode' | 'qwen' | 'roocode' | 'windsurf';
+export type AgentType = 'agents-md' | 'amp' | 'augment' | 'claude-code' | 'cline' | 'codex' | 'codebuddy' | 'copilot-instructions' | 'crush' | 'cursor' | 'custom' | 'droid' | 'gemini' | 'kilocode' | 'llxprt' | 'octo-md' | 'opencode' | 'qwen' | 'roocode' | 'vibe' | 'warp-md' | 'windsurf';
 //# sourceMappingURL=agent.d.ts.map

package/dist/utils/integration-selector.js

@@ -30,6 +30,7 @@ export async function selectIntegrations(agentManager, preSelected = []) {
                 { name: 'LLXPRT (~/.llxprt/clavix/)', value: 'llxprt' },
                 { name: 'OpenCode (.opencode/clavix/)', value: 'opencode' },
                 { name: 'Qwen Code (~/.qwen/commands/clavix/)', value: 'qwen' },
+                { name: 'Mistral Vibe (.vibe/skills/)', value: 'vibe' },
                 new inquirer.Separator(),
                 new inquirer.Separator('=== IDE & IDE Extensions ==='),
                 { name: 'Cline (.cline/workflows/)', value: 'cline' },

package/dist/utils/path-resolver.js

@@ -7,6 +7,7 @@
  * 3. Built-in default from integrations.json
  */
 import * as os from 'os';
+import * as path from 'path';
 /**
  * Mapping of integration names to their environment variable names
  *
@@ -29,18 +30,35 @@ export const ENV_VAR_MAP = {
  */
 export function resolveIntegrationPath(config, userConfig) {
     const integrationName = config.name;
+    let resolvedPath;
     // Priority 1: Environment variable
     const envVar = ENV_VAR_MAP[integrationName];
     if (envVar && process.env[envVar]) {
-        return process.env[envVar];
+        resolvedPath = process.env[envVar];
     }
-    // Priority 2: User config override
-    const customPath = userConfig?.experimental?.integrationPaths?.[integrationName];
-    if (customPath && typeof customPath === 'string') {
-        return expandTilde(customPath);
+    else {
+        // Priority 2: User config override
+        const customPath = userConfig?.experimental?.integrationPaths?.[integrationName];
+        if (customPath && typeof customPath === 'string') {
+            resolvedPath = customPath;
+        }
+        else {
+            // Priority 3: Built-in default from config
+            resolvedPath = config.directory;
+        }
     }
-    // Priority 3: Built-in default from config
-    return expandTilde(config.directory);
+    // Codex-specific: ensure /prompts subdirectory exists
+    // When using $CODEX_HOME, the user may set it to the base directory
+    // (e.g., /custom/codex) without the /prompts suffix. We need to
+    // ensure prompts always go into the /prompts subdirectory.
+    if (integrationName === 'codex') {
+        const normalizedPath = path.normalize(resolvedPath);
+        if (!normalizedPath.endsWith(path.join('prompts')) &&
+            !normalizedPath.endsWith(path.sep + 'prompts')) {
+            resolvedPath = path.join(resolvedPath, 'prompts');
+        }
+    }
+    return expandTilde(resolvedPath);
 }
 /**
  * Expands tilde (~) to the user's home directory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.9.2",
+  "version": "5.10.1",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n  /clavix:improve    Optimize prompts with auto-depth\n  /clavix:prd        Generate PRD through questions\n  /clavix:plan       Create task breakdown from PRD\n  /clavix:implement  Execute tasks with progress tracking\n  /clavix:start      Begin conversational session\n  /clavix:summarize  Extract requirements from conversation\n  /clavix:refine     Refine existing PRD or prompt\n  /clavix:verify     Verify implementation against requirements\n  /clavix:archive    Archive completed projects\n\nWorks with Claude Code, Cursor, Windsurf, and 20 AI coding tools.",
   "type": "module",
   "main": "dist/index.js",