frely-cli 0.6.1 → 0.6.6

package/dist/upgrade/release.js

@@ -0,0 +1,45 @@
+export function stableVersion(value) {
+    if (typeof value !== "string" || !/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u.test(value))
+        throw new Error("Release source did not return a stable version.");
+    return value;
+}
+export function compareVersions(a, b) {
+    const parse = (v) => {
+        const core = v.split("-")[0].split("+")[0];
+        return stableVersion(core).split(".").map(BigInt);
+    };
+    const aa = parse(a), bb = parse(b);
+    for (let i = 0; i < 3; i++)
+        if (aa[i] !== bb[i])
+            return aa[i] > bb[i] ? 1 : -1;
+    return a.includes("-") === b.includes("-") ? 0 : a.includes("-") ? -1 : 1;
+}
+export async function latestRelease(installation, request = fetch) {
+    const standalone = installation.method === "standalone";
+    const response = await request(standalone
+        ? "https://api.github.com/repos/FrelyHQ/frely-cli/releases/latest"
+        : "https://registry.npmjs.org/frely-cli/latest", {
+        headers: { accept: "application/json", "user-agent": "frely-cli" },
+        signal: AbortSignal.timeout(4000), redirect: "error",
+    });
+    if (!response.ok)
+        throw new Error(`Release lookup failed (HTTP ${response.status}).`);
+    const text = await response.text();
+    if (text.length > 1024 * 1024)
+        throw new Error("Release metadata is too large.");
+    const data = JSON.parse(text);
+    if (standalone && (data.draft !== false || data.prerelease !== false))
+        throw new Error("GitHub release is not a stable published release.");
+    const version = stableVersion(standalone ? String(data.tag_name).replace(/^v/u, "") : data.version);
+    if (!standalone && data.name !== "frely-cli")
+        throw new Error("Release package name does not match frely-cli.");
+    return { version, ...(standalone ? { baseUrl: `https://github.com/FrelyHQ/frely-cli/releases/download/v${version}` } : {}) };
+}
+export function standaloneAsset(platform = process.platform, arch = process.arch, target = typeof FRELY_BUILD_TARGET === "string" ? FRELY_BUILD_TARGET : undefined) {
+    // Compiled target includes libc, so an Alpine executable never changes distribution during an upgrade.
+    const value = target ?? `${platform === "win32" ? "windows" : platform}-${arch}`;
+    if (!/^(?:darwin-(?:arm64|x64)|linux-(?:arm64|x64)(?:-musl)?|windows-(?:arm64|x64))$/u.test(value))
+        throw new Error("This platform has no standalone release.");
+    return `frely-${value}${value.startsWith("windows") ? ".exe" : ""}`;
+}
+//# sourceMappingURL=release.js.map

package/dist/upgrade/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/upgrade/release.ts"],"names":[],"mappings":"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"}

package/dist/upgrade/service-refresh.d.ts

@@ -0,0 +1,38 @@
+import { type DiagnosticLog } from "../runtime/diagnostics.js";
+import { type Installation } from "./installation.js";
+import type { MaintenanceGate } from "./maintenance.js";
+export interface InstalledCandidate {
+    fingerprint: string;
+    version: string;
+}
+export interface RefreshProbe {
+    read(): Promise<InstalledCandidate>;
+    verify(candidate: InstalledCandidate): Promise<boolean>;
+}
+/** Inspect only the installation this process already runs; never follow PATH or download code. */
+export declare function installationProbe(installation: Installation): RefreshProbe;
+/** One tick at a time. Busy work keeps its connection and admission; only idle runtimes drain. */
+export declare class ServiceRefresh {
+    private readonly options;
+    private candidate;
+    private checking;
+    private restarting;
+    private deferredFingerprint;
+    constructor(options: {
+        probe: RefreshProbe;
+        gate: MaintenanceGate;
+        signal: AbortSignal;
+        restart: () => void;
+        log?: DiagnosticLog;
+        currentVersion?: string;
+    });
+    check(): Promise<void>;
+}
+/** Only an already-running managed POSIX service watches its supported installation. */
+export declare function watchServiceInstallation(options: {
+    gate: MaintenanceGate;
+    signal: AbortSignal;
+    restart: () => void;
+    log?: DiagnosticLog;
+    onEnabled?: () => void;
+}): Promise<() => void>;

package/dist/upgrade/service-refresh.js

@@ -0,0 +1,138 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { promisify } from "node:util";
+import { VERSION } from "../version.js";
+import { diagnostic } from "../runtime/diagnostics.js";
+import { inspectInstallation } from "./installation.js";
+const execFile = promisify(execFileCallback);
+/** Inspect only the installation this process already runs; never follow PATH or download code. */
+export function installationProbe(installation) {
+    let standaloneCache;
+    const version = async () => {
+        const standalone = installation.method === "standalone";
+        const result = await execFile(standalone ? installation.entry : process.execPath, standalone ? ["--version"] : [installation.entry, "--version"], { cwd: homedir(), timeout: 10000, maxBuffer: 65536 });
+        const value = result.stdout.trim();
+        if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/u.test(value))
+            throw new Error("Invalid installed CLI version.");
+        return value;
+    };
+    const fingerprint = async () => {
+        const files = installation.method === "standalone" ? [installation.entry]
+            : [installation.entry, join(dirname(dirname(installation.entry)), "package.json")];
+        return (await Promise.all(files.map(async (path) => {
+            const info = await stat(path, { bigint: true });
+            if (!info.isFile())
+                throw new Error("Installed CLI file is unavailable.");
+            return [info.dev, info.ino, info.size, info.mtimeNs, info.ctimeNs].join(":");
+        }))).join("|");
+    };
+    return {
+        async read() {
+            const before = await fingerprint();
+            let installed;
+            if (installation.method === "standalone") {
+                if (standaloneCache?.fingerprint === before)
+                    return standaloneCache;
+                installed = await version();
+            }
+            else {
+                const metadata = JSON.parse(await readFile(join(dirname(dirname(installation.entry)), "package.json"), "utf8"));
+                if (metadata.name !== "frely-cli" || typeof metadata.version !== "string")
+                    throw new Error("Installed package is unavailable.");
+                installed = metadata.version;
+            }
+            if (before !== await fingerprint())
+                throw new Error("Installation is changing.");
+            const candidate = { fingerprint: before, version: installed };
+            if (installation.method === "standalone")
+                standaloneCache = candidate;
+            return candidate;
+        },
+        async verify(candidate) {
+            return await fingerprint() === candidate.fingerprint && await version() === candidate.version
+                && await fingerprint() === candidate.fingerprint;
+        },
+    };
+}
+/** One tick at a time. Busy work keeps its connection and admission; only idle runtimes drain. */
+export class ServiceRefresh {
+    options;
+    candidate;
+    checking = false;
+    restarting = false;
+    deferredFingerprint;
+    constructor(options) {
+        this.options = options;
+    }
+    async check() {
+        if (this.checking || this.restarting || this.options.signal.aborted)
+            return;
+        this.checking = true;
+        let paused = false;
+        const { probe, gate, signal, restart, log } = this.options;
+        try {
+            const candidate = await probe.read();
+            if (candidate.version === (this.options.currentVersion ?? VERSION)) {
+                this.candidate = undefined;
+                return;
+            }
+            // Two observations, separated by the polling interval, avoid switching during package extraction.
+            if (this.candidate?.fingerprint !== candidate.fingerprint || this.candidate.version !== candidate.version) {
+                this.candidate = candidate;
+                return;
+            }
+            if (signal.aborted)
+                return;
+            if (!gate.idle) {
+                if (this.deferredFingerprint !== candidate.fingerprint) {
+                    diagnostic(log, "relay.upgrade_deferred");
+                    this.deferredFingerprint = candidate.fingerprint;
+                }
+                return;
+            }
+            // An explicit frely upgrade may already own maintenance. Never resume another owner's gate.
+            try {
+                gate.pause();
+                paused = true;
+            }
+            catch {
+                return;
+            }
+            if (!await probe.verify(candidate) || signal.aborted || !gate.idle)
+                return;
+            diagnostic(log, "relay.upgrade_restart");
+            restart();
+            this.restarting = true;
+            // Keep admission closed while the relay flushes and exits. Its existing supervisor restarts it.
+        }
+        catch {
+            // Missing files and unsuccessful startup are expected during external installation.
+            // Keep the loaded runtime alive and require two fresh observations before retrying.
+            this.candidate = undefined;
+        }
+        finally {
+            if (paused && !this.restarting)
+                gate.resume();
+            this.checking = false;
+        }
+    }
+}
+/** Only an already-running managed POSIX service watches its supported installation. */
+export async function watchServiceInstallation(options) {
+    if (options.signal.aborted || !["darwin", "linux"].includes(process.platform))
+        return () => { };
+    const installation = await inspectInstallation();
+    if (options.signal.aborted || !["standalone", "npm", "bun"].includes(installation.method))
+        return () => { };
+    options.onEnabled?.();
+    const refresh = new ServiceRefresh({ ...options, probe: installationProbe(installation) });
+    const timer = setInterval(() => { void refresh.check(); }, 5000);
+    timer.unref();
+    const close = () => { clearInterval(timer); options.signal.removeEventListener("abort", close); };
+    options.signal.addEventListener("abort", close, { once: true });
+    void refresh.check();
+    return close;
+}
+//# sourceMappingURL=service-refresh.js.map

package/dist/upgrade/service-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-refresh.js","sourceRoot":"","sources":["../../src/upgrade/service-refresh.ts"],"names":[],"mappings":"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"}

package/dist/upgrade/update.d.ts

@@ -0,0 +1,49 @@
+import { readDeviceBinding } from "../device/state.js";
+import { readConnectionStatus } from "../device/connection-status.js";
+import { serviceCommand, serviceStatus, startMcpService, stopMcpService } from "../service.js";
+import { inspectInstallation, type Installation } from "./installation.js";
+import { latestRelease, type Release } from "./release.js";
+import { acquireMaintenance } from "./maintenance.js";
+export interface UpgradeResult {
+    state: "current" | "manual" | "upgraded";
+    message: string;
+}
+export interface UpgradeInspection {
+    currentVersion: string;
+    latestVersion?: string;
+    installation: Installation;
+    state: "unsupported" | "available" | "current" | "unavailable";
+    message: string;
+}
+export declare function inspectUpgrade(): Promise<UpgradeInspection>;
+export declare function installedVersion(installation: Installation): Promise<string>;
+declare function download(url: string, destination: string, maxBytes: number): Promise<void>;
+export declare function validateStandalone(path: string, checksum: string, version: string, execute?: typeof installedVersion): Promise<void>;
+export interface PreparedUpdate {
+    apply(): Promise<void>;
+    restore(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export declare function prepareStandalone(installation: Installation, release: Release, fetchFile?: typeof download, execute?: typeof installedVersion): Promise<PreparedUpdate>;
+declare function installPackage(installation: Installation, version: string): Promise<void>;
+declare function lockInstallation(installation: Installation): Promise<() => Promise<void>>;
+declare const defaults: {
+    inspectInstallation: typeof inspectInstallation;
+    latestRelease: typeof latestRelease;
+    installedVersion: typeof installedVersion;
+    serviceStatus: typeof serviceStatus;
+    serviceCommand: typeof serviceCommand;
+    stopMcpService: typeof stopMcpService;
+    startMcpService: typeof startMcpService;
+    readDeviceBinding: typeof readDeviceBinding;
+    readConnectionStatus: typeof readConnectionStatus;
+    acquireMaintenance: typeof acquireMaintenance;
+    prepareStandalone: typeof prepareStandalone;
+    installPackage: typeof installPackage;
+    lockInstallation: typeof lockInstallation;
+    pause: (ms: number) => Promise<unknown>;
+};
+export type UpgradeDependencies = typeof defaults;
+/** Upgrade in the calling terminal. Busy MCP callers fail before any service stop or package write. */
+export declare function upgrade(write: (message: string) => void, dependencies?: UpgradeDependencies): Promise<UpgradeResult>;
+export {};

package/dist/upgrade/update.js

@@ -0,0 +1,228 @@
+import { createHash } from "node:crypto";
+import { execFile as execFileCallback } from "node:child_process";
+import { chmod, copyFile, lstat, mkdtemp, open, readFile, realpath, rename, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { promisify } from "node:util";
+import { VERSION } from "../version.js";
+import { readDeviceBinding } from "../device/state.js";
+import { connectionIsLive, readConnectionStatus } from "../device/connection-status.js";
+import { serviceCommand, serviceStatus, startMcpService, stopMcpService } from "../service.js";
+import { inspectInstallation, manualUpgradeCommand, packageArguments } from "./installation.js";
+import { compareVersions, latestRelease, standaloneAsset } from "./release.js";
+import { acquireMaintenance } from "./maintenance.js";
+const execFile = promisify(execFileCallback);
+const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function inspectUpgrade() {
+    const installation = await inspectInstallation().catch(() => ({ method: "unknown", entry: process.argv[1] ?? process.execPath, platform: process.platform, reason: "Installation could not be inspected." }));
+    if (installation.method === "unknown" || installation.method === "source") {
+        return { currentVersion: VERSION, installation, state: "unsupported", message: installation.reason };
+    }
+    try {
+        const release = await latestRelease(installation);
+        const available = compareVersions(release.version, VERSION) > 0;
+        return { currentVersion: VERSION, latestVersion: release.version, installation, state: available ? "available" : "current",
+            message: available ? `${VERSION} → ${release.version}. Run frely upgrade.` : `${VERSION} is up to date.` };
+    }
+    catch {
+        return { currentVersion: VERSION, installation, state: "unavailable", message: "Version lookup unavailable. Check connectivity and run frely doctor again." };
+    }
+}
+export async function installedVersion(installation) {
+    const file = installation.method === "standalone" ? installation.entry : process.execPath;
+    const args = installation.method === "standalone" ? ["--version"] : [installation.entry, "--version"];
+    return (await execFile(file, args, { cwd: homedir(), timeout: 10000, maxBuffer: 65536 })).stdout.trim();
+}
+async function download(url, destination, maxBytes) {
+    const signal = AbortSignal.timeout(60000);
+    let response;
+    for (let redirects = 0; redirects < 5; redirects++) {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:" || parsed.username || parsed.password || !["github.com", "release-assets.githubusercontent.com", "objects.githubusercontent.com"].includes(parsed.hostname))
+            throw new Error("Unsupported release download location.");
+        response = await fetch(url, { signal, redirect: "manual" });
+        if ([301, 302, 303, 307, 308].includes(response.status)) {
+            const location = response.headers.get("location");
+            await response.body?.cancel();
+            if (!location)
+                throw new Error("Missing release redirect.");
+            url = new URL(location, url).toString();
+        }
+        else
+            break;
+    }
+    if (!response?.ok || !response.body)
+        throw new Error("Release download failed.");
+    const file = await open(destination, "wx", 0o600);
+    let bytes = 0;
+    try {
+        for await (const chunk of response.body) {
+            bytes += chunk.byteLength;
+            if (bytes > maxBytes)
+                throw new Error("Release download exceeds its size limit.");
+            await file.writeFile(chunk);
+        }
+        await file.sync();
+    }
+    finally {
+        await file.close();
+    }
+}
+export async function validateStandalone(path, checksum, version, execute = installedVersion) {
+    const match = /^([a-fA-F0-9]{64})(?:\s|$)/u.exec(checksum);
+    if (!match)
+        throw new Error("Invalid release checksum.");
+    const hash = createHash("sha256").update(await readFile(path)).digest("hex");
+    if (hash !== match[1].toLowerCase())
+        throw new Error("Release checksum mismatch; the installed executable was not changed.");
+    await chmod(path, 0o755);
+    if (await execute({ method: "standalone", platform: process.platform, entry: path }) !== version)
+        throw new Error("Downloaded executable did not report the target version.");
+}
+export async function prepareStandalone(installation, release, fetchFile = download, execute = installedVersion) {
+    const target = installation.entry;
+    if (!(await lstat(target)).isFile())
+        throw new Error("The installation is not a regular file.");
+    const stage = await mkdtemp(join(dirname(target), ".frely-upgrade-"));
+    const next = join(stage, "frely"), backup = join(stage, "previous");
+    try {
+        const asset = standaloneAsset();
+        await fetchFile(`${release.baseUrl}/${asset}.sha256`, join(stage, "checksum"), 1024);
+        await fetchFile(`${release.baseUrl}/${asset}`, next, 200 * 1024 * 1024);
+        await validateStandalone(next, await readFile(join(stage, "checksum"), "utf8"), release.version, execute);
+        await copyFile(target, backup);
+        return {
+            apply: () => rename(next, target),
+            restore: () => rename(backup, target),
+            cleanup: () => rm(stage, { recursive: true, force: true }),
+        };
+    }
+    catch (error) {
+        await rm(stage, { recursive: true, force: true });
+        throw error;
+    }
+}
+async function installPackage(installation, version) {
+    // Installation failures may contain registry credentials. Expose a bounded generic error instead.
+    try {
+        await execFile(installation.manager, packageArguments(installation, version), { cwd: homedir(), timeout: 180000, maxBuffer: 1024 * 1024 });
+    }
+    catch {
+        throw new Error("The package manager could not update frely-cli. Check its registry, permissions and global installation; no other manager was tried.");
+    }
+}
+async function lockInstallation(installation) {
+    const directory = installation.method === "standalone" ? dirname(installation.entry) : dirname(dirname(dirname(installation.entry)));
+    const path = join(directory, ".frely-upgrade.lock");
+    const file = await open(path, "wx", 0o600).catch(() => { throw new Error(`Cannot acquire upgrade lock: ${path}. Check directory permissions or another upgrade. Remove a stale lock only after confirming no upgrade is running.`); });
+    await file.writeFile(`${process.pid}\n`);
+    return async () => { await file.close(); await rm(path, { force: true }); };
+}
+const defaults = { inspectInstallation, latestRelease, installedVersion, serviceStatus, serviceCommand, stopMcpService, startMcpService,
+    readDeviceBinding, readConnectionStatus, acquireMaintenance, prepareStandalone, installPackage, lockInstallation, pause };
+/** Upgrade in the calling terminal. Busy MCP callers fail before any service stop or package write. */
+export async function upgrade(write, dependencies = defaults) {
+    const d = dependencies, installation = await d.inspectInstallation();
+    if (installation.method === "source" || installation.method === "unknown")
+        throw new Error(installation.reason);
+    const release = await d.latestRelease(installation);
+    if (compareVersions(release.version, VERSION) <= 0)
+        return { state: "current", message: `Frely ${VERSION} is up to date.` };
+    const service = await d.serviceStatus();
+    if (installation.platform === "win32")
+        return { state: "manual", message: `Update ${VERSION} → ${release.version}. Finish any running Frely tasks, then run this command in a local PowerShell terminal:\n\n${manualUpgradeCommand(installation, release.version, service.active)}\n\nAfter installation, run frely doctor. No files or services were changed by frely upgrade.` };
+    if (!["darwin", "linux"].includes(installation.platform))
+        throw new Error("This platform requires a manual update.");
+    if (service.active) {
+        const command = await d.serviceCommand();
+        const entry = command?.[installation.method === "standalone" ? 0 : 1];
+        if (!service.pid || !entry || await realpath(entry).catch(() => entry) !== installation.entry)
+            throw new Error("The running service does not match this installation. Inspect frely doctor -v before upgrading.");
+    }
+    const unlock = await d.lockInstallation(installation);
+    let prepared, releaseMaintenance;
+    let attempted = false, stopped = false, preserveRecovery = false;
+    try {
+        write(`Updating Frely ${VERSION} → ${release.version} (${installation.method}).\n`);
+        prepared = installation.method === "standalone" ? await d.prepareStandalone(installation, release) : {
+            apply: () => d.installPackage(installation, release.version), restore: () => d.installPackage(installation, VERSION), cleanup: async () => { },
+        };
+        // Prepare downloads before pausing admission. A command inside this MCP is itself busy and cannot stop its parent.
+        if (service.active)
+            releaseMaintenance = await d.acquireMaintenance(service.pid);
+        if (service.active) {
+            const current = await d.serviceStatus();
+            if (!current.active || current.pid !== service.pid)
+                throw new Error("The service changed during upgrade preparation. Run frely doctor, then retry.");
+            stopped = true;
+            await d.stopMcpService();
+            for (let i = 0; i < 30 && (await d.serviceStatus()).active; i++)
+                await d.pause(100);
+            if ((await d.serviceStatus()).active)
+                throw new Error("The service did not stop; the installation was not changed.");
+        }
+        attempted = true;
+        await prepared.apply();
+        if (await d.installedVersion(installation) !== release.version)
+            throw new Error("Installed executable did not report the target version.");
+        attempted = false; // Installation verified. Service/network failures must not revert a working binary.
+        if (stopped) {
+            await d.startMcpService();
+            const binding = await d.readDeviceBinding();
+            let started = false, connected = false;
+            for (let i = 0; i < 40; i++) {
+                const active = await d.serviceStatus();
+                const observation = binding ? await d.readConnectionStatus(binding) : null;
+                if (active.active && observation && observation.pid === active.pid && observation.cliVersion === release.version && observation.entry === installation.entry) {
+                    started = true;
+                    connected = connectionIsLive(observation);
+                    if (connected)
+                        break;
+                }
+                await d.pause(250);
+            }
+            if (!started) {
+                // Authentication/network can prevent ensureDevice and its reporter. Keep a verified installed binary.
+                return { state: "upgraded", message: `Frely ${release.version} is installed. A service restart was requested, but its new runtime could not be verified. Run frely doctor -v.` };
+            }
+            return { state: "upgraded", message: `Frely ${release.version} is installed; the service is using the new version. ${connected ? "Relay connection verified." : "Relay connection is not yet verified. Run frely doctor."}` };
+        }
+        return { state: "upgraded", message: `Frely ${release.version} is installed. The background service remains ${service.installed ? "stopped" : "uninstalled"}.` };
+    }
+    catch (error) {
+        let recovery = "";
+        if (attempted && prepared) {
+            try {
+                await prepared.restore();
+                if (await d.installedVersion(installation) !== VERSION)
+                    throw new Error("Old version not restored.");
+                recovery = ` Restored Frely ${VERSION}.`;
+            }
+            catch {
+                preserveRecovery = true;
+                recovery = " Recovery failed; the backup (if any) was retained. Use the original installer to repair this installation.";
+            }
+        }
+        if (stopped) {
+            try {
+                await d.startMcpService();
+                recovery += " Requested restart of the original service.";
+            }
+            catch {
+                recovery += " The service could not restart. Run frely doctor -v.";
+            }
+        }
+        throw new Error(`${error instanceof Error ? error.message : "Upgrade failed."}${recovery}`);
+    }
+    finally {
+        releaseMaintenance?.();
+        try {
+            if (!preserveRecovery)
+                await prepared?.cleanup();
+        }
+        finally {
+            await unlock();
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/upgrade/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/upgrade/update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frely-cli",
-  "version": "0.6.1",
+  "version": "0.6.6",
   "description": "Frely account CLI and local MCP runtime",
   "license": "Apache-2.0",
   "repository": {
@@ -19,7 +19,8 @@
     "dist",
     "README.md",
     "NOTICE",
-    "TRADEMARKS.md"
+    "TRADEMARKS.md",
+    "skills"
   ],
   "scripts": {
     "build": "node scripts/clean.mjs dist && tsc -p tsconfig.build.json",

package/skills/frely-cli/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: frely-cli
+description: Use the installed Frely CLI to access Frely Agents, manage their local Skills, or inspect Frely access and usage.
+---
+
+Run `frely help --agent --json` for the installed CLI's current capabilities and instructions.
+
+Follow the returned command contract instead of remembered command syntax. If the command is unavailable, report that the installed CLI needs an update.