happyskills 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.14.0] - 2026-03-27
+
+### Added
+- Add multi-agent support — auto-detect and symlink skills to Cursor, Windsurf, Codex, GitHub Copilot, Aider, Cline, and Roo Code alongside Claude Code
+- Add `--agents` flag to `install`, `uninstall`, `update`, `refresh`, and `setup` commands for explicit agent targeting (e.g., `--agents claude,cursor`)
+- Add `HAPPYSKILLS_AGENTS` environment variable for persistent agent preference
+- Add `linked_agents` field to install JSON response showing which secondary agents received symlinks
+- Add `cli/src/agents/` module with agent registry (8 agents), auto-detection via home directory scan, and symlink/copy linker with Windows fallback
+
+## [0.13.1] - 2026-03-24
+
+### Fixed
+- Fix `search --type` filter being silently ignored — the `type` parameter was never forwarded to the API, so `--type kit` and `--type skill` had no effect
+- Fix `whoami` incorrectly labeling all personal-type workspaces as "(personal)" even when the user is only a collaborator — now uses ownership from the API so only workspaces the user owns show "(personal)" or "(organization)"
+
 ## [0.13.0] - 2026-03-12
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.13.0",
+	"version": "0.14.0",
 	"description": "Package manager for AI agent skills",
 	"license": "SEE LICENSE IN LICENSE",
 	"author": "Nicolas Dao <nic@cloudlesslabs.com> (https://cloudlesslabs.com)",

package/src/agents/detector.js

@@ -0,0 +1,99 @@
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+const { error: { catch_errors } } = require('puffy-core')
+const { AGENTS, PRIMARY_AGENT, get_agent } = require('./registry')
+
+const home_dir = os.homedir()
+
+/**
+ * Detect which agents are installed by checking for home-level config folders.
+ * All checks run in parallel via Promise.all.
+ *
+ * @returns {Promise} [errors, Agent[]] — array of detected agent objects
+ */
+const detect_agents = () => catch_errors('Agent detection failed', async () => {
+	const checks = AGENTS.map(async (agent) => {
+		for (const rel_path of agent.detect_paths) {
+			const full_path = path.join(home_dir, rel_path)
+			try {
+				await fs.promises.access(full_path)
+				return agent
+			} catch {
+				// path not found — agent not detected
+			}
+		}
+		return null
+	})
+
+	const results = await Promise.all(checks)
+	return results.filter(Boolean)
+})
+
+/**
+ * Parse a comma-separated agent list and validate each id against the registry.
+ *
+ * @param {string} agents_str — e.g. "claude,cursor,windsurf"
+ * @returns {{ primary: Agent, secondaries: Agent[] }}
+ */
+const _parse_agents_flag = (agents_str) => {
+	const ids = agents_str.split(',').map(s => s.trim()).filter(Boolean)
+	const agents = []
+	const unknown = []
+
+	for (const id of ids) {
+		const agent = get_agent(id)
+		if (agent) agents.push(agent)
+		else unknown.push(id)
+	}
+
+	if (unknown.length > 0) {
+		throw new Error(`Unknown agent(s): ${unknown.join(', ')}. Available: ${AGENTS.map(a => a.id).join(', ')}`)
+	}
+
+	// Ensure primary is always included
+	if (!agents.find(a => a.primary)) {
+		agents.unshift(PRIMARY_AGENT)
+	}
+
+	const primary = agents.find(a => a.primary)
+	const secondaries = agents.filter(a => !a.primary)
+	return { primary, secondaries }
+}
+
+/**
+ * Resolve which agents to target. Priority:
+ *   1. --agents flag (explicit per-command override)
+ *   2. HAPPYSKILLS_AGENTS env var (persistent user preference)
+ *   3. Auto-detection (scan home dir for agent config folders)
+ *
+ * Always includes the primary agent (Claude).
+ *
+ * @param {string|undefined} agents_flag — from --agents CLI flag
+ * @returns {Promise} [errors, { primary: Agent, secondaries: Agent[] }]
+ */
+const resolve_agents = (agents_flag) => catch_errors('Agent resolution failed', async () => {
+	// 1. Explicit --agents flag takes highest priority
+	if (agents_flag) {
+		return _parse_agents_flag(agents_flag)
+	}
+
+	// 2. HAPPYSKILLS_AGENTS env var
+	const env_agents = process.env.HAPPYSKILLS_AGENTS
+	if (env_agents) {
+		return _parse_agents_flag(env_agents)
+	}
+
+	// 3. Auto-detect
+	const [errors, detected] = await detect_agents()
+	if (errors) throw errors[0]
+
+	// Ensure primary is always included
+	const all = detected.find(a => a.primary) ? detected : [PRIMARY_AGENT, ...detected]
+
+	const primary = all.find(a => a.primary)
+	const secondaries = all.filter(a => !a.primary)
+	return { primary, secondaries }
+})
+
+module.exports = { detect_agents, resolve_agents }

package/src/agents/index.js

@@ -0,0 +1,9 @@
+const { AGENTS, PRIMARY_AGENT, get_agent, get_all_agent_ids } = require('./registry')
+const { detect_agents, resolve_agents } = require('./detector')
+const { link_to_agents, unlink_from_agents, is_symlink } = require('./linker')
+
+module.exports = {
+	AGENTS, PRIMARY_AGENT, get_agent, get_all_agent_ids,
+	detect_agents, resolve_agents,
+	link_to_agents, unlink_from_agents, is_symlink
+}

package/src/agents/linker.js

@@ -0,0 +1,137 @@
+const fs = require('fs')
+const path = require('path')
+const { error: { catch_errors } } = require('puffy-core')
+const { agent_skill_install_dir } = require('../config/paths')
+const { ensure_dir, remove_dir } = require('../utils/fs')
+
+/**
+ * Check if a path is a symlink.
+ *
+ * @param {string} target_path
+ * @returns {Promise} [errors, boolean]
+ */
+const is_symlink = (target_path) => catch_errors('Symlink check failed', async () => {
+	try {
+		const stats = await fs.promises.lstat(target_path)
+		return stats.isSymbolicLink()
+	} catch {
+		return false
+	}
+})
+
+/**
+ * Check if a path exists (file, dir, or symlink).
+ *
+ * @param {string} target_path
+ * @returns {Promise<boolean>}
+ */
+const _exists = async (target_path) => {
+	try {
+		await fs.promises.lstat(target_path)
+		return true
+	} catch {
+		return false
+	}
+}
+
+/**
+ * Create a symlink, falling back to a physical copy on failure.
+ *
+ * @param {string} source — absolute path to the primary skill dir
+ * @param {string} target — absolute path to the secondary agent's skill dir
+ * @returns {{ method: string, error?: string }}
+ */
+const _link_or_copy = async (source, target) => {
+	try {
+		// 'junction' works on Windows without admin; ignored on macOS/Linux
+		await fs.promises.symlink(source, target, 'junction')
+		return { method: 'symlink' }
+	} catch (err) {
+		if (err.code === 'EPERM' || err.code === 'ENOTSUP') {
+			// Symlinks not supported — fall back to physical copy
+			await fs.promises.cp(source, target, { recursive: true })
+			return { method: 'copy' }
+		}
+		throw err
+	}
+}
+
+/**
+ * Link a skill to secondary agents. Creates symlinks (or copies as fallback)
+ * from the primary install location to each secondary agent's skills directory.
+ *
+ * @param {string} source_dir — absolute path to the primary skill dir (e.g. .claude/skills/deploy-aws)
+ * @param {Agent[]} secondaries — array of secondary agent objects
+ * @param {object} options — { global, project_root, skill_name }
+ * @returns {Promise} [errors, { agent_id, path, method }[]]
+ */
+const link_to_agents = (source_dir, secondaries, options = {}) => catch_errors('Agent linking failed', async () => {
+	const { global: is_global = false, project_root, skill_name } = options
+	const results = []
+
+	for (const agent of secondaries) {
+		const target = agent_skill_install_dir(agent, is_global, project_root, skill_name)
+
+		// If target already exists and is a symlink pointing to source, skip
+		const [, is_link] = await is_symlink(target)
+		if (is_link) {
+			try {
+				const link_target = await fs.promises.readlink(target)
+				if (link_target === source_dir) {
+					results.push({ agent_id: agent.id, path: target, method: 'symlink', skipped: true })
+					continue
+				}
+			} catch {
+				// readlink failed — remove and recreate
+			}
+		}
+
+		// Remove stale target (dir or broken symlink)
+		if (await _exists(target)) {
+			await remove_dir(target)
+		}
+
+		// Ensure parent dir exists
+		await ensure_dir(path.dirname(target))
+
+		const { method } = await _link_or_copy(source_dir, target)
+		results.push({ agent_id: agent.id, path: target, method })
+	}
+
+	return results
+})
+
+/**
+ * Unlink a skill from secondary agents. Removes symlinks or physical copies.
+ *
+ * @param {string} skill_name — skill directory name (e.g. "deploy-aws")
+ * @param {Agent[]} secondaries — array of secondary agent objects
+ * @param {object} options — { global, project_root }
+ * @returns {Promise} [errors, { agent_id, removed: boolean }[]]
+ */
+const unlink_from_agents = (skill_name, secondaries, options = {}) => catch_errors('Agent unlinking failed', async () => {
+	const { global: is_global = false, project_root } = options
+	const results = []
+
+	for (const agent of secondaries) {
+		const target = agent_skill_install_dir(agent, is_global, project_root, skill_name)
+
+		if (!(await _exists(target))) {
+			results.push({ agent_id: agent.id, removed: false })
+			continue
+		}
+
+		const [, is_link] = await is_symlink(target)
+		if (is_link) {
+			await fs.promises.unlink(target)
+		} else {
+			await remove_dir(target)
+		}
+
+		results.push({ agent_id: agent.id, removed: true })
+	}
+
+	return results
+})
+
+module.exports = { link_to_agents, unlink_from_agents, is_symlink }

package/src/agents/registry.js

@@ -0,0 +1,81 @@
+/**
+ * Agent registry — pure-data definitions for supported AI agents.
+ *
+ * Each entry describes where an agent stores skills and how to detect it.
+ * Adding a new agent = adding one object to the AGENTS array.
+ */
+
+const AGENTS = [
+	{
+		id: 'claude',
+		display_name: 'Claude Code',
+		skills_dir: '.claude/skills',
+		global_skills_dir: '.claude/skills',
+		detect_paths: ['.claude'],
+		primary: true
+	},
+	{
+		id: 'cursor',
+		display_name: 'Cursor',
+		skills_dir: '.cursor/skills',
+		global_skills_dir: '.cursor/skills',
+		detect_paths: ['.cursor'],
+		primary: false
+	},
+	{
+		id: 'windsurf',
+		display_name: 'Windsurf',
+		skills_dir: '.windsurf/skills',
+		global_skills_dir: '.windsurf/skills',
+		detect_paths: ['.windsurf'],
+		primary: false
+	},
+	{
+		id: 'codex',
+		display_name: 'Codex',
+		skills_dir: '.codex/skills',
+		global_skills_dir: '.codex/skills',
+		detect_paths: ['.codex'],
+		primary: false
+	},
+	{
+		id: 'copilot',
+		display_name: 'GitHub Copilot',
+		skills_dir: '.github/skills',
+		global_skills_dir: '.github/skills',
+		detect_paths: ['.github/copilot'],
+		primary: false
+	},
+	{
+		id: 'aider',
+		display_name: 'Aider',
+		skills_dir: '.aider/skills',
+		global_skills_dir: '.aider/skills',
+		detect_paths: ['.aider'],
+		primary: false
+	},
+	{
+		id: 'cline',
+		display_name: 'Cline',
+		skills_dir: '.cline/skills',
+		global_skills_dir: '.cline/skills',
+		detect_paths: ['.cline'],
+		primary: false
+	},
+	{
+		id: 'roo',
+		display_name: 'Roo Code',
+		skills_dir: '.roo/skills',
+		global_skills_dir: '.roo/skills',
+		detect_paths: ['.roo'],
+		primary: false
+	}
+]
+
+const PRIMARY_AGENT = AGENTS.find(a => a.primary)
+
+const get_agent = (id) => AGENTS.find(a => a.id === id) || null
+
+const get_all_agent_ids = () => AGENTS.map(a => a.id)
+
+module.exports = { AGENTS, PRIMARY_AGENT, get_agent, get_all_agent_ids }

package/src/api/repos.js

@@ -9,6 +9,7 @@ const search = (query, options = {}) => catch_errors('Search failed', async () =
 	if (options.scope) params.set('scope', options.scope)
 	if (options.workspace) params.set('workspace', options.workspace)
 	if (options.tags) params.set('tags', options.tags)
+	if (options.type) params.set('type', options.type)
 	const needs_auth = (options.scope && options.scope !== 'public') || options.workspace
 	const [errors, data] = await client.get(`/repos/search?${params}`, { auth: needs_auth || false })
 	if (errors) throw errors[errors.length - 1]

package/src/commands/install.js

@@ -18,12 +18,14 @@ Arguments:
   owner/skill@latest       Force install of the latest version (bypasses lock skip check)
 
 Options:
-  -g, --global      Install globally (~/.claude/skills/)
-  --version <ver>   Pin to specific version (overrides inline @version)
-  --force           Force install on dependency conflicts
-  --fresh           Ignore lock file, re-resolve from scratch
-  -y, --yes         Skip confirmation prompts
-  --json            Output as JSON
+  -g, --global        Install globally (~/.claude/skills/)
+  --version <ver>     Pin to specific version (overrides inline @version)
+  --force             Force install on dependency conflicts
+  --fresh             Ignore lock file, re-resolve from scratch
+  --agents <list>     Target specific agents (comma-separated, e.g., claude,cursor)
+                      Default: auto-detect. Env: HAPPYSKILLS_AGENTS
+  -y, --yes           Skip confirmation prompts
+  --json              Output as JSON
 
 Aliases: i, add
 
@@ -58,6 +60,7 @@ const run = (args) => catch_errors('Install failed', async () => {
 		force: args.flags.force || false,
 		fresh: args.flags.fresh || false,
 		yes: args.flags.yes || false,
+		agents: args.flags.agents || undefined,
 		project_root: find_project_root()
 	}
 

package/src/commands/refresh.js

@@ -126,7 +126,7 @@ const run = (args) => catch_errors('Refresh failed', async () => {
 	}
 
 	// 5. Update outdated skills
-	const options = { global: is_global, fresh: true, project_root }
+	const options = { global: is_global, fresh: true, agents: args.flags.agents || undefined, project_root }
 	const updated = []
 	const update_errors = []
 

package/src/commands/setup.js

@@ -32,6 +32,7 @@ const run = (args) => catch_errors('Setup failed', async () => {
 		global: args.flags.global || false,
 		yes: true,
 		version: 'latest',
+		agents: args.flags.agents || undefined,
 		project_root: find_project_root()
 	}
 

package/src/commands/uninstall.js

@@ -13,9 +13,11 @@ Arguments:
   owner/skill       Skill to remove (e.g., acme/deploy-aws)
 
 Options:
-  -g, --global      Remove from global scope
-  -y, --yes         Skip confirmation prompts
-  --json            Output as JSON
+  -g, --global        Remove from global scope
+  --agents <list>     Target specific agents (comma-separated, e.g., claude,cursor)
+                      Default: auto-detect. Env: HAPPYSKILLS_AGENTS
+  -y, --yes           Skip confirmation prompts
+  --json              Output as JSON
 
 Aliases: rm, remove
 
@@ -40,6 +42,7 @@ const run = (args) => catch_errors('Uninstall failed', async () => {
 
 	const options = {
 		global: args.flags.global || false,
+		agents: args.flags.agents || undefined,
 		project_root: find_project_root()
 	}
 

package/src/commands/update.js

@@ -60,6 +60,7 @@ const run = (args) => catch_errors('Update failed', async () => {
 	const options = {
 		global: is_global,
 		fresh: true,
+		agents: args.flags.agents || undefined,
 		project_root
 	}
 

package/src/commands/whoami.js

@@ -59,7 +59,9 @@ const run = (args) => catch_errors('Whoami failed', async () => {
 		console.log()
 		print_label('Workspaces', '')
 		for (const ws of workspaces) {
-			const type_label = ws.type === 'personal' ? ' (personal)' : ''
+			const type_label = ws.is_owner
+				? ws.type === 'personal' ? ' (personal)' : ' (organization)'
+				: ''
 			console.log(`  ${ws.slug}${type_label}`)
 		}
 	}

package/src/config/paths.js

@@ -36,6 +36,14 @@ const skill_install_dir = (base_skills_dir, name) => path.join(base_skills_dir,
 
 const find_project_root = (start_dir = process.cwd()) => path.resolve(start_dir)
 
+const agent_skills_dir = (agent, global = false, project_root) => {
+	if (global) return path.join(home_dir, agent.global_skills_dir)
+	return path.join(project_root || process.cwd(), agent.skills_dir)
+}
+
+const agent_skill_install_dir = (agent, global, project_root, skill_name) =>
+	path.join(agent_skills_dir(agent, global, project_root), skill_name)
+
 module.exports = {
 	home_dir,
 	config_dir,
@@ -49,5 +57,7 @@ module.exports = {
 	lock_root,
 	lock_file_path,
 	skill_install_dir,
-	find_project_root
+	find_project_root,
+	agent_skills_dir,
+	agent_skill_install_dir
 }

package/src/engine/installer.js

@@ -11,8 +11,9 @@ const { write_lock, update_lock_skills } = require('../lock/writer')
 const { skills_dir, tmp_dir, skill_install_dir, lock_root } = require('../config/paths')
 const { ensure_dir, remove_dir, file_exists, read_json } = require('../utils/fs')
 const { SKILL_JSON } = require('../constants')
+const { resolve_agents, link_to_agents } = require('../agents')
 const { create_spinner } = require('../ui/spinner')
-const { print_success, print_warn } = require('../ui/output')
+const { print_success, print_warn, print_info } = require('../ui/output')
 
 const _format_warnings = (missing_deps) => (missing_deps || []).map(dep => {
 	const hint = dep.install_hint ? ` (install: ${dep.install_hint})` : ''
@@ -20,8 +21,13 @@ const _format_warnings = (missing_deps) => (missing_deps || []).map(dep => {
 })
 
 const install = (skill, options = {}) => catch_errors('Install failed', async () => {
-	const { version, global: is_global = false, force = false, fresh = false, project_root } = options
+	const { version, global: is_global = false, force = false, fresh = false, project_root, agents: agents_flag } = options
 	const base_dir = skills_dir(is_global, project_root)
+
+	// Resolve target agents (primary + secondaries)
+	const [agents_err, agents_result] = await resolve_agents(agents_flag)
+	if (agents_err) throw e('Agent resolution failed', agents_err)
+	const { secondaries } = agents_result
 	const temp_dir = tmp_dir(base_dir)
 	const lock_dir = lock_root(is_global, project_root)
 
@@ -130,6 +136,19 @@ const install = (skill, options = {}) => catch_errors('Install failed', async ()
 			await fs.promises.rename(tmp_path, final_dir)
 		}
 
+		// Link to secondary agents (non-fatal — warnings only)
+		if (secondaries.length > 0) {
+			spinner.update(`Linking to ${secondaries.length} agent(s)...`)
+			for (const { pkg } of downloaded) {
+				const name = pkg.skill.split('/')[1]
+				const source = skill_install_dir(base_dir, name)
+				const [link_errs] = await link_to_agents(source, secondaries, { global: is_global, project_root, skill_name: name })
+				if (link_errs) {
+					print_warn(`Warning: failed to link ${pkg.skill} to some agents`)
+				}
+			}
+		}
+
 		spinner.update('Writing lock file...')
 
 		const updates = {}
@@ -162,6 +181,10 @@ const install = (skill, options = {}) => catch_errors('Install failed', async ()
 
 		spinner.succeed(`Installed ${packages_to_install.length} package(s)`)
 
+		if (secondaries.length > 0) {
+			print_info(`Linked to: ${secondaries.map(a => a.display_name).join(', ')}`)
+		}
+
 		const [, missing_deps] = await check_system_dependencies(packages)
 
 		const forced_pkgs = packages_to_install.filter(p => p.forced)
@@ -178,7 +201,8 @@ const install = (skill, options = {}) => catch_errors('Install failed', async ()
 		const warnings = _format_warnings(missing_deps)
 		const forced = forced_pkgs.map(p => ({ skill: p.skill, version: p.version }))
 
-		return { skill, version: packages[0]?.version, no_op: false, installed, skipped, warnings, forced, packages: packages_to_install.length }
+		const linked_agents = secondaries.map(a => a.id)
+		return { skill, version: packages[0]?.version, no_op: false, installed, skipped, warnings, forced, packages: packages_to_install.length, linked_agents }
 	} catch (err) {
 		await remove_dir(temp_dir)
 		throw err

package/src/engine/uninstaller.js

@@ -3,6 +3,7 @@ const { read_lock, get_locked_skill, get_all_locked_skills } = require('../lock/
 const { write_lock, update_lock_skills } = require('../lock/writer')
 const { skills_dir, skill_install_dir, lock_root } = require('../config/paths')
 const { remove_dir } = require('../utils/fs')
+const { resolve_agents, unlink_from_agents } = require('../agents')
 const { print_success, print_info } = require('../ui/output')
 
 const find_orphans = (skills, removed_skill) => {
@@ -19,7 +20,12 @@ const find_orphans = (skills, removed_skill) => {
 }
 
 const uninstall = (skill, options = {}) => catch_errors('Uninstall failed', async () => {
-	const { global: is_global = false, project_root } = options
+	const { global: is_global = false, project_root, agents: agents_flag } = options
+
+	// Resolve target agents
+	const [agents_err, agents_result] = await resolve_agents(agents_flag)
+	if (agents_err) throw e('Agent resolution failed', agents_err)
+	const { secondaries } = agents_result
 	const base_dir = skills_dir(is_global, project_root)
 	const lock_dir = lock_root(is_global, project_root)
 
@@ -50,6 +56,13 @@ const uninstall = (skill, options = {}) => catch_errors('Uninstall failed', asyn
 		if (rm_errors) throw e(`Failed to remove ${name}`, rm_errors)
 	}
 
+	// Unlink from secondary agents
+	if (secondaries.length > 0) {
+		for (const name of to_remove) {
+			await unlink_from_agents(name.split('/')[1], secondaries, { global: is_global, project_root })
+		}
+	}
+
 	const updates = {}
 	for (const name of to_remove) {
 		updates[name] = null