@hypercli/hq 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Saulo Vallory
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @hypercli/hq
+
+Claude Code session management plugin for the `hyper` CLI. Manages persistent Claude sessions via tmux, accessible from claude.ai/code, mobile, and Telegram.
+
+## Install
+
+Included automatically with `@hypercli/cli`. Can also be installed as a standalone oclif plugin.
+
+## Commands
+
+- `hyper hq start` — Start the always-on HQ control center
+- `hyper hq spawn <project>` — Spawn a Claude session for a project
+- `hyper hq status` — Show running sessions
+- `hyper hq list` — List available projects
+- `hyper hq attach` — Attach to a tmux session
+- `hyper hq stop` / `hyper hq stop-all` — Stop sessions
+
+## Documentation
+
+Full documentation at [hyperdev.saulo.engineer](https://hyperdev.saulo.engineer).
+
+## License
+
+MIT

package/dist/commands/hq/attach.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "#lib/base-command";
+export default class Attach extends BaseCommand<typeof Attach> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        session: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=attach.d.ts.map

package/dist/commands/hq/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/attach.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW,CAAC,OAAO,MAAM,CAAC;IAC7D,OAAgB,WAAW,SAAkC;IAE7D,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAKlB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAc1B"}

package/dist/commands/hq/attach.js

@@ -0,0 +1,29 @@
+import { execFileSync } from "node:child_process";
+import { Args } from "@oclif/core";
+import { BaseCommand } from "#lib/base-command";
+import * as tmux from "#services/tmux";
+export default class Attach extends BaseCommand {
+    static description = "Attach to an HQ tmux session";
+    static examples = [
+        "<%= config.bin %> hq attach",
+        "<%= config.bin %> hq attach my-project",
+    ];
+    static args = {
+        session: Args.string({
+            description: "Session name or project name (default: hyper-hq)",
+            required: false,
+        }),
+    };
+    async run() {
+        const { args } = await this.parse(Attach);
+        let target = args.session ?? "hyper-hq";
+        if (!target.startsWith("hq")) {
+            target = `hq-${target}`;
+        }
+        if (!tmux.sessionExists(target)) {
+            this.error(`Session '${target}' not found. Run 'hyper hq status' to see active sessions.`);
+        }
+        execFileSync("tmux", ["attach", "-t", target], { stdio: "inherit" });
+    }
+}
+//# sourceMappingURL=attach.js.map

package/dist/commands/hq/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/commands/hq/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAEvC,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAA0B;IAC7D,MAAM,CAAU,WAAW,GAAG,8BAA8B,CAAC;IAE7D,MAAM,CAAU,QAAQ,GAAG;QAC1B,6BAA6B;QAC7B,wCAAwC;KACxC,CAAC;IAEF,MAAM,CAAU,IAAI,GAAG;QACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,KAAK;SACf,CAAC;KACF,CAAC;IAEF,KAAK,CAAC,GAAG;QACR,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,YAAY,MAAM,4DAA4D,CAAC,CAAC;QAC5F,CAAC;QAED,YAAY,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC"}

package/dist/commands/hq/config.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "#lib/base-command";
+export default class Config extends BaseCommand<typeof Config> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        path: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/hq/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW,CAAC,OAAO,MAAM,CAAC;IAC7D,OAAgB,WAAW,SAA2B;IAEtD,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6C1B"}

package/dist/commands/hq/config.js

@@ -0,0 +1,56 @@
+import { Flags } from "@oclif/core";
+import { CONFIG_PATH, configExists, loadConfig } from "#config/index";
+import { BaseCommand } from "#lib/base-command";
+export default class Config extends BaseCommand {
+    static description = "Show HQ configuration";
+    static examples = [
+        "<%= config.bin %> hq config",
+        "<%= config.bin %> hq config --json",
+        "<%= config.bin %> hq config --path",
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        json: Flags.boolean({ description: "Output as JSON", default: false }),
+        path: Flags.boolean({ description: "Print config file path only", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(Config);
+        if (flags.path) {
+            this.log(CONFIG_PATH);
+            return;
+        }
+        if (!configExists()) {
+            this.log(`No config file found at ${CONFIG_PATH}`);
+            this.log("");
+            this.log('Run "hyper hq start" to create one via the setup wizard.');
+            return;
+        }
+        const config = loadConfig();
+        if (flags.json) {
+            this.log(JSON.stringify(config, null, 2));
+            return;
+        }
+        const telegramStatus = config.telegram.hq_bot_token
+            ? "enabled (HQ bot configured)"
+            : "disabled";
+        const projectBotCount = Object.keys(config.telegram.project_bots).length;
+        const projectBotInfo = projectBotCount > 0 ? `${projectBotCount} project bot(s)` : "none";
+        const groupCount = Object.values(config.projects).filter((p) => p.type === "group").length;
+        const groupInfo = groupCount > 0 ? `${groupCount} group(s) configured` : "none";
+        this.log(`Config file: ${CONFIG_PATH}`);
+        this.log("");
+        this.log(`  projects_root     ${config.projects_root}`);
+        this.log(`  hq.name           ${config.hq.name}`);
+        this.log(`  hq.dir            ${config.hq.dir}`);
+        this.log(`  hq.spawn_mode     ${config.hq.spawn_mode}`);
+        this.log(`  hq.capacity       ${config.hq.capacity}`);
+        this.log(`  claude.mode       ${config.claude.permission_mode ?? "default"}`);
+        this.log(`  telegram          ${telegramStatus}`);
+        this.log(`  project bots      ${projectBotInfo}`);
+        this.log(`  project groups    ${groupInfo}`);
+        this.log("");
+        this.log(`Edit: ${CONFIG_PATH}`);
+        this.log("Docs: https://clint.saulo.engineer/getting-started/configuration");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/hq/config.js.map

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

package/dist/commands/hq/list.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "#lib/base-command";
+export default class List extends BaseCommand<typeof List> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/hq/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW,CAAC,OAAO,IAAI,CAAC;IACzD,OAAgB,WAAW,SAAiD;IAE5E,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C1B"}

package/dist/commands/hq/list.js

@@ -0,0 +1,54 @@
+import { Flags } from "@oclif/core";
+import { loadConfig } from "#config/index";
+import { BaseCommand } from "#lib/base-command";
+import { listProjects } from "#services/projects";
+export default class List extends BaseCommand {
+    static description = "List available projects and their worktrees";
+    static examples = [
+        "<%= config.bin %> hq list",
+        "<%= config.bin %> hq list --json",
+        "<%= config.bin %> hq list --root /path/to/projects",
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        root: Flags.string({ description: "Override projects root directory" }),
+        json: Flags.boolean({ description: "Output as JSON", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(List);
+        const config = loadConfig();
+        if (flags.root) {
+            config.projects_root = flags.root;
+        }
+        const projects = listProjects(config);
+        if (flags.json) {
+            this.log(JSON.stringify(projects, null, 2));
+            return;
+        }
+        this.log(`Projects (${config.projects_root})`);
+        this.log("─".repeat(50));
+        if (projects.length === 0) {
+            this.log("  No projects found");
+            return;
+        }
+        for (const project of projects) {
+            const tags = [];
+            if (project.isGit)
+                tags.push("git");
+            if (project.hasWorktrees)
+                tags.push(`${project.worktrees.length} worktrees`);
+            const tagStr = tags.length > 0 ? `  (${tags.join(", ")})` : "";
+            this.log(`  ${project.name}${tagStr}`);
+            if (project.hasWorktrees) {
+                for (let i = 0; i < project.worktrees.length; i++) {
+                    const wt = project.worktrees[i];
+                    const isLast = i === project.worktrees.length - 1;
+                    const prefix = isLast ? "└─" : "├─";
+                    const mainTag = wt.isMain ? " *" : "";
+                    this.log(`    ${prefix} ${wt.branch}${mainTag}  ${wt.path}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/hq/list.js.map

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

package/dist/commands/hq/spawn.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from "#lib/base-command";
+export default class Spawn extends BaseCommand<typeof Spawn> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        worktree: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "new-worktree": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "permission-mode": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=spawn.d.ts.map

package/dist/commands/hq/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/spawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW,CAAC,OAAO,KAAK,CAAC;IAC3D,OAAgB,WAAW,SAA8C;IAEzE,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8E1B"}

package/dist/commands/hq/spawn.js

@@ -0,0 +1,100 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { basename, resolve } from "node:path";
+import { Args, Flags } from "@oclif/core";
+import { loadConfig } from "#config/index";
+import { BaseCommand } from "#lib/base-command";
+import { buildClaudeCommand } from "#services/claude";
+import { createWorktree, findWorktreePath, resolveProjectDir } from "#services/projects";
+import { getProjectTelegramEnv } from "#services/telegram";
+import { sanitizeSessionName } from "#services/tmux";
+import * as tmux from "#services/tmux";
+import { log } from "#utils/log";
+import { LOG_DIR } from "#utils/paths";
+export default class Spawn extends BaseCommand {
+    static description = "Spawn a new Claude session for a project";
+    static examples = [
+        "<%= config.bin %> hq spawn my-project",
+        "<%= config.bin %> hq spawn my-project --worktree feat-auth",
+        "<%= config.bin %> hq spawn my-project --new-worktree feat-login",
+        "<%= config.bin %> hq spawn /absolute/path/to/project",
+    ];
+    static args = {
+        project: Args.string({
+            description: "Project name (under projects root) or absolute path",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        worktree: Flags.string({ description: "Use an existing worktree (branch name)" }),
+        "new-worktree": Flags.string({ description: "Create a new worktree via wt switch -c" }),
+        "permission-mode": Flags.string({
+            description: "Permission mode",
+            options: ["default", "acceptEdits", "plan", "auto"],
+        }),
+        name: Flags.string({ description: "Custom session name" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Spawn);
+        const config = loadConfig();
+        const projectDir = resolveProjectDir(args.project, config);
+        const projectName = args.project.startsWith("/") ? basename(args.project) : args.project;
+        if (!existsSync(projectDir)) {
+            this.error(`Directory not found: ${projectDir}`);
+        }
+        let workDir = projectDir;
+        let branchSuffix = "";
+        if (flags["new-worktree"]) {
+            log(`Creating worktree: ${flags["new-worktree"]}`);
+            workDir = createWorktree(projectDir, flags["new-worktree"]);
+            branchSuffix = `-${flags["new-worktree"].replace(/\//g, "-")}`;
+            log(`Worktree created at: ${workDir}`);
+        }
+        else if (flags.worktree) {
+            const wtPath = findWorktreePath(projectDir, flags.worktree);
+            if (!wtPath) {
+                this.error(`Worktree '${flags.worktree}' not found in ${projectDir}`);
+            }
+            workDir = wtPath;
+            branchSuffix = `-${flags.worktree.replace(/\//g, "-")}`;
+        }
+        const sessionName = sanitizeSessionName(flags.name ?? `hq-${projectName}${branchSuffix}`);
+        if (tmux.sessionExists(sessionName)) {
+            log(`Session '${sessionName}' is already running. Use 'hyper hq attach ${projectName}' to connect.`);
+            return;
+        }
+        mkdirSync(LOG_DIR, { recursive: true });
+        const telegramEnv = getProjectTelegramEnv(projectName, config);
+        const logFile = resolve(LOG_DIR, `${sessionName}.log`);
+        const command = buildClaudeCommand({
+            name: sessionName,
+            spawnMode: "same-dir",
+            permissionMode: flags["permission-mode"] ?? config.claude.permission_mode,
+            telegramBotToken: telegramEnv?.TELEGRAM_BOT_TOKEN,
+            telegramStateDir: telegramEnv?.TELEGRAM_STATE_DIR,
+            logFile,
+        });
+        log(`Spawning Claude session for: ${projectName}`);
+        log(`Working directory: ${workDir}`);
+        tmux.createSession({ name: sessionName, cwd: workDir, command });
+        if (tmux.waitAndVerify(sessionName) === "dead") {
+            this.error(`Session '${sessionName}' exited immediately after starting.
+Check the log for details: ${logFile}
+
+Common causes:
+  - Remote Control is not enabled on your account
+  - Claude CLI is not authenticated (run: claude auth login)
+  - The claude command is not found (check your PATH)`);
+        }
+        tmux.disableRemainOnExit(sessionName);
+        log("");
+        log(`Session '${sessionName}' started`);
+        log("Connect via:");
+        log(`  Web:      claude.ai/code → find session '${sessionName}'`);
+        log(`  Terminal: hyper hq attach ${projectName}`);
+        if (telegramEnv) {
+            log(`  Telegram: Message the ${projectName} bot`);
+        }
+    }
+}
+//# sourceMappingURL=spawn.js.map

package/dist/commands/hq/spawn.js.map

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

package/dist/commands/hq/start.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "#lib/base-command";
+export default class Start extends BaseCommand<typeof Start> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "spawn-mode": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "permission-mode": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        capacity: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/hq/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/start.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAchD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW,CAAC,OAAO,KAAK,CAAC;IAC3D,OAAgB,WAAW,SAAiE;IAE5F,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;;MAcnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkG1B"}

package/dist/commands/hq/start.js

@@ -0,0 +1,178 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import * as p from "@clack/prompts";
+import { Flags } from "@oclif/core";
+import { runSetupIfNeeded } from "#config/setup";
+import { BaseCommand } from "#lib/base-command";
+import { buildClaudeCommand } from "#services/claude";
+import { getHqTelegramEnv } from "#services/telegram";
+import * as tmux from "#services/tmux";
+import { renderBanner } from "#utils/banner";
+import { log } from "#utils/log";
+import { LOG_DIR } from "#utils/paths";
+import { isWorkspaceTrusted, trustWorkspace } from "#utils/trust";
+function isHyperOnPath() {
+    const result = spawnSync("which", ["hyper"], { encoding: "utf-8" });
+    return result.status === 0;
+}
+export default class Start extends BaseCommand {
+    static description = "Start the HQ session — always-on Claude Code command center";
+    static examples = [
+        "<%= config.bin %> hq start",
+        "<%= config.bin %> hq start --spawn-mode worktree",
+        "<%= config.bin %> hq start --capacity 16",
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({ description: "Custom session name", default: undefined }),
+        "spawn-mode": Flags.string({
+            description: "How new sessions are created",
+            options: ["same-dir", "worktree", "session"],
+            default: undefined,
+        }),
+        "permission-mode": Flags.string({
+            description: "Permission mode for sessions",
+            options: ["default", "acceptEdits", "plan", "auto"],
+            default: undefined,
+        }),
+        capacity: Flags.integer({ description: "Max concurrent sessions", default: undefined }),
+    };
+    async run() {
+        const { flags } = await this.parse(Start);
+        const config = await runSetupIfNeeded();
+        const sessionName = flags.name ?? config.hq.name;
+        const spawnMode = flags["spawn-mode"] ?? config.hq.spawn_mode;
+        const capacity = flags.capacity ?? config.hq.capacity;
+        const permissionMode = flags["permission-mode"] ?? config.claude.permission_mode;
+        // Suggest global install if not on PATH
+        if (!isHyperOnPath()) {
+            p.log.warning("Hyper CLI is not installed globally. The HQ session won't be able to run hyper commands.\n" +
+                "  Install globally:\n\n" +
+                "    npm install -g @hypercli/cli\n" +
+                "    # or: bun install -g @hypercli/cli\n");
+        }
+        // Ensure HQ directory exists
+        const hqDir = config.hq.dir;
+        if (!existsSync(hqDir)) {
+            mkdirSync(hqDir, { recursive: true });
+            log(`Created HQ directory: ${hqDir}`);
+        }
+        // Generate CLAUDE.md for the HQ session if not present
+        const claudeMdPath = resolve(hqDir, "CLAUDE.md");
+        if (!existsSync(claudeMdPath)) {
+            writeFileSync(claudeMdPath, generateHqClaudeMd(config.projects_root), "utf-8");
+            log("Generated CLAUDE.md for HQ session.");
+        }
+        // Ensure workspace trust for both HQ dir and projects root
+        for (const dir of [hqDir, config.projects_root]) {
+            if (!isWorkspaceTrusted(dir)) {
+                trustWorkspace(dir);
+                log(`Trusted ${dir} for Claude Code.`);
+            }
+        }
+        if (tmux.sessionExists(sessionName)) {
+            log(`Session '${sessionName}' is already running. Use 'hyper hq attach' to connect.`);
+            return;
+        }
+        mkdirSync(LOG_DIR, { recursive: true });
+        const telegramEnv = config.telegram.hq_bot_token ? getHqTelegramEnv(config) : null;
+        const logFile = resolve(LOG_DIR, `${sessionName}.log`);
+        const command = buildClaudeCommand({
+            name: sessionName,
+            spawnMode,
+            capacity,
+            permissionMode,
+            telegramBotToken: telegramEnv?.TELEGRAM_BOT_TOKEN,
+            telegramStateDir: telegramEnv?.TELEGRAM_STATE_DIR,
+            logFile,
+        });
+        const cwd = hqDir;
+        log(`Starting HQ session: ${sessionName}`);
+        tmux.createSession({ name: sessionName, cwd, command });
+        // Verify the session actually survived startup
+        if (tmux.waitAndVerify(sessionName) === "dead") {
+            let lastError = "";
+            try {
+                const logContent = readFileSync(logFile, "utf-8");
+                const errorLines = logContent.split("\n").filter((l) => l.startsWith("Error:"));
+                if (errorLines.length > 0) {
+                    lastError = `\nLast error from log:\n  ${errorLines[errorLines.length - 1]}\n`;
+                }
+            }
+            catch { }
+            this.error(`Session '${sessionName}' exited immediately after starting.
+${lastError}
+Full log: ${logFile}
+
+Common causes:
+  - Remote Control is not enabled on your account
+  - Claude CLI is not authenticated (run: claude auth login)
+  - Workspace not trusted (run: cd <dir> && claude)
+  - The claude command is not found (check your PATH)`);
+        }
+        // Session survived — disable remain-on-exit so panes clean up normally
+        tmux.disableRemainOnExit(sessionName);
+        // Show welcome banner
+        this.log(renderBanner({ config, sessionName, logFile }));
+    }
+}
+function generateHqClaudeMd(projectsRoot) {
+    return `# Hyper HQ — Claude Code Command Center
+
+You are **Hyper HQ**, an always-running Claude Code instance that serves as a command center.
+Calm, decisive, and always in control.
+
+## Your Role
+
+You are a persistent Claude Code session running in remote-control server mode.
+Users connect to you from claude.ai/code, mobile apps, or via Telegram.
+
+## On Startup
+
+When this session first starts, immediately:
+1. If Telegram is available, use the \`reply\` tool to send: "Hyper HQ is online. Ready for orders."
+2. Run \`hyper hq list --json\` to get the current project inventory.
+
+## Capabilities
+
+1. **Spawn new Claude sessions** for any project using the \`hyper hq\` CLI
+2. **Receive and act on messages** via Telegram (if configured)
+3. **Manage running sessions** — start, stop, check status
+4. **Coordinate work** across multiple projects
+
+## Key Commands
+
+\`\`\`bash
+hyper hq spawn <project>                        # Spawn session for a project
+hyper hq spawn <project> --worktree <branch>    # Spawn on existing worktree
+hyper hq spawn <project> --new-worktree <branch> # Create worktree + spawn
+hyper hq status                                 # Check all running sessions
+hyper hq stop <project>                         # Stop a session
+hyper hq stop-all                               # Stop everything
+hyper hq list                                   # List all projects and worktrees
+hyper hq list --json                            # JSON output for parsing
+hyper hq config                                 # Show current configuration
+\`\`\`
+
+## Handling Requests
+
+When a user asks to open/start/spawn a session:
+
+1. Parse the request for: **project name** and optionally **worktree** (existing or new)
+2. Run \`hyper hq list --json\` to verify the project exists
+3. Run the appropriate spawn command
+4. Reply with confirmation, session name, and remind them to check **claude.ai/code**
+
+## Important Notes
+
+- Projects root: ${projectsRoot}
+- Logs: ~/.config/hyper/logs/
+- The \`wt\` (worktrunk) command manages worktrees
+- Config: ~/.config/hyper/hq.toml
+
+## Package Management
+- Use bun, never npm
+`;
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/hq/start.js.map

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

package/dist/commands/hq/status.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "#lib/base-command";
+export default class Status extends BaseCommand<typeof Status> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/hq/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/hq/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW,CAAC,OAAO,MAAM,CAAC;IAC7D,OAAgB,WAAW,SAA8B;IAEzD,OAAgB,QAAQ,WAAyE;IAEjG,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B1B"}