happyskills 0.4.4 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-03-05
+
+### Added
+- Add `--mine` flag to `search` command to browse skills across all user's workspaces
+- Add `--personal` flag to `search` command to browse skills in the user's personal workspace only
+- Add `-w` / `--workspace <slug>` flag to `search` command to search within specific workspace(s)
+- Add `--tags <tags>` flag to `search` command to filter results by tags
+- Add `scope` and `visibility` fields to `search` JSON output
+
+### Changed
+- Change `search` query argument from required to optional when `--mine`, `--personal`, or `--workspace` is provided (browse mode)
+
 ## [0.4.4] - 2026-03-05
 
 ### Fixed

package/package.json

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

package/src/api/repos.js

@@ -2,10 +2,15 @@ const { error: { catch_errors } } = require('puffy-core')
 const client = require('./client')
 
 const search = (query, options = {}) => catch_errors('Search failed', async () => {
-	const params = new URLSearchParams({ q: query })
+	const params = new URLSearchParams()
+	if (query) params.set('q', query)
 	if (options.limit) params.set('limit', options.limit)
 	if (options.offset) params.set('offset', options.offset)
-	const [errors, data] = await client.get(`/repos/search?${params}`, { auth: false })
+	if (options.scope) params.set('scope', options.scope)
+	if (options.workspace) params.set('workspace', options.workspace)
+	if (options.tags) params.set('tags', options.tags)
+	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]
 	return data
 })

package/src/commands/search.js

@@ -1,24 +1,31 @@
 const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const repos_api = require('../api/repos')
 const { print_help, print_table, print_json, print_info } = require('../ui/output')
-const { exit_with_error, UsageError } = require('../utils/errors')
+const { exit_with_error, UsageError, AuthError } = require('../utils/errors')
 const { EXIT_CODES } = require('../constants')
+const { load_token } = require('../auth/token_store')
 
-const HELP_TEXT = `Usage: happyskills search <query> [options]
+const HELP_TEXT = `Usage: happyskills search [query] [options]
 
 Search the skill registry.
 
 Arguments:
-  query             Search term
+  query               Search term (optional with --mine, --personal, or --workspace)
 
 Options:
-  --json            Output as JSON
+  -w, --workspace <slug>  Search within specific workspace(s) (comma-separated)
+  --mine                  Search across all your workspaces
+  --personal              Search only your personal workspace
+  --tags <tags>           Filter by tags (comma-separated)
+  --json                  Output as JSON
 
 Aliases: s
 
 Examples:
   happyskills search deploy
-  happyskills s aws --json`
+  happyskills search --mine
+  happyskills search deploy --workspace acme
+  happyskills s --personal --json`
 
 const run = (args) => catch_errors('Search failed', async () => {
 	if (args.flags._show_help) {
@@ -26,32 +33,52 @@ const run = (args) => catch_errors('Search failed', async () => {
 		return process.exit(EXIT_CODES.SUCCESS)
 	}
 
-	const query = args._.join(' ')
-	if (!query) {
-		throw new UsageError('Please provide a search query (e.g., happyskills search deploy).')
+	const query = args._.join(' ') || null
+	const { mine, personal, workspace, tags } = args.flags
+	const has_scope_flag = mine || personal || workspace
+
+	if (!query && !has_scope_flag && !tags) {
+		throw new UsageError('Please provide a search query or use --mine, --personal, or --workspace.')
+	}
+
+	const scope = mine ? 'mine' : personal ? 'personal' : undefined
+
+	if (has_scope_flag) {
+		const [, token_data] = await load_token()
+		if (!token_data) {
+			throw new AuthError('Authentication required. Run `happyskills login` first.')
+		}
 	}
 
-	const [errors, results] = await repos_api.search(query)
+	const options = {}
+	if (scope) options.scope = scope
+	if (workspace) options.workspace = workspace
+	if (tags) options.tags = tags
+
+	const [errors, results] = await repos_api.search(query, options)
 	if (errors) throw e('Search failed', errors)
 
 	const items = Array.isArray(results) ? results : (results?.repos || results?.items || [])
+	const effective_scope = scope || (has_scope_flag ? undefined : undefined)
 
 	if (items.length === 0) {
 		if (args.flags.json) {
-			print_json({ data: { query, results: [], count: 0 } })
+			print_json({ data: { query, scope: effective_scope || 'all', results: [], count: 0 } })
 			return
 		}
-		print_info(`No skills found for "${query}".`)
+		const context = query ? ` for "${query}"` : ''
+		print_info(`No skills found${context}.`)
 		return
 	}
 
 	if (args.flags.json) {
-		const results = items.map(item => ({
+		const mapped = items.map(item => ({
 			skill: `${item.owner || item.workspace_slug}/${item.name}`,
 			description: item.description || '',
-			version: item.latest_version || item.version || '-'
+			version: item.latest_version || item.version || '-',
+			visibility: item.visibility || 'public'
 		}))
-		print_json({ data: { query, results, count: results.length } })
+		print_json({ data: { query, scope: effective_scope || 'all', results: mapped, count: mapped.length } })
 		return
 	}
 

package/src/index.js

@@ -62,6 +62,7 @@ const parse_args = (argv) => {
 const SHORT_FLAGS = {
 	g: 'global',
 	y: 'yes',
+	w: 'workspace',
 }
 
 const normalize_flags = (flags) => {