hngr 0.4.0 → 0.5.0

package/README.md

@@ -47,12 +47,19 @@ hngr skills add team-a/pdf-tools --agent claude-code
 hngr skills add pdf-tools@2026.10.25.1 --agent claude-code
 ```
 
-Non-interactive runs must pass `--agent` (repeatable) or `--all`. In an interactive
-terminal, omitting `--global` first asks whether to install for the current project or
-the user; without a terminal it defaults to the project. Use `--global` to skip the
-question, `--copy` to skip the canonical `.agents/skills` directory, and `--dry-run` to
-preview without writing. Re-running an install replaces the existing target; `--force`
-is not needed.
+The shared `.agents/skills` store is always installed, so every universal agent reads it
+without extra work. In an interactive terminal, omitting `--global` first asks whether to
+install for the current project or the user, then shows a multi-select of the agents that
+need their own directory (`claude-code`, `cline`, `junie` or `kiro-cli`), with an
+`All agents` entry; detected agents are preselected, and pressing Enter with none selected
+installs only `.agents/skills`. Without a terminal, pass `--agent` (repeatable) or `--all`,
+and the scope defaults to the project. Use `--copy` to write copies instead of the
+canonical store plus links, and `--dry-run` to preview without writing. Re-running an
+install replaces the existing target; `--force` is not needed.
+
+Interactive runs end with a borderless summary on stderr (canonical path, universal
+agents, symlinked/copied agents); stdout carries the JSON payload only when piped or when
+`--json` is passed.
 
 ## Publish capabilities
 

package/dist/index.mjs

@@ -5279,7 +5279,7 @@ function isYargsInstance(y) {
 // ../../node_modules/.pnpm/yargs@18.2.0/node_modules/yargs/index.mjs
 const Yargs = YargsFactory(esm_default);
 // package.json
-var version = "0.4.0";
+var version = "0.5.0";
 // src/generated/completion.ts
 function isCompletionShell(value) {
 	return value === "bash" || value === "zsh" || value === "fish";
@@ -6721,6 +6721,13 @@ ${h}
 		}
 	}).prompt();
 };
+const outro = (o = "", t) => {
+	const i = t?.output ?? process.stdout, e = t?.withGuide ?? settings.withGuide ? `${styleText("gray", S_BAR)}
+${styleText("gray", S_BAR_END)}  ` : "";
+	i.write(`${e}${o}
+
+`);
+};
 const password = (e) => new u$1({
 	validate: e.validate,
 	mask: e.mask ?? S_PASSWORD_MASK,
@@ -6898,15 +6905,24 @@ function clackPrompter(streams = {}) {
 				initialValue
 			}));
 		},
-		async multiselect(message, options, initialValues = []) {
+		async multiselect(message, options, initialValues = [], hint) {
+			if (hint) output.write(`${import_picocolors.default.dim(hint)}\n`);
 			return unwrapPrompt(await multiselect({
 				message,
 				input,
 				output,
 				options,
 				initialValues,
-				required: true
+				required: false
 			}));
+		},
+		note(message, title) {
+			output.write(`${import_picocolors.default.green("◇")}  ${title}\n`);
+			output.write(`${import_picocolors.default.dim("│")}\n`);
+			for (const line of message.split("\n")) output.write(`${import_picocolors.default.dim("│")}  ${line}\n`);
+		},
+		outro(message) {
+			outro(message, { output });
 		}
 	};
 }
@@ -6922,7 +6938,7 @@ const GLOBAL_OPTIONS = {
 	json: {
 		type: "boolean",
 		default: false,
-		describe: "Machine mode: errors are single-line JSON on stderr",
+		describe: "Machine mode: print the JSON payload even on a TTY, and errors as JSON",
 		global: true
 	},
 	quiet: {
@@ -7085,7 +7101,7 @@ function buildParser(onMatched) {
 		}), (argv) => {
 			onMatched({
 				argv,
-				run: async (ctx, matchedArgv) => (await import("./skills-CxMeJ5PF.mjs")).add(ctx, matchedArgv)
+				run: async (ctx, matchedArgv) => (await import("./skills-ZFmFyZtw.mjs")).add(ctx, matchedArgv)
 			});
 		});
 		skills.command("publish <paths..>", "Publish a local skill directory as a capability or a new version", (publish) => publish.option("namespace", {
@@ -7113,7 +7129,7 @@ function buildParser(onMatched) {
 		}), (argv) => {
 			onMatched({
 				argv,
-				run: async (ctx, matchedArgv) => (await import("./skills-CxMeJ5PF.mjs")).publish(ctx, matchedArgv)
+				run: async (ctx, matchedArgv) => (await import("./skills-ZFmFyZtw.mjs")).publish(ctx, matchedArgv)
 			});
 		});
 		return skills.demandCommand(1);
@@ -7135,7 +7151,7 @@ function buildParser(onMatched) {
 		}), (argv) => {
 			onMatched({
 				argv,
-				run: async (ctx, matchedArgv) => (await import("./mcp-DWF_ELDU.mjs")).add(ctx, matchedArgv)
+				run: async (ctx, matchedArgv) => (await import("./mcp-B0sbQABp.mjs")).add(ctx, matchedArgv)
 			});
 		});
 		mcp.command("publish <paths..>", "Publish an MCP snapshot as a capability or a new version", (publish) => publish.option("namespace", {
@@ -7163,7 +7179,7 @@ function buildParser(onMatched) {
 		}), (argv) => {
 			onMatched({
 				argv,
-				run: async (ctx, matchedArgv) => (await import("./mcp-DWF_ELDU.mjs")).publish(ctx, matchedArgv)
+				run: async (ctx, matchedArgv) => (await import("./mcp-B0sbQABp.mjs")).publish(ctx, matchedArgv)
 			});
 		});
 		return mcp.demandCommand(1);

package/dist/{mcp-DWF_ELDU.mjs → mcp-B0sbQABp.mjs}

@@ -1,5 +1,5 @@
 import { C as HngrError, g as resolveConnection, s as redactSensitive, t as apiFetch, x as writeFileAtomically } from "./http-DgHX7Fux.mjs";
-import { _ as resolveCapability, a as errorBody, c as runBatch, d as findAgentDefinition, g as parseCapabilityPath, i as runPublish, l as stringValues, m as MCP_KIND, n as explicitName, o as failedResult, p as downloadContent, r as readPublishFlags, s as positionalPaths, t as resolveInstallScope, u as AGENTS, v as resolveCapabilityVersion } from "./scope-Ch6wZCgE.mjs";
+import { _ as resolveCapability, a as errorBody, c as runBatch, d as findAgentDefinition, g as parseCapabilityPath, i as runPublish, l as stringValues, m as MCP_KIND, n as explicitName, o as failedResult, p as downloadContent, r as readPublishFlags, s as positionalPaths, t as resolveInstallScope, u as AGENTS, v as resolveCapabilityVersion } from "./scope-DVfDeQi2.mjs";
 import { constants } from "node:fs";
 import { access, readFile, stat } from "node:fs/promises";
 import { basename, delimiter, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -391,8 +391,6 @@ async function addOne(ctx, connection, parsed, targets, state) {
 	const snapshot = await downloadMcpSnapshot(connection, capability.id, version);
 	if (snapshot.ignoredKeys.length > 0) ctx.summary(`warning: ignoring unsupported top-level keys in the MCP snapshot: ${snapshot.ignoredKeys.join(", ")}`);
 	const serverNames = Object.keys(snapshot.servers);
-	const etag = snapshot.etag ? ` (ETag ${snapshot.etag})` : "";
-	ctx.summary(`resolved ${parsed.namespace}/${parsed.name} to version ${version}${etag}`);
 	if (ctx.flags.dryRun) {
 		const dryTargets = [];
 		let failure = null;
@@ -583,7 +581,7 @@ async function add(ctx, argv) {
 			}
 		}
 	});
-	ctx.writePayload({ results });
+	if (ctx.flags.json || !ctx.io.stdout.isTTY) ctx.writePayload({ results });
 	return failed ? 1 : 0;
 }
 export { add, publish };

package/dist/{scope-Ch6wZCgE.mjs → scope-DVfDeQi2.mjs}

@@ -172,6 +172,10 @@ function claudeConfigDir(env) {
 function xdgConfigDir(env) {
 	return env.XDG_CONFIG_HOME && env.XDG_CONFIG_HOME !== "" ? env.XDG_CONFIG_HOME : join(homeDir(env), ".config");
 }
+/** Pi's agent directory: `PI_CODING_AGENT_DIR` or `~/.pi/agent`. */
+function piAgentDir(env) {
+	return env.PI_CODING_AGENT_DIR && env.PI_CODING_AGENT_DIR !== "" ? env.PI_CODING_AGENT_DIR : join(homeDir(env), ".pi", "agent");
+}
 const universalSkills = {
 	projectDir: null,
 	globalDir: null,
@@ -220,6 +224,15 @@ const AGENTS = [
 			reason: "OpenCode uses a top-level `mcp` object with local/remote entries."
 		}
 	},
+	{
+		id: "pi",
+		skills: universalSkills,
+		mcp: {
+			kind: "json",
+			project: ".pi/mcp.json",
+			global: (env) => join(piAgentDir(env), "mcp.json")
+		}
+	},
 	{
 		id: "amp",
 		skills: universalSkills,
@@ -557,7 +570,7 @@ const SCOPE_OPTIONS = [{
 async function resolveInstallScope(ctx, global) {
 	if (global) return "global";
 	const select = ctx.io.prompts?.select;
-	if (!select || !ctx.io.stdin.isTTY || !ctx.io.stdout.isTTY) return "project";
+	if (!select || ctx.flags.json || !ctx.io.stdin.isTTY || !ctx.io.stdout.isTTY) return "project";
 	return await select("Install scope", SCOPE_OPTIONS, "project") === "global" ? "global" : "project";
 }
 export { resolveCapability as _, errorBody as a, runBatch as c, findAgentDefinition as d, homeDir as f, parseCapabilityPath as g, SKILL_KIND as h, runPublish as i, stringValues as l, MCP_KIND as m, explicitName as n, failedResult as o, downloadContent as p, readPublishFlags as r, positionalPaths as s, resolveInstallScope as t, AGENTS as u, resolveCapabilityVersion as v };

package/dist/{skills-CxMeJ5PF.mjs → skills-ZFmFyZtw.mjs}

@@ -1,5 +1,5 @@
 import { C as HngrError, b as writeDirectoryAtomically, g as resolveConnection, r as apiRequest } from "./http-DgHX7Fux.mjs";
-import { _ as resolveCapability, a as errorBody, c as runBatch, f as homeDir, g as parseCapabilityPath, h as SKILL_KIND, i as runPublish, l as stringValues, n as explicitName, o as failedResult, p as downloadContent, r as readPublishFlags, s as positionalPaths, t as resolveInstallScope, u as AGENTS, v as resolveCapabilityVersion } from "./scope-Ch6wZCgE.mjs";
+import { _ as resolveCapability, a as errorBody, c as runBatch, f as homeDir, g as parseCapabilityPath, h as SKILL_KIND, i as runPublish, l as stringValues, n as explicitName, o as failedResult, p as downloadContent, r as readPublishFlags, s as positionalPaths, t as resolveInstallScope, u as AGENTS, v as resolveCapabilityVersion } from "./scope-DVfDeQi2.mjs";
 import { lstat, mkdir, readFile, readdir, rename, rm, symlink, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { randomUUID } from "node:crypto";
@@ -552,17 +552,19 @@ function failureResult(parsed, err, version) {
 		canonicalPath: null
 	};
 }
-/** Prompts need both stdin and stdout on a TTY plus a prompter that can multi-select. */
+/** Agent prompts need a TTY on both ends, a multi-select prompter, and human output mode. */
 function canPrompt(ctx) {
-	return ctx.io.stdin.isTTY && ctx.io.stdout.isTTY && ctx.io.prompts?.multiselect !== void 0;
+	return !ctx.flags.json && ctx.io.stdin.isTTY && ctx.io.stdout.isTTY && ctx.io.prompts?.multiselect !== void 0;
 }
 function noAgentSelectionError(examplePath, global) {
 	return usage("No agent target selected", `Pass --agent <id> (repeatable) or --all. For example: hngr skills add ${examplePath} --agent claude-code${global ? " --global" : ""}`);
 }
+const ALL_AGENTS = "__all__";
 /**
-* One multi-select for every Agent Target, pre-selecting those whose skills
-* directory is detected. Detection is only a pre-selection hint; a non-TTY
-* invocation never consults the filesystem and must pass --agent or --all.
+* One multi-select for the agents that keep their own skills directory.
+* `.agents` is always installed, so universal agents never appear here.
+* Detection only preselects; a non-TTY invocation never consults the
+* filesystem and must pass --agent or --all.
 */
 async function selectAgents(ctx, argv, examplePath, global) {
 	const requested = stringValues(argv.agent);
@@ -572,26 +574,28 @@ async function selectAgents(ctx, argv, examplePath, global) {
 		return AGENT_TARGETS.filter((agent) => requested.includes(agent.id));
 	}
 	if (argv.all === true) return [...AGENT_TARGETS];
-	if (canPrompt(ctx)) {
-		const multiselect = ctx.io.prompts?.multiselect;
-		if (!multiselect) throw noAgentSelectionError(examplePath, global);
-		const cwd = process.cwd();
-		const choices = [];
-		for (const agent of AGENT_TARGETS) {
-			const dir = targetSkillsDir(agent, cwd, ctx.env, global);
-			choices.push({
-				option: {
-					value: agent.id,
-					label: `${agent.id}  ${displayPath(dir, cwd)}`
-				},
-				detected: await pathExists(dirname(dir))
-			});
-		}
-		const selected = await multiselect("Select agent targets", choices.map((choice) => choice.option), choices.filter((choice) => choice.detected).map((choice) => choice.option.value));
-		if (selected.length === 0) throw noAgentSelectionError(examplePath, global);
-		return AGENT_TARGETS.filter((agent) => selected.includes(agent.id));
+	const multiselect = ctx.io.prompts?.multiselect;
+	if (!canPrompt(ctx) || !multiselect) throw noAgentSelectionError(examplePath, global);
+	const cwd = process.cwd();
+	const linkAgents = AGENT_TARGETS.filter((agent) => agent.link);
+	const options = [{
+		value: ALL_AGENTS,
+		label: "All agents",
+		hint: "select every agent below"
+	}];
+	const initialValues = [];
+	for (const agent of linkAgents) {
+		const dir = targetSkillsDir(agent, cwd, ctx.env, global);
+		options.push({
+			value: agent.id,
+			label: agent.id,
+			hint: displayPath(dir, cwd)
+		});
+		if (await pathExists(dirname(dir))) initialValues.push(agent.id);
 	}
-	throw noAgentSelectionError(examplePath, global);
+	const selected = await multiselect("Install for another agent", options, initialValues, ".agents/skills is always installed; press Enter to skip");
+	const chosen = selected.includes(ALL_AGENTS) ? new Set(linkAgents.map((agent) => agent.id)) : new Set(selected);
+	return linkAgents.filter((agent) => chosen.has(agent.id));
 }
 function frontmatterName(manifest) {
 	const text = manifest.toString("utf8");
@@ -683,6 +687,26 @@ async function install(ctx, plan, entries) {
 		failure
 	};
 }
+function withDot(path) {
+	return path.startsWith("/") ? path : `./${path}`;
+}
+/** The boxed result shown after an interactive install. */
+function installSummary(outcome, canonicalPath) {
+	const lines = [];
+	const installed = outcome.targets.filter((target) => target.status === "installed");
+	if (canonicalPath) {
+		lines.push(`✓ ${withDot(canonicalPath)}`);
+		const universal = AGENT_TARGETS.filter((agent) => !agent.link).map((agent) => agent.id);
+		if (universal.length > 0) lines.push(`  universal: ${universal.join(", ")}`);
+	} else for (const target of installed) lines.push(`✓ ${withDot(target.path)}`);
+	const symlinked = installed.filter((target) => target.mode === "symlink" && target.agent).map((target) => target.agent);
+	const copied = installed.filter((target) => target.mode === "copy" && target.agent).map((target) => target.agent);
+	if (symlinked.length > 0) lines.push(`  symlinked: ${symlinked.join(", ")}`);
+	if (copied.length > 0) lines.push(`  copied: ${copied.join(", ")}`);
+	const failed = outcome.targets.filter((target) => target.status === "failed");
+	if (failed.length > 0) lines.push(`  failed: ${failed.map((target) => target.path).join(", ")}`);
+	return lines.join("\n");
+}
 async function addOne(ctx, connection, parsed, destName, agents, dir, global, copy, state) {
 	const capability = await resolveSkill(connection, parsed);
 	const version = resolveVersion(capability, parsed);
@@ -694,7 +718,9 @@ async function addOne(ctx, connection, parsed, destName, agents, dir, global, co
 	});
 	const canonicalPath = plan.canonical ? displayPath(plan.canonical, process.cwd()) : null;
 	if (ctx.flags.dryRun) {
-		ctx.summary(`resolved ${parsed.namespace}/${parsed.name} to version ${version}`);
+		ctx.detail(`dry-run: would install ${parsed.namespace}/${parsed.name}@${version}`);
+		if (canonicalPath) ctx.detail(`  ${canonicalPath}`);
+		for (const target of plan.targets) ctx.detail(`  ${displayPath(target.path, process.cwd())} (${target.mode})`);
 		return { result: {
 			name: capability.name,
 			namespace: capability.namespace,
@@ -710,19 +736,18 @@ async function addOne(ctx, connection, parsed, destName, agents, dir, global, co
 			error: null
 		} };
 	}
-	const download = await downloadSkillPackage(connection, capability.id, version);
-	const pkg = readSkillPackage(download.bytes);
-	ctx.summary(`resolved ${parsed.namespace}/${parsed.name} to version ${version}`);
+	const pkg = readSkillPackage((await downloadSkillPackage(connection, capability.id, version)).bytes);
 	const declaredName = frontmatterName(pkg.manifest);
 	if (declaredName !== void 0 && declaredName !== destName) ctx.summary(`warning: SKILL.md declares name ${JSON.stringify(declaredName)} but the directory is ${JSON.stringify(destName)}`);
 	const outcome = await install(ctx, plan, pkg.entries);
-	const universal = agents.filter((agent) => !agent.link).map((agent) => agent.id);
-	const etag = download.etag ? ` (ETag ${download.etag})` : "";
-	const verb = outcome.failure ? "partially installed" : "installed";
-	ctx.progress(`${verb} ${capability.namespace}/${capability.name}@${version}${etag}`);
-	if (canonicalPath) ctx.progress(`  canonical ${canonicalPath}`);
-	if (universal.length > 0) ctx.progress(`  universal: ${universal.join(", ")}`);
-	for (const target of outcome.targets) ctx.progress(target.status === "failed" ? `  failed ${target.path}` : `  ${target.mode} ${target.path}`);
+	const verb = outcome.failure ? "Partially installed" : "Installed";
+	const note = ctx.io.prompts?.note;
+	if (!ctx.flags.json && !ctx.flags.quiet && ctx.io.stderr.isTTY && note) note(installSummary(outcome, canonicalPath), `${verb} ${capability.namespace}/${capability.name}@${version}`);
+	else {
+		ctx.progress(`${verb.toLowerCase()} ${capability.namespace}/${capability.name}@${version}`);
+		if (canonicalPath) ctx.progress(`  ${canonicalPath}`);
+		for (const target of outcome.targets) ctx.progress(target.status === "failed" ? `  failed ${target.path}` : `  ${target.path} (${target.mode})`);
+	}
 	return { result: {
 		name: capability.name,
 		namespace: capability.namespace,
@@ -849,7 +874,8 @@ async function add(ctx, argv) {
 		},
 		failure: failureResult
 	});
-	ctx.writePayload({ results });
+	if (ctx.flags.json || !ctx.io.stdout.isTTY) ctx.writePayload({ results });
+	if (!ctx.flags.json && !ctx.flags.dryRun && !ctx.flags.quiet && !failed && ctx.io.stderr.isTTY) ctx.io.prompts?.outro?.("Done! Review skills before use; they run with full agent permissions.");
 	return failed ? 1 : 0;
 }
 export { add, publish };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hngr",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The Hangar CLI: install skills and MCP servers into coding agents, and drive the Management API.",
   "keywords": [
     "hangar",