@indigoai-us/hq-cli 5.345.120 → 5.345.121

package/CHANGELOG.md

@@ -2,7 +2,12 @@
 
 ## [Unreleased]
 
+## [5.345.121] — 2026-10-13
+- `hq capture` ships in this release. It was listed under 5.345.120, but that tag was cut before the change merged, so 5.345.120 does not include it. `hq capture` drives HQ Capture, the hq-capture pack's screen recorder: `doctor`, `build`, `start [--record]`, `record`, `status`, `wait`, `stop`, `run` and `resume` run the pack's launcher from the HQ root with the arguments unchanged and pass its JSON and exit code through. `hq capture record` starts a recording without anyone pressing Start (pack 0.1.3 or later).
+
 ## [5.345.120] — 2026-10-13
+- Add `hq capture` to drive HQ Capture, the hq-capture pack's screen recorder: `doctor`, `build`, `start [--record]`, `record`, `status`, `wait`, `stop`, `run` and `resume` run the pack's launcher from the HQ root with the arguments unchanged and pass its JSON and exit code through. `hq capture record` starts a recording without anyone pressing Start (pack 0.1.3 or later).
+
 - `hq dm forward --company <slug|cmp_id>` names the company a person or agent
   destination belongs to. The CLI sends it as `companyUid`, so the server runs
   its destination-side cross-company check. Without it the destination is

package/dist/command-catalog.generated.d.ts

@@ -1352,6 +1352,171 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly hidden: false;
     }];
     readonly subcommands: readonly [];
+}, {
+    readonly name: "capture";
+    readonly description: "Record your screen with HQ Capture: start, record, stop, status and wait";
+    readonly aliases: readonly [];
+    readonly hidden: false;
+    readonly helpOption: true;
+    readonly helpCommand: true;
+    readonly usage: "[options] [command]";
+    readonly helpText: readonly [];
+    readonly arguments: readonly [];
+    readonly options: readonly [];
+    readonly subcommands: readonly [{
+        readonly name: "doctor";
+        readonly description: "Check this Mac can build and run HQ Capture";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "build";
+        readonly description: "Build HQ Capture if missing or out of date ([--force])";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "start";
+        readonly description: "Open HQ Capture for the session's company ([--company <slug>] [--record])";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "record";
+        readonly description: "Start recording in the open HQ Capture, as if Start was pressed";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "status";
+        readonly description: "Print HQ Capture's current status as JSON";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "wait";
+        readonly description: "Wait until the recording is saved, failed or closed ([--timeout <seconds>])";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "stop";
+        readonly description: "Stop HQ Capture, saving a recording in progress";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "run";
+        readonly description: "Run an agent command on a saved recording (<mode> <package> [args])";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "resume";
+        readonly description: "Check a pasted resume prompt and print its package (<prompt>)";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: false;
+        readonly helpCommand: false;
+        readonly usage: "[args...]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+            readonly description: "";
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
+    }];
 }, {
     readonly name: "auth";
     readonly description: "Manage the local HQ Cognito session";

package/dist/command-catalog.generated.js

@@ -1621,6 +1621,200 @@ export const COMMAND_CATALOG = [
         ],
         "subcommands": []
     },
+    {
+        "name": "capture",
+        "description": "Record your screen with HQ Capture: start, record, stop, status and wait",
+        "aliases": [],
+        "hidden": false,
+        "helpOption": true,
+        "helpCommand": true,
+        "usage": "[options] [command]",
+        "helpText": [],
+        "arguments": [],
+        "options": [],
+        "subcommands": [
+            {
+                "name": "doctor",
+                "description": "Check this Mac can build and run HQ Capture",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "build",
+                "description": "Build HQ Capture if missing or out of date ([--force])",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "start",
+                "description": "Open HQ Capture for the session's company ([--company <slug>] [--record])",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "record",
+                "description": "Start recording in the open HQ Capture, as if Start was pressed",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "status",
+                "description": "Print HQ Capture's current status as JSON",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "wait",
+                "description": "Wait until the recording is saved, failed or closed ([--timeout <seconds>])",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "stop",
+                "description": "Stop HQ Capture, saving a recording in progress",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "run",
+                "description": "Run an agent command on a saved recording (<mode> <package> [args])",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "resume",
+                "description": "Check a pasted resume prompt and print its package (<prompt>)",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": false,
+                "helpCommand": false,
+                "usage": "[args...]",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true,
+                        "description": ""
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            }
+        ]
+    },
     {
         "name": "auth",
         "description": "Manage the local HQ Cognito session",

package/dist/command-registration-plan.d.ts

@@ -213,6 +213,12 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "program";
     readonly module: "./commands/version.js";
     readonly exportName: "registerVersionCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "capture";
+    readonly parent: "program";
+    readonly module: "./commands/capture.js";
+    readonly exportName: "registerCaptureCommand";
 }, {
     readonly type: "registrar";
     readonly root: "auth";

package/dist/command-registration-plan.js

@@ -38,6 +38,7 @@ export const REGISTRATION_PLAN = [
     { type: "registrar", root: "resolve-company", parent: "program", module: "./commands/link.js", exportName: "registerResolveCompanyCommand" },
     { type: "registrar", root: "provider", parent: "program", module: "./commands/provider.js", exportName: "registerProviderCommand" },
     { type: "registrar", root: "version", parent: "program", module: "./commands/version.js", exportName: "registerVersionCommand" },
+    { type: "registrar", root: "capture", parent: "program", module: "./commands/capture.js", exportName: "registerCaptureCommand" },
     { type: "registrar", root: "auth", parent: "program", module: "./commands/auth.js", exportName: "registerAuthCommands" },
     { type: "registrar", root: "secrets", parent: "program", module: "./commands/secrets.js", exportName: "registerSecretsCommand" },
     { type: "registrar", root: "db", parent: "program", module: "./commands/db.js", exportName: "registerDbCommand" },

package/dist/commands/capture.d.ts

@@ -0,0 +1,25 @@
+/**
+ * hq capture — drive HQ Capture (the hq-capture pack's screen recorder) from the CLI.
+ *
+ * Every subcommand runs the pack's launcher, `hq-record-process.sh`, from the HQ root with
+ * the arguments unchanged. The launcher owns company binding, the app's control folder and
+ * its JSON output; this command adds nothing to them, so the pack stays the one source of
+ * truth for what each subcommand does. The launcher's exit code becomes the CLI's (3 means
+ * `wait` timed out with HQ Capture still open).
+ */
+import { type StdioOptions } from "node:child_process";
+import type { Command } from "commander";
+export declare const CAPTURE_LAUNCHER = "core/packages/hq-pack-hq-capture/scripts/hq-record-process.sh";
+export declare const CAPTURE_SUBCOMMANDS: readonly ["doctor", "build", "start", "record", "status", "wait", "stop", "run", "resume"];
+export interface CaptureRunOptions {
+    root: string;
+    stdio?: StdioOptions;
+}
+/** Runs the launcher with `args` and returns its exit code. */
+export declare function runCapture(args: readonly string[], opts: CaptureRunOptions): number;
+export interface CaptureRegisterOptions {
+    root?: () => string;
+    stdio?: StdioOptions;
+}
+export declare function registerCaptureCommand(program: Command, opts?: CaptureRegisterOptions): Command;
+//# sourceMappingURL=capture.d.ts.map

package/dist/commands/capture.js

@@ -0,0 +1,95 @@
+/**
+ * hq capture — drive HQ Capture (the hq-capture pack's screen recorder) from the CLI.
+ *
+ * Every subcommand runs the pack's launcher, `hq-record-process.sh`, from the HQ root with
+ * the arguments unchanged. The launcher owns company binding, the app's control folder and
+ * its JSON output; this command adds nothing to them, so the pack stays the one source of
+ * truth for what each subcommand does. The launcher's exit code becomes the CLI's (3 means
+ * `wait` timed out with HQ Capture still open).
+ */
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { resolveDefaultHqRoot } from "../utils/hq-root-resolver.js";
+export const CAPTURE_LAUNCHER = "core/packages/hq-pack-hq-capture/scripts/hq-record-process.sh";
+export const CAPTURE_SUBCOMMANDS = [
+    "doctor",
+    "build",
+    "start",
+    "record",
+    "status",
+    "wait",
+    "stop",
+    "run",
+    "resume",
+];
+const DESCRIPTIONS = {
+    doctor: "Check this Mac can build and run HQ Capture",
+    build: "Build HQ Capture if missing or out of date ([--force])",
+    start: "Open HQ Capture for the session's company ([--company <slug>] [--record])",
+    record: "Start recording in the open HQ Capture, as if Start was pressed",
+    status: "Print HQ Capture's current status as JSON",
+    wait: "Wait until the recording is saved, failed or closed ([--timeout <seconds>])",
+    stop: "Stop HQ Capture, saving a recording in progress",
+    run: "Run an agent command on a saved recording (<mode> <package> [args])",
+    resume: "Check a pasted resume prompt and print its package (<prompt>)",
+};
+/** Runs the launcher with `args` and returns its exit code. */
+export function runCapture(args, opts) {
+    const launcher = path.join(opts.root, CAPTURE_LAUNCHER);
+    if (!fs.existsSync(launcher)) {
+        process.stderr.write("HQ Capture is not installed in this HQ. Install it with: hq install hq-capture\n");
+        return 1;
+    }
+    const result = spawnSync("bash", [launcher, ...args], {
+        cwd: opts.root,
+        stdio: opts.stdio ?? "inherit",
+        env: process.env,
+    });
+    if (result.error) {
+        process.stderr.write(`Could not run HQ Capture: ${result.error.message}\n`);
+        return 1;
+    }
+    if (result.signal)
+        return 1;
+    return result.status ?? 1;
+}
+export function registerCaptureCommand(program, opts = {}) {
+    const capture = program
+        .command("capture")
+        .description("Record your screen with HQ Capture: start, record, stop, status and wait");
+    for (const name of CAPTURE_SUBCOMMANDS) {
+        capture
+            .command(name)
+            .description(DESCRIPTIONS[name])
+            .argument("[args...]")
+            .allowUnknownOption(true)
+            .allowExcessArguments(true)
+            .helpOption(false)
+            .action((_args, _options, command) => {
+            const root = opts.root ? opts.root() : resolveDefaultHqRoot({ onMissing: "throw" });
+            const forwarded = rawArgsAfter(command, name) ?? command.args;
+            process.exitCode = runCapture([name, ...forwarded], { root, stdio: opts.stdio });
+        });
+    }
+    return capture;
+}
+/**
+ * The arguments typed after `capture <name>`, exactly as given. Commander drops a `--`
+ * separator from `command.args`, which would change what the launcher receives, so the
+ * slice comes from the root command's raw argv. Returns undefined when it can't be found.
+ */
+function rawArgsAfter(command, name) {
+    let root = command;
+    while (root.parent)
+        root = root.parent;
+    const raw = root.rawArgs;
+    if (!Array.isArray(raw))
+        return undefined;
+    for (let i = 0; i + 1 < raw.length; i++) {
+        if (raw[i] === "capture" && raw[i + 1] === name)
+            return raw.slice(i + 2);
+    }
+    return undefined;
+}
+//# sourceMappingURL=capture.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.345.120",
+  "version": "5.345.121",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {