@ghl-ai/aw 0.1.49 → 0.1.50-beta.1

package/c4/templates/scripts/aw-c4-bootstrap.sh

@@ -12,9 +12,9 @@
 #   - .codex/scripts/codex-web-bootstrap.sh    (passes --harness codex-web)
 #
 # Override knobs (env):
-#   AW_PACKAGE   npm spec to install. Defaults to @ghl-ai/aw@0.1.49-beta.0.
-#                Override with @ghl-ai/aw@latest for the stable channel or pin
-#                to another @ghl-ai/aw@0.1.x for reproducible CI runs.
+#   AW_PACKAGE   npm spec to install. Defaults to @ghl-ai/aw@latest.
+#                Override to pin a specific @ghl-ai/aw@0.1.x for reproducible
+#                CI runs.
 set -Eeuo pipefail
 
 # GitHub auth is resolved inside `aw c4` so GITHUB_PAT, GITHUB_TOKEN, and
@@ -106,7 +106,7 @@ if [ -f "$ENVOY_CA" ] && [ -z "${NODE_EXTRA_CA_CERTS:-}" ]; then
   echo "[aw-c4-bootstrap] enabled NODE_EXTRA_CA_CERTS=$ENVOY_CA"
 fi
 
-AW_PACKAGE="${AW_PACKAGE:-@ghl-ai/aw@0.1.49-beta.0}"
+AW_PACKAGE="${AW_PACKAGE:-@ghl-ai/aw@latest}"
 
 echo "[aw-c4-bootstrap] installing ${AW_PACKAGE}"
 npm install -g "${AW_PACKAGE}"

package/cli.mjs

@@ -89,9 +89,11 @@ function printHelp() {
     sec('Setup'),
     cmd('aw init', 'Initialize workspace (auto-installs suggested integrations)'),
     cmd('aw init --namespace <team/sub-team>', 'Add a team namespace (optional)'),
+    cmd('aw init skills <path...>', 'Initialize/link only specific skill folders'),
     cmd('aw init --no-integrations', 'Skip integration setup (Codex, Caveman, Graphify, etc)'),
     `  ${chalk.dim('Teams: platform, revex, mobile, commerce, leadgen, crm, marketplace, ai')}`,
     `  ${chalk.dim('Example: aw init --namespace revex/courses')}`,
+    `  ${chalk.dim('Example: aw init skills platform/core/skills/pr-review')}`,
     cmd('aw init-repo', 'Scaffold cloud-bootstrap files (idempotent, --dry-run/--force/--diff)'),
 
     sec('Download'),
@@ -152,6 +154,7 @@ function printHelp() {
     cmd('aw pull <team>/agents', 'All agents from a team'),
     cmd('aw pull <team>/agents/<name>', 'One specific agent'),
     cmd('aw pull <team>/skills/<name>', 'One specific skill folder'),
+    cmd('aw init skills <team>/<path>/skills/<name>', 'Install and link only selected skill symlinks'),
     '',
     `  ${chalk.dim('# Push your local changes to registry')}`,
     cmd('aw push', 'Push all modified files (one PR)'),

package/commands/c4.mjs

@@ -350,10 +350,10 @@ export async function c4Command(rawArgs, overrides = {}) {
     return exit(0);
   }
 
-  // Step 6 — npm install -g @ghl-ai/aw@0.1.49-beta.0.
-  const npmRes = spawnSync('npm', ['install', '-g', '@ghl-ai/aw@0.1.49-beta.0'], { stdio: 'pipe' });
+  // Step 6 — npm install -g @ghl-ai/aw@latest.
+  const npmRes = spawnSync('npm', ['install', '-g', '@ghl-ai/aw@latest'], { stdio: 'pipe' });
   if (npmRes && npmRes.status !== 0) {
-    writer.stderr('[aw-c4] npm install -g @ghl-ai/aw@0.1.49-beta.0 failed (non-fatal); using existing aw if present\n');
+    writer.stderr('[aw-c4] npm install -g @ghl-ai/aw@latest failed (non-fatal); using existing aw if present\n');
   }
 
   // Step 7 — aw init --silent.

package/commands/init.mjs

@@ -23,7 +23,7 @@ import * as p from '@clack/prompts';
 import * as config from '../config.mjs';
 import * as fmt from '../fmt.mjs';
 import { chalk, setSilent } from '../fmt.mjs';
-import { linkWorkspace } from '../link.mjs';
+import { linkWorkspace, linkSkills, normalizeSkillTarget } from '../link.mjs';
 import { generateCommands, copyInstructions, initAwDocs, syncHomeHarnessInstructions } from '../integrate.mjs';
 import { setupMcp } from '../mcp.mjs';
 import { applyStoredStartupPreferences, ensureAwRuntimeHook } from '../startup.mjs';
@@ -40,6 +40,7 @@ import {
   isValidClone,
   fetchAndMerge,
   addToSparseCheckout,
+  setSparseCheckout,
   addProjectWorktree,
   isWorktree,
   includeToSparsePaths,
@@ -108,6 +109,56 @@ function scaffoldNamespace(awHome, folderName) {
   }
 }
 
+function getSkillInitSpecs(args) {
+  const positional = args._positional || [];
+  const mode = positional[0];
+  const rawTargets = [];
+
+  if (mode === 'skill' || mode === 'skills') {
+    rawTargets.push(...positional.slice(1));
+  }
+
+  if (args['--skill']) {
+    rawTargets.push(args['--skill']);
+  }
+
+  if ((mode === 'skill' || mode === 'skills' || args['--skill']) && rawTargets.length === 0) {
+    fmt.cancel(`Missing skill path.\n\n  ${chalk.dim('Example:')} ${chalk.bold('aw init skills platform/core/skills/pr-review')}`);
+  }
+
+  if (rawTargets.length === 0) return [];
+
+  try {
+    return [...new Map(rawTargets.map(input => {
+      const spec = normalizeSkillTarget(input);
+      return [spec.registryPath, spec];
+    })).values()];
+  } catch (e) {
+    fmt.cancel(e.message);
+  }
+}
+
+function skillInitSparsePaths(skillSpecs) {
+  const paths = new Set([
+    DOCS_SOURCE_DIR,
+    AW_DOCS_DIR,
+    RULES_SOURCE_DIR,
+    `${REGISTRY_DIR}/AW-PROTOCOL.md`,
+    `CODEOWNERS`,
+  ]);
+
+  for (const spec of skillSpecs) {
+    paths.add(`${REGISTRY_DIR}/${spec.registryPath}`);
+
+    for (let i = 0; i <= spec.segments.length; i++) {
+      const scope = [spec.namespace, ...spec.segments.slice(0, i)].join('/');
+      paths.add(`${REGISTRY_DIR}/${scope}/references`);
+    }
+  }
+
+  return [...paths];
+}
+
 // ── Ensure ~/.aw/.git/info/exclude has the whitelist block ─────────────
 //
 // Strategy: only .aw_registry/, .aw_rules/, content/, and .aw_docs/ are
@@ -215,6 +266,14 @@ export async function initCommand(args) {
   let user = args['--user'] || '';
   const silent = args['--silent'] === true;
   const skipIntegrations = args['--no-integrations'] === true;
+  const skillSpecs = getSkillInitSpecs(args);
+  const skillTargets = skillSpecs.map(spec => spec.registryPath);
+  const isSkillInit = skillTargets.length > 0;
+  const skillNamespace = skillSpecs[0]?.namespace || null;
+
+  if (isSkillInit && namespace) {
+    fmt.cancel('Use either `aw init skills <path...>` or `aw init --namespace <team/sub-team>`, not both.');
+  }
 
   // In silent mode, suppress ALL fmt output and show a single spinner.
   // setSilent(true) makes every fmt.* call a no-op — internal functions
@@ -323,8 +382,19 @@ export async function initCommand(args) {
   if (isGitNative) {
     const cfg = config.load(GLOBAL_AW_DIR);
 
-    const isNewSubTeam = folderName && cfg && !cfg.include.includes(folderName);
-    if (isNewSubTeam) {
+    const isNewSubTeam = !isSkillInit && folderName && cfg && !cfg.include.includes(folderName);
+
+    if (isSkillInit) {
+      if (!silent) fmt.logStep('Syncing selected skills...');
+      setSparseCheckout(AW_HOME, skillInitSparsePaths(skillSpecs));
+      if (cfg) {
+        config.save(GLOBAL_AW_DIR, {
+          ...cfg,
+          namespace: skillNamespace || cfg.namespace || 'platform',
+          include: skillTargets,
+        });
+      }
+    } else if (isNewSubTeam) {
       if (!silent) fmt.logStep(`Adding sub-team ${chalk.cyan(folderName)}...`);
       const newSparsePaths = [`.aw_registry/${folderName}`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR];
       addToSparseCheckout(AW_HOME, newSparsePaths);
@@ -352,6 +422,7 @@ export async function initCommand(args) {
 
     ensureAwGitignore(AW_HOME);
     const freshCfg = config.load(GLOBAL_AW_DIR);
+    const activeNamespace = skillNamespace || freshCfg?.namespace || team;
     syncRulesTargets(HOME);
     if (cwd !== HOME) {
       syncRulesTargets(cwd);
@@ -374,8 +445,8 @@ export async function initCommand(args) {
     await installAwEcc(cwd, { silent });
 
     ensureAwRuntimeHook(HOME);
-    syncHomeAndProjectInstructions(cwd, freshCfg?.namespace || team);
-    await setupMcp(HOME, freshCfg?.namespace || team, { silent });
+    syncHomeAndProjectInstructions(cwd, activeNamespace);
+    await setupMcp(HOME, activeNamespace, { silent });
     applyStoredStartupPreferences(HOME);
     const removedLegacyStartupFiles = cwd !== HOME ? removeWorkspaceHookDefaults(cwd) : [];
     installGlobalHooks();
@@ -409,10 +480,12 @@ export async function initCommand(args) {
     if (!silent) fmt.logStep('Wiring IDE symlinks...');
     const projectRegistryDir = cwd !== HOME ? join(cwd, '.aw', REGISTRY_DIR) : null;
     const awDirForLinks = (projectRegistryDir && existsSync(projectRegistryDir)) ? projectRegistryDir : null;
-    const symlinks = linkWorkspace(HOME, awDirForLinks, { silent: true });
-    const commands = generateCommands(HOME, { silent: true });
+    const symlinks = isSkillInit
+      ? linkSkills(HOME, skillTargets, awDirForLinks, { silent: true, exclusive: true })
+      : linkWorkspace(HOME, awDirForLinks, { silent: true });
+    const commands = isSkillInit ? 0 : generateCommands(HOME, { silent: true });
     if (cwd !== HOME) installLocalCommitHook(cwd);
-    if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} symlinks · ${chalk.bold(commands)} commands`);
+    if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
 
     // Write hook manifest after all hook installation is complete
     try { writeHookManifest({ eccVersion: AW_ECC_TAG, awVersion: VERSION }); } catch { /* best effort */ }
@@ -420,7 +493,7 @@ export async function initCommand(args) {
     // Auto-install suggested integrations (Codex, Caveman, Graphify, etc) - unless --no-integrations
     let installedIntegrations = [];
     if (!silent && !skipIntegrations && !isNewSubTeam) {
-      installedIntegrations = await autoInstallIntegrations(freshCfg?.namespace || team, { silent });
+      installedIntegrations = await autoInstallIntegrations(activeNamespace, { silent });
     }
 
     if (silent) {
@@ -431,7 +504,7 @@ export async function initCommand(args) {
         `⟁  ${isNewSubTeam ? `Sub-team ${chalk.cyan(folderName)} added` : 'Up to date'}`,
         '',
         `  ${chalk.green('✓')} Registry synced`,
-        `  ${chalk.green('✓')} IDE refreshed — ${chalk.bold(symlinks)} symlinks · ${chalk.bold(commands)} commands`,
+        `  ${chalk.green('✓')} IDE refreshed — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`,
         removedLegacyStartupFiles.length > 0
           ? `  ${chalk.green('✓')} Removed ${removedLegacyStartupFiles.length} legacy repo startup file${removedLegacyStartupFiles.length > 1 ? 's' : ''}`
           : null,
@@ -465,13 +538,17 @@ export async function initCommand(args) {
   }
 
   // Determine sparse paths
-  const sparsePaths = [`.aw_registry/platform`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR, `.aw_registry/AW-PROTOCOL.md`, `CODEOWNERS`];
-  if (folderName) {
+  const sparsePaths = isSkillInit
+    ? skillInitSparsePaths(skillSpecs)
+    : [`.aw_registry/platform`, DOCS_SOURCE_DIR, AW_DOCS_DIR, RULES_SOURCE_DIR, `.aw_registry/AW-PROTOCOL.md`, `CODEOWNERS`];
+  if (!isSkillInit && folderName) {
     sparsePaths.push(`.aw_registry/${folderName}`);
   }
 
   fmt.note([
-    folderName ? `${chalk.dim('namespace:')}  ${folderName}` : `${chalk.dim('namespace:')}  ${chalk.dim('none')}`,
+    isSkillInit
+      ? `${chalk.dim('skills:')}     ${skillTargets.join(', ')}`
+      : (folderName ? `${chalk.dim('namespace:')}  ${folderName}` : `${chalk.dim('namespace:')}  ${chalk.dim('none')}`),
     user ? `${chalk.dim('user:')}       ${user}` : null,
     `${chalk.dim('version:')}    v${VERSION}`,
   ].filter(Boolean).join('\n'), 'Config');
@@ -511,8 +588,11 @@ export async function initCommand(args) {
   }
 
   // Create sync config — default to 'platform' when no namespace specified
-  const cfg = config.create(GLOBAL_AW_DIR, { namespace: team || 'platform', user });
-  if (folderName) {
+  const activeNamespace = skillNamespace || team || 'platform';
+  const cfg = config.create(GLOBAL_AW_DIR, { namespace: activeNamespace, user });
+  if (isSkillInit) {
+    for (const target of skillTargets) config.addPattern(GLOBAL_AW_DIR, target);
+  } else if (folderName) {
     config.addPattern(GLOBAL_AW_DIR, folderName);
     scaffoldNamespace(AW_HOME, folderName);
   }
@@ -533,8 +613,8 @@ export async function initCommand(args) {
 
   // Parallel batch B: post-ECC setup (instructions and MCP are independent)
   const [, mcpFiles] = await Promise.all([
-    Promise.resolve(syncHomeAndProjectInstructions(cwd, team)),
-    setupMcp(HOME, team, { silent }),
+    Promise.resolve(syncHomeAndProjectInstructions(cwd, activeNamespace)),
+    setupMcp(HOME, activeNamespace, { silent }),
   ]);
   // applyStoredStartupPreferences reads settings written by ECC — keep after batch B
   applyStoredStartupPreferences(HOME);
@@ -572,11 +652,13 @@ export async function initCommand(args) {
   const awDirForLinks = (projectRegistryDir && existsSync(projectRegistryDir)) ? projectRegistryDir : null;
   // Parallel batch C: symlinks + commands are independent
   if (cwd !== HOME) installLocalCommitHook(cwd);
-  const [symlinks, commands] = [
-    linkWorkspace(HOME, awDirForLinks, { silent: true }),
-    generateCommands(HOME, { silent: true }),
-  ];
-  if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} symlinks · ${chalk.bold(commands)} commands`);
+  const [symlinks, commands] = isSkillInit
+    ? [linkSkills(HOME, skillTargets, awDirForLinks, { silent: true, exclusive: true }), 0]
+    : [
+        linkWorkspace(HOME, awDirForLinks, { silent: true }),
+        generateCommands(HOME, { silent: true }),
+      ];
+  if (!silent) fmt.logStep(`IDE wired — ${chalk.bold(symlinks)} ${isSkillInit ? 'targeted symlinks' : 'symlinks'} · ${chalk.bold(commands)} commands`);
 
   // Write hook manifest after all hook installation is complete
   try { writeHookManifest({ eccVersion: AW_ECC_TAG, awVersion: VERSION }); } catch { /* best effort */ }
@@ -587,7 +669,7 @@ export async function initCommand(args) {
   // Auto-install suggested integrations (Codex, Caveman, Graphify, etc) - unless --no-integrations
   let installedIntegrations = [];
   if (!silent && !skipIntegrations) {
-    installedIntegrations = await autoInstallIntegrations(team, { silent });
+    installedIntegrations = await autoInstallIntegrations(activeNamespace, { silent });
   }
 
   // Offer to update if a newer version is available

package/ecc.mjs

@@ -12,7 +12,7 @@ import { applyStoredStartupPreferences } from "./startup.mjs";
 
 const AW_ECC_REPO_SSH = "git@github.com:shreyansh-ghl/aw-ecc.git";
 const AW_ECC_REPO_HTTPS = "https://github.com/shreyansh-ghl/aw-ecc.git";
-export const AW_ECC_TAG = "v1.4.55";
+export const AW_ECC_TAG = "v1.4.61";
 
 const MARKETPLACE_NAME = "aw-marketplace";
 const PLUGIN_KEY = `aw@${MARKETPLACE_NAME}`;

package/git.mjs

@@ -251,6 +251,19 @@ export function addToSparseCheckout(awHome, newPaths) {
   }
 }
 
+/**
+ * Replace the current sparse checkout with an exact path set.
+ */
+export function setSparseCheckout(awHome, sparsePaths) {
+  try {
+    execSync('git sparse-checkout init --no-cone', { cwd: awHome, stdio: 'pipe' });
+    execSync(`git sparse-checkout set ${sparsePaths.map(p => `"${p}"`).join(' ')}`, { cwd: awHome, stdio: 'pipe' });
+    execSync(`git checkout ${REGISTRY_BASE_BRANCH}`, { cwd: awHome, stdio: 'pipe' });
+  } catch (e) {
+    throw new Error(`Failed to set sparse checkout: ${e.message}`);
+  }
+}
+
 /**
  * Mirror the main clone's sparse-checkout paths into a project worktree.
  * The worktree stays on its own branch — only the checked-out file set is updated.

package/link.mjs

@@ -16,6 +16,11 @@ const IDE_DIRS = ['.claude', '.cursor', '.codex'];
 const FILE_TYPES = ['agents'];
 const ALL_KNOWN_TYPES = new Set([...FILE_TYPES, 'skills', 'commands', 'evals', 'references', 'docs']);
 
+function realHomeDir() {
+  const rawHome = homedir();
+  try { return realpathSync(rawHome); } catch { return rawHome; }
+}
+
 /**
  * List namespace directories inside .aw_registry/ (skip dotfiles).
  */
@@ -77,7 +82,7 @@ function cleanIdeSymlinks(cwd) {
     cleanSymlinksRecursive(ideDir);
   }
   // Also clean .agents/skills/ (global only — Codex reads from ~/.agents/skills/)
-  const HOME = homedir();
+  const HOME = realHomeDir();
   if (cwd === HOME) {
     const agentsSkillsDir = join(cwd, '.agents', 'skills');
     if (existsSync(agentsSkillsDir)) cleanSymlinksRecursive(agentsSkillsDir);
@@ -120,6 +125,156 @@ function flatName(ns, name) {
   return `${ns}-${name}`;
 }
 
+function stripRegistryPrefix(input) {
+  return String(input || '')
+    .trim()
+    .replace(/\\/g, '/')
+    .replace(/\/SKILL\.md$/i, '')
+    .replace(/^.*?\.aw_registry\//, '')
+    .replace(/^\.\/+/, '')
+    .replace(/\/+$/, '');
+}
+
+export function normalizeSkillTarget(input) {
+  const normalized = stripRegistryPrefix(input);
+  const parts = normalized.split('/').filter(Boolean);
+  const skillIndex = parts.indexOf('skills');
+
+  if (skillIndex < 1 || skillIndex === parts.length - 1) {
+    throw new Error(`Skill target must look like <team>/<path>/skills/<name>: ${input}`);
+  }
+
+  if (parts.length !== skillIndex + 2) {
+    throw new Error(`Skill target must point at a skill folder, not a nested file: ${input}`);
+  }
+
+  const namespace = parts[0];
+  const segments = parts.slice(1, skillIndex);
+  const skill = parts[skillIndex + 1];
+  const registryPath = [namespace, ...segments, 'skills', skill].join('/');
+  const flat = [namespace, ...segments, skill].join('-');
+  return { namespace, segments, skill, registryPath, flat };
+}
+
+function cleanSkillSymlinks(cwd) {
+  for (const ide of IDE_DIRS) {
+    const skillsDir = join(cwd, ide, 'skills');
+    if (existsSync(skillsDir)) cleanSymlinksRecursive(skillsDir);
+    const referencesDir = join(cwd, ide, 'references');
+    if (existsSync(referencesDir)) cleanSymlinksRecursive(referencesDir);
+  }
+
+  if (cwd === realHomeDir()) {
+    const agentsSkillsDir = join(cwd, '.agents', 'skills');
+    if (existsSync(agentsSkillsDir)) cleanSymlinksRecursive(agentsSkillsDir);
+    const agentsReferencesDir = join(cwd, '.agents', 'references');
+    if (existsSync(agentsReferencesDir)) cleanSymlinksRecursive(agentsReferencesDir);
+  }
+}
+
+function linkOneSkill(cwd, awDir, target) {
+  const skillDir = join(awDir, target.namespace, ...target.segments, 'skills', target.skill);
+  if (!existsSync(skillDir) || !lstatSync(skillDir).isDirectory()) {
+    throw new Error(`Skill not found in registry: ${target.registryPath}`);
+  }
+
+  let created = 0;
+  for (const ide of IDE_DIRS) {
+    const linkDir = join(cwd, ide, 'skills');
+    mkdirSync(linkDir, { recursive: true });
+    const linkPath = join(linkDir, target.flat);
+    const relTarget = relative(linkDir, skillDir);
+    forceSymlink(relTarget, linkPath);
+    created++;
+  }
+
+  if (cwd === realHomeDir()) {
+    const agentsSkillsDir = join(cwd, '.agents', 'skills');
+    mkdirSync(agentsSkillsDir, { recursive: true });
+    const linkPath = join(agentsSkillsDir, target.flat);
+    const relTarget = relative(agentsSkillsDir, skillDir);
+    forceSymlink(relTarget, linkPath);
+    created++;
+  }
+
+  return created;
+}
+
+function linkReferenceFiles(cwd, awDir, namespaces = null) {
+  const allowedNamespaces = namespaces ? new Set(namespaces) : null;
+  const namespacesToLink = listNamespaceDirs(awDir)
+    .filter(ns => !allowedNamespaces || allowedNamespaces.has(ns));
+  let created = 0;
+
+  for (const ns of namespacesToLink) {
+    for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
+      for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
+        const targetPath = join(referencesDir, file);
+        if (lstatSync(targetPath).isDirectory()) continue;
+
+        for (const ide of IDE_DIRS) {
+          const linkDir = join(cwd, ide, 'references');
+          mkdirSync(linkDir, { recursive: true });
+          const linkPath = join(linkDir, file);
+          const relTarget = relative(linkDir, targetPath);
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
+        }
+
+        if (cwd === realHomeDir()) {
+          const agentsReferencesDir = join(cwd, '.agents', 'references');
+          mkdirSync(agentsReferencesDir, { recursive: true });
+          const linkPath = join(agentsReferencesDir, file);
+          const relTarget = relative(agentsReferencesDir, targetPath);
+          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
+        }
+      }
+    }
+  }
+
+  return created;
+}
+
+/**
+ * Create/refresh symlinks for specific skills only.
+ *
+ * Unlike linkWorkspace(), this does not walk every namespace. It can be used
+ * by lean init flows to avoid exposing every registry skill to IDE runtimes.
+ */
+export function linkSkills(cwd, skillTargets, awDirOverride = null, { silent = false, exclusive = false } = {}) {
+  try { cwd = realpathSync(cwd); } catch { /* use as-is */ }
+
+  const GLOBAL_AW_DIR = join(realHomeDir(), '.aw_registry');
+  let awDir = awDirOverride || getLocalRegistryDir(cwd, GLOBAL_AW_DIR);
+  try { awDir = realpathSync(awDir); } catch { /* use as-is if it doesn't exist */ }
+  if (!existsSync(awDir)) return 0;
+
+  const targets = [...new Map(skillTargets.map(input => {
+    const target = normalizeSkillTarget(input);
+    return [target.registryPath, target];
+  })).values()];
+
+  for (const target of targets) {
+    const skillDir = join(awDir, target.namespace, ...target.segments, 'skills', target.skill);
+    if (!existsSync(skillDir) || !lstatSync(skillDir).isDirectory()) {
+      throw new Error(`Skill not found in registry: ${target.registryPath}`);
+    }
+  }
+
+  if (exclusive) cleanSkillSymlinks(cwd);
+
+  let created = 0;
+  for (const target of targets) {
+    created += linkOneSkill(cwd, awDir, target);
+  }
+  created += linkReferenceFiles(cwd, awDir, targets.map(target => target.namespace));
+
+  if (created > 0 && !silent) {
+    fmt.logSuccess(`Linked ${created} targeted symlink${created > 1 ? 's' : ''}`);
+  }
+
+  return created;
+}
+
 /**
  * Create/refresh all IDE symlinks.
  *
@@ -140,7 +295,7 @@ export function linkWorkspace(cwd, awDirOverride = null, { silent = false } = {}
   // where $HOME may be /var/... but process.cwd() resolves to /private/var/...
   try { cwd = realpathSync(cwd); } catch { /* use as-is */ }
 
-  const GLOBAL_AW_DIR = join(homedir(), '.aw_registry');
+  const GLOBAL_AW_DIR = join(realHomeDir(), '.aw_registry');
   let awDir = awDirOverride || getLocalRegistryDir(cwd, GLOBAL_AW_DIR);
   try { awDir = realpathSync(awDir); } catch { /* use as-is if it doesn't exist */ }
   if (!existsSync(awDir)) return 0;
@@ -228,25 +383,10 @@ export function linkWorkspace(cwd, awDirOverride = null, { silent = false } = {}
 
   // Shared references: flatten namespace references into each IDE's references/
   // so links like ../../references/foo.md continue to work from flattened skill dirs.
-  for (const ns of namespaces) {
-    for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
-      for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
-        const targetPath = join(referencesDir, file);
-        if (lstatSync(targetPath).isDirectory()) continue;
-
-        for (const ide of IDE_DIRS) {
-          const linkDir = join(cwd, ide, 'references');
-          mkdirSync(linkDir, { recursive: true });
-          const linkPath = join(linkDir, file);
-          const relTarget = relative(linkDir, targetPath);
-          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
-        }
-      }
-    }
-  }
+  created += linkReferenceFiles(cwd, awDir);
 
   // Codex per-skill symlinks: ~/.agents/skills/<name> (global only)
-  if (cwd === homedir()) {
+  if (cwd === realHomeDir()) {
     const agentsSkillsDir = join(cwd, '.agents/skills');
     for (const ns of namespaces) {
       for (const { typeDirPath: skillsDir, segments } of findNestedTypeDirs(join(awDir, ns), 'skills')) {
@@ -260,20 +400,6 @@ export function linkWorkspace(cwd, awDirOverride = null, { silent = false } = {}
         }
       }
     }
-
-    const agentsReferencesDir = join(cwd, '.agents', 'references');
-    for (const ns of namespaces) {
-      for (const { typeDirPath: referencesDir } of findNestedTypeDirs(join(awDir, ns), 'references')) {
-        mkdirSync(agentsReferencesDir, { recursive: true });
-        for (const file of readdirSync(referencesDir).filter(f => !f.startsWith('.'))) {
-          const targetPath = join(referencesDir, file);
-          if (lstatSync(targetPath).isDirectory()) continue;
-          const linkPath = join(agentsReferencesDir, file);
-          const relTarget = relative(agentsReferencesDir, targetPath);
-          try { forceSymlink(relTarget, linkPath); created++; } catch { /* best effort */ }
-        }
-      }
-    }
   }
 
   // Commands: per-file symlinks (recursive for nested domain dirs)

package/package.json

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