@ghl-ai/aw 0.1.76 → 0.1.78

package/commands/mcp.mjs

@@ -78,6 +78,7 @@ function renderStatus() {
     `${chalk.dim('cursor MCP:')} ${formatHealth(status.cursor)}`,
     `${chalk.dim('codex MCP:')} ${formatHealth(status.codex)}`,
     `${chalk.dim('aw-ecc Codex MCP source:')} ${formatHealth(status.eccCodex)}`,
+    ...(status.desktop !== null ? [`${chalk.dim('desktop MCP:')} ${formatHealth(status.desktop)}`] : []),
   ].join('\n'), 'MCP');
 
   fmt.outro('⟁  MCP status complete');

package/hooks/aw-usage/lib/aw-usage-telemetry.js

@@ -101,9 +101,9 @@ function readPackageVersion(pkgPath) {
 
 function getAwCliVersionDetails() {
   if (_awCliVersionDetails) return _awCliVersionDetails;
-  const envVersion = parseVersionString(process.env.AW_VERSION);
+  const envVersion = parseVersionString(process.env.AW_CLI_VERSION);
   if (envVersion) {
-    _awCliVersionDetails = { version: envVersion, source: 'env' };
+    _awCliVersionDetails = { version: envVersion, source: 'aw_cli_version_env' };
     return _awCliVersionDetails;
   }
   try {
@@ -550,6 +550,8 @@ function buildEvent(hookInput, eventType, payload) {
     github_email: git.email || input.user_email || null,
     project_hash: computeProjectHash(cwd),
     aw_version: awCli.version,
+    aw_cli_version: awCli.version,
+    aw_cli_version_source: awCli.source,
     event: eventType,
     client_ts: new Date().toISOString(),
     payload: payload || {},

package/hooks/codex-home.mjs

@@ -26,6 +26,8 @@ const CODEX_HOME_PHASE_BLUEPRINTS = {
         marker: this.scriptMarker,
         phase: 'SessionStart',
         targetCandidates: [
+          '$HOME/.aw/.aw_registry/aw/skills/using-aw-skills/hooks/session-start.sh',
+          '$HOME/.aw_registry/aw/skills/using-aw-skills/hooks/session-start.sh',
           '$HOME/.aw_registry/platform/core/skills/using-aw-skills/hooks/session-start.sh',
           '$HOME/.aw/.aw_registry/platform/core/skills/using-aw-skills/hooks/session-start.sh',
         ],

package/integrations.mjs

@@ -337,10 +337,13 @@ function quoteHookCommandArg(value) {
 }
 
 // Try interpreters in order; return the first that meets minPython, or null.
-async function detectPython({ major, minor }) {
+export async function detectPython({ major, minor }) {
+  // Try versioned candidates first so machines where system python3 is below the
+  // minimum (e.g. macOS ships 3.9 but graphify needs 3.10+) still resolve correctly.
+  const versionedCandidates = ['python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10'];
   const candidates = IS_WINDOWS
     ? ['py -3', 'python', 'python3']
-    : ['python3', 'python'];
+    : [...versionedCandidates, 'python3', 'python'];
 
   for (const cmd of candidates) {
     try {

package/mcp.mjs

@@ -1,4 +1,4 @@
-// mcp.mjs — MCP config generation for Claude Code, Cursor, and Codex (global ~/ configs)
+// mcp.mjs — MCP config generation for Claude Code, Cursor, Codex, and Claude Desktop (global ~/ configs)
 // Uses native Streamable HTTP — no bridge process needed.
 
 import { existsSync, writeFileSync, readFileSync, mkdirSync, renameSync } from 'node:fs';
@@ -82,6 +82,25 @@ function detectPaths() {
   return { ghlMcpUrl };
 }
 
+/**
+ * Return the Claude Desktop config path for the current platform, or null on unsupported platforms.
+ * Claude Desktop does not exist on Linux; return null there to skip silently.
+ *
+ * AW_DESKTOP_CONFIG_PATH env override: forces a specific path regardless of platform.
+ * Used by tests so CI (Linux) can exercise the Desktop write path without a native app.
+ */
+function resolveDesktopConfigPath(homeDir = HOME) {
+  if (process.env.AW_DESKTOP_CONFIG_PATH) return process.env.AW_DESKTOP_CONFIG_PATH;
+  if (process.platform === 'darwin') {
+    return join(homeDir, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  }
+  if (process.platform === 'win32') {
+    const appData = process.env.APPDATA || join(homeDir, 'AppData', 'Roaming');
+    return join(appData, 'Claude', 'claude_desktop_config.json');
+  }
+  return null; // Linux: Claude Desktop not available
+}
+
 function resolveCodexBearerTokenEnvVar() {
   if (process.env[CODEX_MCP_BEARER_TOKEN_ENV]) return CODEX_MCP_BEARER_TOKEN_ENV;
   if (process.env.GITHUB_TOKEN) return 'GITHUB_TOKEN';
@@ -408,6 +427,35 @@ export async function setupMcp(cwd, namespace, { silent = false } = {}) {
   const eccCodexTomlPath = join(HOME, '.aw-ecc', '.codex', 'config.toml');
   mergeTomlMcpServer(eccCodexTomlPath, MCP_SERVER_NAME, ghlAiServerCodex);
 
+  // ── Claude Desktop: platform-specific config ──
+  // Claude Desktop does not support hooks, so using-aw-skills cannot auto-fire.
+  // We add the MCP server so tools are available; a Project system prompt is
+  // required to invoke the router — aw init prints instructions below.
+  const desktopConfigPath = resolveDesktopConfigPath();
+  if (desktopConfigPath) {
+    // Desktop ignores the 'type' field — use url + headers only.
+    const ghlAiServerDesktop = { url: mcpUrl, headers };
+    const desktopUpdated = mergeJsonMcpServer(desktopConfigPath, MCP_SERVER_NAME, ghlAiServerDesktop);
+    if (desktopUpdated) {
+      updatedFiles.push(desktopConfigPath);
+    }
+    if (!silent && (desktopUpdated || existsSync(desktopConfigPath))) {
+      fmt.logInfo('');
+      fmt.logInfo(fmt.chalk.yellow('Claude Desktop requires a Project system prompt to auto-trigger using-aw-skills.'));
+      fmt.logInfo('Claude Desktop has no hook system — MCP tools are available but the router');
+      fmt.logInfo('will not fire automatically unless you add these instructions to your Project:');
+      fmt.logInfo('');
+      fmt.logInfo(fmt.chalk.cyan('  Desktop → Projects → [your project] → Edit instructions → paste:'));
+      fmt.logInfo('');
+      fmt.logInfo('  Before every response, call the ghl-ai knowledge_ask tool');
+      fmt.logInfo('  with skill="using-aw-skills" to load the AW router,');
+      fmt.logInfo('  classify the task, and select the correct route.');
+      fmt.logInfo('');
+      fmt.logInfo('  Restart Claude Desktop to activate the new MCP server.');
+      fmt.logInfo('');
+    }
+  }
+
   // Deduplicate
   const unique = [...new Set(updatedFiles)];
 
@@ -426,12 +474,14 @@ export async function setupMcp(cwd, namespace, { silent = false } = {}) {
  * Called by `aw nuke`. Returns number of files modified.
  */
 export function removeMcpConfig() {
+  const desktopPath = resolveDesktopConfigPath();
   const jsonTargets = [
     join(HOME, '.claude.json'),
     join(HOME, '.cursor', 'mcp.json'),
     join(HOME, '.claude', 'settings.json'),
     join(HOME, '.claude', 'mcp.json'),
     join(HOME, '.mcp.json'),
+    ...(desktopPath ? [desktopPath] : []),
   ];
 
   let removed = 0;
@@ -491,6 +541,7 @@ function tomlMcpHealth(filePath) {
 
 export function getMcpStatus(homeDir = HOME, env = process.env) {
   const prefs = loadMcpPreferences(homeDir);
+  const desktopPath = resolveDesktopConfigPath(homeDir);
   return {
     ...prefs,
     effectiveMode: isMcpEnabled(homeDir, env) ? ENABLED_MODE : DISABLED_MODE,
@@ -501,6 +552,7 @@ export function getMcpStatus(homeDir = HOME, env = process.env) {
     cursor: jsonMcpHealth(join(homeDir, '.cursor', 'mcp.json')),
     codex: tomlMcpHealth(join(homeDir, '.codex', 'config.toml')),
     eccCodex: tomlMcpHealth(join(homeDir, '.aw-ecc', '.codex', 'config.toml')),
+    desktop: desktopPath ? jsonMcpHealth(desktopPath) : null,
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.76",
+  "version": "0.1.78",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {