@oxygen-agent/cli 1.887.5 → 1.888.6

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.887.5
+Version: 1.888.6

package/dist/index.js

@@ -2720,6 +2720,7 @@ export function createProgram() {
                 query,
                 route: serializeCapabilityRoute(inferUserCapabilityRoute(query)),
                 hint: "Hydrate one exact CLI command with `oxygen commands get <exact-command> --json`, or one MCP tool with `oxygen_capabilities_schema`.",
+                alternate_search_hint: `If this route does not fit the outcome, run \`oxygen skills search ${JSON.stringify(query)} --json\` for a narrower operational play.`,
             };
         });
     }))

package/dist/skills.js

@@ -208,6 +208,13 @@ options, runtime = {}) {
     const env = runtime.env ?? process.env;
     const platform = runtime.platform ?? process.platform;
     const spawn = runtime.spawnSync ?? wrapExecFileSync(runtime.execFileSync) ?? spawnSync;
+    const installLocations = resolveSkillInstallLocations(agents, options.project === true, env);
+    // The vendored installer writes immediately once spawned. Tell humans and
+    // agents the exact destination first so a default global install is never a
+    // surprise, while keeping stdout as one stable JSON envelope under --json.
+    process.stderr.write(`note: installing Oxygen skills (${options.project ? "project" : "global"}) into ${installLocations
+        .map((location) => `${location.agent}=${location.path}`)
+        .join(", ")}\n`);
     // A specific shortcut skill can declare prerequisite skills that its SKILL.md
     // invokes (e.g. oxygen-clay-migration → oxygen-gtm, whose recipes it lives in).
     // Installing it alone would leave those missing, so pull them in too. Best-
@@ -304,6 +311,7 @@ options, runtime = {}) {
         skill,
         ...(dependencySkills.length > 0 ? { dependency_skills: dependencySkills } : {}),
         scope: options.project ? "project" : "global",
+        install_locations: installLocations,
         output: outputs.join(""),
         // Truthful counts a caller (human or scripting agent) can trust at a
         // glance: a not-detected agent is never folded into `failed`.
@@ -316,6 +324,23 @@ options, runtime = {}) {
         summary: summarizeInstallOutcome(agents.length, skippedAgents.length, 0),
     };
 }
+function resolveSkillInstallLocations(agents, project, env) {
+    const projectRoots = {
+        codex: resolve(".agents", "skills"),
+        "claude-code": resolve(".claude", "skills"),
+        cursor: resolve(".agents", "skills"),
+    };
+    const globalRoots = {
+        codex: join(env.CODEX_HOME?.trim() || join(homedir(), ".codex"), "skills"),
+        "claude-code": join(env.CLAUDE_CONFIG_DIR?.trim() || join(homedir(), ".claude"), "skills"),
+        cursor: join(homedir(), ".cursor", "skills"),
+    };
+    const roots = project ? projectRoots : globalRoots;
+    return agents.map((agent) => ({
+        agent,
+        path: roots[agent] ?? (project ? resolve(".agents", "skills") : join(homedir(), ".agents", "skills")),
+    }));
+}
 /**
  * Stages the requested skill(s) into `dir` so the installer receives a local
  * filesystem path instead of the org-bound tokenized access URL. Keeping the URL

package/node_modules/@oxygen/shared/dist/version.d.ts

@@ -1,4 +1,4 @@
-export declare const OXYGEN_VERSION = "1.887.5";
+export declare const OXYGEN_VERSION = "1.888.6";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";
 export declare const MANAGED_INBOX_MINIMUM_CLI_VERSION = "1.326.2";
 export declare const SUPPORT_AGENT_REPLY_MINIMUM_CLI_VERSION = "1.747.0";

package/node_modules/@oxygen/shared/dist/version.js

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.887.5";
+export const OXYGEN_VERSION = "1.888.6";
 // The GLOBAL CLI compatibility floor: the oldest CLI allowed to call any
 // operational route. Raising it hard-rejects every older CLI from the entire
 // product, so it obeys one law, enforced by scripts/ci/cli-min-version-gate.mjs:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.887.5",
+  "version": "1.888.6",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",