@harness-lab/cli 0.1.1 → 0.1.3

package/README.md

@@ -1,9 +1,11 @@
 # Harness CLI
 
-Small facilitator-facing CLI for Harness Lab.
+Small Harness Lab CLI for facilitator auth, workshop operations, and repo-local skill installation.
 
 Current shipped scope:
 
+- `harness version`
+- `harness skill install`
 - `harness auth login`
 - `harness auth logout`
 - `harness auth status`
@@ -16,8 +18,8 @@ Current implementation posture:
 - targets the existing shared dashboard facilitator APIs
 - defaults to a browser/device approval flow backed by dashboard-side facilitator broker sessions
 - keeps `--auth basic` and `--auth neon` as explicit local-dev/bootstrap fallback modes
-- stores session material in macOS Keychain, Windows Credential Manager, or Linux Secret Service by default
-- only uses file storage under `HARNESS_CLI_HOME` or `~/.harness` when `HARNESS_SESSION_STORAGE=file` is set explicitly
+- stores session material in a local file under `HARNESS_CLI_HOME` or `~/.harness` by default
+- supports macOS Keychain, Windows Credential Manager, and Linux Secret Service as explicit `HARNESS_SESSION_STORAGE` overrides
 - supports brokered facilitator commands over the same workshop APIs used by the dashboard
 
 ## Usage
@@ -33,6 +35,7 @@ npm install -g @harness-lab/cli
 Verify the binary:
 
 ```bash
+harness --version
 harness --help
 ```
 
@@ -49,6 +52,21 @@ cd harness-cli
 npm link
 ```
 
+Verify the local install:
+
+```bash
+harness version
+harness --help
+```
+
+Install the repo-local workshop skill bundle for Codex/OpenCode discovery:
+
+```bash
+harness skill install
+```
+
+This creates `.agents/skills/harness-lab-workshop` in the current Harness Lab repo checkout.
+
 Default device/browser login:
 
 ```bash
@@ -81,6 +99,7 @@ Workshop commands:
 
 ```bash
 harness auth status
+harness skill install
 harness workshop status
 harness workshop phase set rotation
 harness workshop archive --notes "Manual archive"
@@ -96,7 +115,7 @@ Environment variables:
 - `HARNESS_FACILITATOR_EMAIL`
 - `HARNESS_FACILITATOR_PASSWORD`
 - `HARNESS_CLI_HOME`
-- `HARNESS_SESSION_STORAGE` (`keychain`, `credential-manager`, `secret-service`, or `file`)
+- `HARNESS_SESSION_STORAGE` (`file`, `keychain`, `credential-manager`, or `secret-service`)
 
 ## Release Gate
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-lab/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Participant-facing Harness Lab CLI for facilitator auth and workshop operations",
   "license": "UNLICENSED",
   "type": "module",

package/src/run-cli.js

@@ -2,6 +2,11 @@ import { getDefaultDashboardUrl } from "./config.js";
 import { createHarnessClient, HarnessApiError } from "./client.js";
 import { prompt, writeLine } from "./io.js";
 import { deleteSession, readSession, sanitizeSession, writeSession, getSessionStorageMode, SessionStoreError } from "./session-store.js";
+import { installWorkshopSkill, SkillInstallError } from "./skill-install.js";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -13,6 +18,14 @@ function parseArgs(argv) {
 
   for (let index = 0; index < argv.length; index += 1) {
     const value = argv[index];
+    if (value === "-h") {
+      flags.help = true;
+      continue;
+    }
+    if (value === "-v") {
+      flags.version = true;
+      continue;
+    }
     if (value.startsWith("--")) {
       const key = value.slice(2);
       const next = argv[index + 1];
@@ -52,14 +65,37 @@ async function readJson(response) {
 
 function printUsage(io) {
   writeLine(io.stdout, "Usage:");
+  writeLine(io.stdout, "  harness --help");
+  writeLine(io.stdout, "  harness --version");
+  writeLine(io.stdout, "  harness version");
   writeLine(io.stdout, "  harness auth login [--auth device|basic|neon] [--dashboard-url URL] [--username USER] [--email EMAIL] [--password PASS] [--no-open]");
   writeLine(io.stdout, "  harness auth logout");
   writeLine(io.stdout, "  harness auth status");
+  writeLine(io.stdout, "  harness skill install [--force]");
   writeLine(io.stdout, "  harness workshop status");
   writeLine(io.stdout, "  harness workshop archive [--notes TEXT]");
   writeLine(io.stdout, "  harness workshop phase set <phase-id>");
 }
 
+function printVersion(io) {
+  writeLine(io.stdout, `harness ${version}`);
+}
+
+async function handleSkillInstall(io, deps, flags) {
+  try {
+    const result = await installWorkshopSkill(deps.cwd ?? process.cwd(), { force: flags.force === true });
+    writeLine(io.stdout, `Installed Harness Lab workshop skill to ${result.installPath}`);
+    writeLine(io.stdout, "Codex and OpenCode should now discover it from this repo via .agents/skills.");
+    return 0;
+  } catch (error) {
+    if (error instanceof SkillInstallError) {
+      writeLine(io.stderr, `Skill install failed: ${error.message}`);
+      return 1;
+    }
+    throw error;
+  }
+}
+
 function formatStorageError(error) {
   if (error instanceof SessionStoreError) {
     return error.message;
@@ -471,11 +507,7 @@ async function handleWorkshopPhaseSet(io, env, positionals, deps) {
 
 export async function runCli(argv, io, deps = {}) {
   const fetchFn = deps.fetchFn ?? globalThis.fetch;
-  if (typeof fetchFn !== "function") {
-    throw new Error("Fetch is required to run the harness CLI.");
-  }
-
-  const mergedDeps = { fetchFn, sleepFn: deps.sleepFn, openUrl: deps.openUrl };
+  const mergedDeps = { fetchFn, sleepFn: deps.sleepFn, openUrl: deps.openUrl, cwd: deps.cwd };
   const { positionals, flags } = parseArgs(argv);
   const [scope, action, subaction] = positionals;
 
@@ -484,11 +516,25 @@ export async function runCli(argv, io, deps = {}) {
     return 0;
   }
 
+  if (flags.version === true) {
+    printVersion(io);
+    return 0;
+  }
+
+  if (scope === "version") {
+    printVersion(io);
+    return 0;
+  }
+
   if (!scope) {
     printUsage(io);
     return 1;
   }
 
+  if (typeof fetchFn !== "function") {
+    throw new Error("Fetch is required to run the harness CLI.");
+  }
+
   if (scope === "auth" && action === "login") {
     return handleAuthLogin(io, io.env, flags, mergedDeps);
   }
@@ -501,6 +547,10 @@ export async function runCli(argv, io, deps = {}) {
     return handleAuthStatus(io, io.env, mergedDeps);
   }
 
+  if (scope === "skill" && action === "install") {
+    return handleSkillInstall(io, mergedDeps, flags);
+  }
+
   if (scope === "workshop" && action === "status") {
     return handleWorkshopStatus(io, io.env, mergedDeps);
   }

package/src/session-store.js

@@ -239,23 +239,7 @@ export function getSessionStorageMode(env) {
   if (requested === "file" || requested === "keychain" || requested === "credential-manager" || requested === "secret-service") {
     return requested;
   }
-
-  if (getDeps().platform === "darwin") {
-    return "keychain";
-  }
-
-  if (getDeps().platform === "win32") {
-    return "credential-manager";
-  }
-
-  if (getDeps().platform === "linux") {
-    return "secret-service";
-  }
-
-  throw new SessionStoreError(
-    "Harness CLI does not know a secure session store for this platform. Set HARNESS_SESSION_STORAGE=file only if you need an explicit insecure fallback.",
-    { code: "unsupported_platform" },
-  );
+  return "file";
 }
 
 function getStorageHint(storage) {

package/src/skill-install.js

@@ -0,0 +1,81 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export class SkillInstallError extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "SkillInstallError";
+    this.code = options.code ?? "skill_install_failed";
+  }
+}
+
+const SKILL_NAME = "harness-lab-workshop";
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function findHarnessLabRepoRoot(startDir) {
+  let currentDir = path.resolve(startDir);
+
+  while (true) {
+    if (await pathExists(path.join(currentDir, "workshop-skill", "SKILL.md"))) {
+      return currentDir;
+    }
+
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+
+    currentDir = parentDir;
+  }
+}
+
+export function getInstalledSkillPath(repoRoot) {
+  return path.join(repoRoot, ".agents", "skills", SKILL_NAME);
+}
+
+export async function installWorkshopSkill(startDir, options = {}) {
+  const repoRoot = await findHarnessLabRepoRoot(startDir);
+  if (!repoRoot) {
+    throw new SkillInstallError(
+      "Harness CLI could not find `workshop-skill/SKILL.md`. Run this command inside a Harness Lab repo checkout.",
+      { code: "repo_not_found" },
+    );
+  }
+
+  const installPath = getInstalledSkillPath(repoRoot);
+  if ((await pathExists(installPath)) && options.force !== true) {
+    throw new SkillInstallError(
+      `Skill already installed at ${installPath}. Re-run with --force to replace it.`,
+      { code: "already_installed" },
+    );
+  }
+
+  if (options.force === true) {
+    await fs.rm(installPath, { recursive: true, force: true });
+  }
+
+  await fs.mkdir(installPath, { recursive: true });
+  await fs.cp(path.join(repoRoot, "workshop-skill"), path.join(installPath, "workshop-skill"), { recursive: true });
+  await fs.cp(path.join(repoRoot, "content"), path.join(installPath, "content"), { recursive: true });
+  await fs.cp(path.join(repoRoot, "workshop-blueprint"), path.join(installPath, "workshop-blueprint"), { recursive: true });
+  await fs.mkdir(path.join(installPath, "docs"), { recursive: true });
+  await fs.copyFile(path.join(repoRoot, "workshop-skill", "SKILL.md"), path.join(installPath, "SKILL.md"));
+  await fs.copyFile(
+    path.join(repoRoot, "docs", "workshop-event-context-contract.md"),
+    path.join(installPath, "docs", "workshop-event-context-contract.md"),
+  );
+  await fs.copyFile(
+    path.join(repoRoot, "docs", "harness-cli-foundation.md"),
+    path.join(installPath, "docs", "harness-cli-foundation.md"),
+  );
+
+  return { repoRoot, installPath, skillName: SKILL_NAME };
+}