native-shortcuts-herd 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yigitkonur
+
+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,212 @@
+# native-shortcuts-herd
+
+make ghostty navigation feel like a real macos app.
+
+ghostty is fast, powerful, and beautifully native. but if your hands come from chrome, safari, arc, iterm, warp, or cmux-style workflows, the default terminal navigation can still feel a little off. tabs, spaces, split contexts, and terminal multiplexers all speak different shortcut languages.
+
+`native-shortcuts-herd` fixes that by wiring ghostty and herdr together with familiar macos/chrome-style shortcuts, without rewriting your existing config.
+
+<video src="./docs/assets/native-shortcuts-herd-demo.mp4" controls width="100%"></video>
+
+> demo file: `docs/assets/native-shortcuts-herd-demo.mp4`
+
+## install
+
+```sh
+npx native-shortcuts-herd install
+```
+
+the installer is reusable. run it again any time to switch profiles, change what `cmd+1..9` targets, update mappings, repair config drift, or revert cleanly.
+
+## why this exists
+
+terminal power users already know how to build custom keymaps. the problem is that every terminal, multiplexer, and tui app has its own idea of what "tab", "space", and "pane" means.
+
+macos users expect this:
+
+| habit | expected feel |
+|---|---|
+| `cmd+t` | create a new tab-like context |
+| `cmd+n` | create a new top-level working context |
+| `cmd+w` | close the current tab-like context |
+| `cmd+1..9` | jump directly by visible position |
+| `ctrl+tab` | cycle through the main contexts |
+| `ctrl+option+tab` | cycle through the secondary contexts |
+
+ghostty already has excellent keybinding support. herdr already has workspaces, tabs, panes, direct keybindings, and indexed jumps. this package connects the two in a safe, repeatable way.
+
+## what it does
+
+| system | change |
+|---|---|
+| ghostty | adds one managed `config-file` include to your existing config |
+| ghostty sidecar | writes only owned keybind routes into `~/.config/native-shortcuts-herd/ghostty.conf` |
+| herdr | updates `[keys]`, `[keys.indexed]`, and `ui.prompt_new_tab_name` |
+| state | stores install state in `~/.config/native-shortcuts-herd/state.json` |
+| backups | creates timestamped backups before writing |
+| revert | removes the ghostty sidecar/include and restores tracked herdr values |
+
+## keybindings
+
+the installer lets you choose what the ambiguous families target. nothing is hardcoded forever.
+
+| shortcut | default profile behavior | configurable |
+|---|---|---|
+| `cmd+t` | new herdr tab | yes |
+| `cmd+n` | new herdr workspace / space | yes |
+| `cmd+w` | close active herdr tab | yes |
+| `cmd+k` | rename active herdr workspace | yes |
+| `cmd+l` | rename active herdr tab | yes |
+| `cmd+1..9` | wizard-selected: spaces, tabs, or off | yes |
+| `ctrl+tab` | wizard-selected: spaces, tabs, or off | yes |
+| `ctrl+shift+tab` | previous item for `ctrl+tab` target | yes |
+| `ctrl+option+tab` | wizard-selected: tabs, spaces, or off | yes |
+| `ctrl+option+shift+tab` | previous item for `ctrl+option+tab` target | yes |
+
+## ghostty behavior mappings
+
+ghostty receives macos keys first. this tool routes them into terminal sequences that herdr can understand.
+
+| ghostty trigger | managed action | herdr receives |
+|---|---|---|
+| `cmd+key_t` | `text:\x02t` | prefix + `t` |
+| `cmd+key_n` | `text:\x02n` | prefix + `n` |
+| `cmd+key_w` | `text:\x02W` | prefix + `shift+w` |
+| `cmd+key_k` | `text:\x02N` | prefix + `shift+n` |
+| `cmd+key_l` | `text:\x02T` | prefix + `shift+t` |
+| `ctrl+tab` | `text:\x1b[9;5u` | enhanced `ctrl+tab` |
+| `ctrl+shift+tab` | `text:\x1b[9;6u` | enhanced `ctrl+shift+tab` |
+| `ctrl+option+tab` | `text:\x1b[9;7u` | enhanced `ctrl+alt+tab` |
+| `cmd+1..9` | generated per profile | indexed herdr jump |
+
+for macos menu conflicts like `cmd+w`, ghostty gets both a physical-key route and a normal `cmd+w=unbind`, so the terminal app does not close the window before herdr sees the intended action.
+
+## herdr integration
+
+herdr v0.5.10 added the pieces that make this clean: indexed keybind families and instant generated tab names.
+
+| herdr config | purpose |
+|---|---|
+| `[keys].new_workspace` | target for `cmd+n` |
+| `[keys].new_tab` | target for `cmd+t` |
+| `[keys].close_tab` | target for `cmd+w` |
+| `[keys].previous_workspace` / `next_workspace` | direct cycle shortcuts |
+| `[keys].previous_tab` / `next_tab` | direct tab cycle shortcuts |
+| `[keys.indexed].workspaces` | direct workspace jumps 1-9 |
+| `[keys.indexed].tabs` | direct tab jumps 1-9 |
+| `[ui].prompt_new_tab_name` | set to `false` for instant tab creation |
+
+## install options
+
+| command | use it when |
+|---|---|
+| `npx native-shortcuts-herd install` | guided setup, best first run |
+| `npx native-shortcuts-herd apply --profile chrome-spaces --yes` | repeatable non-interactive setup |
+| `npx native-shortcuts-herd diff` | inspect changes before writing |
+| `npx native-shortcuts-herd doctor` | see detected ghostty/herdr state |
+| `npx native-shortcuts-herd revert` | remove managed changes |
+| `npx native-shortcuts-herd profiles` | list built-in profiles |
+| `npx native-shortcuts-herd generate-installer` | print a tiny shell installer |
+
+## supported workflows
+
+| workflow | status | notes |
+|---|---|---|
+| ghostty on macos | supported | primary target |
+| cmux ghostty config | supported | detected when the config file exists |
+| herdr 0.5.10+ | supported | required for indexed jumps |
+| re-running installer | supported | updates managed files idempotently |
+| uninstall/revert | supported | uses saved state and best-effort cleanup |
+| custom keymaps | supported | use profile choices and `--ghostty-key` / `--herdr-key` |
+| linux ghostty | best effort | key routing may vary by desktop environment |
+| windows | not supported | ghostty/herdr target here is macos-first |
+
+## examples
+
+chrome-ish spaces:
+
+```sh
+npx native-shortcuts-herd apply --profile chrome-spaces --yes
+```
+
+literal chrome tabs:
+
+```sh
+npx native-shortcuts-herd apply --profile chrome-tabs --yes
+```
+
+turn off indexed `cmd+1..9` but keep cycling:
+
+```sh
+npx native-shortcuts-herd apply --cmd-numbers off --ctrl-tab workspaces --ctrl-opt-tab tabs --yes
+```
+
+add a custom herdr action:
+
+```sh
+npx native-shortcuts-herd apply --herdr-key reload_config=shift+r --yes
+```
+
+patch a specific ghostty config:
+
+```sh
+npx native-shortcuts-herd apply --ghostty-config ~/.config/ghostty/config --yes
+```
+
+preview everything:
+
+```sh
+npx native-shortcuts-herd diff --profile chrome-spaces
+```
+
+revert:
+
+```sh
+npx native-shortcuts-herd revert
+```
+
+## safety model
+
+this package is intentionally boring about file writes.
+
+| safety feature | behavior |
+|---|---|
+| sidecar include | ghostty gets one include; owned keybinds live elsewhere |
+| backups | files are copied before writes |
+| state file | previous herdr values are tracked for revert |
+| dry run | `diff` and `--dry-run` show planned changes first |
+| validation | ghostty config validation runs when the binary is available |
+| reload | herdr reload is attempted when a server is running |
+| no secret handling | npm/github tokens are never written into config |
+
+## development
+
+```sh
+npm install
+npm test
+npm run typecheck
+npm run build
+npm pack --dry-run
+```
+
+local dry run:
+
+```sh
+npm run dev -- diff --profile chrome-spaces
+```
+
+## release
+
+the repo ships with github actions for ci and npm publishing.
+
+first publish uses `NPM_TOKEN` as a github actions secret with provenance:
+
+```sh
+gh secret set NPM_TOKEN --repo yigitkonur/native-shortcuts-herd
+```
+
+after the first public package exists, move to npm trusted publishing so ci can publish with oidc and no long-lived token.
+
+## license
+
+mit

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import prompts from "prompts";
+import pc from "picocolors";
+import { choicesFromOptions, getProfile, profiles, targetFrom } from "./profiles.js";
+import { applyConfig, diffConfig, diffRevert, doctor, revertConfig } from "./installer.js";
+import { formatDiff, jsonError, jsonOk, printHuman } from "./format.js";
+const program = new Command();
+program
+    .name("native-shortcuts-herd")
+    .description("make ghostty + herdr navigation feel native to macos")
+    .version("0.1.0");
+addSharedOptions(program.command("install"))
+    .description("run the guided installer")
+    .action(async (options) => {
+    await run(async () => {
+        const choices = await promptForChoices(options);
+        const result = await applyConfig(toApplyRequest(choices, options));
+        outputResult("installed native shortcuts", result, options);
+    }, options);
+});
+addSharedOptions(program.command("apply"))
+    .description("apply a profile non-interactively")
+    .action(async (options) => {
+    await run(async () => {
+        const choices = choicesFromOptions(options);
+        const result = await applyConfig(toApplyRequest(choices, options));
+        outputResult("applied native shortcuts", result, options);
+    }, options);
+});
+addSharedOptions(program.command("diff"))
+    .description("show the config changes without writing")
+    .action(async (options) => {
+    await run(async () => {
+        const choices = choicesFromOptions(options);
+        const result = diffConfig(choices, options.ghosttyConfig);
+        if (options.json)
+            jsonOk(result);
+        else
+            process.stdout.write(formatDiff(result.changes));
+    }, options);
+});
+program
+    .command("revert")
+    .description("remove managed ghostty/herdr changes")
+    .option("--dry-run", "preview the revert without writing")
+    .option("--json", "print machine-readable json")
+    .action(async (options) => {
+    await run(async () => {
+        const result = options.dryRun ? diffRevert() : revertConfig(Boolean(options.dryRun));
+        outputResult("reverted native shortcuts", result, options);
+    }, options);
+});
+program
+    .command("doctor")
+    .description("inspect ghostty, herdr, and managed state")
+    .option("--json", "print machine-readable json")
+    .action(async (options) => {
+    await run(async () => {
+        const report = doctor();
+        if (options.json)
+            jsonOk(report);
+        else
+            process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    }, options);
+});
+program
+    .command("profiles")
+    .description("list built-in shortcut profiles")
+    .option("--json", "print machine-readable json")
+    .action(async (options) => {
+    await run(async () => {
+        if (options.json)
+            jsonOk({ profiles });
+        else {
+            for (const profile of profiles) {
+                console.log(`${pc.bold(profile.id)} ${pc.dim(profile.description)}`);
+            }
+        }
+    }, options);
+});
+program
+    .command("generate-installer")
+    .description("print a standalone installer script")
+    .option("--json", "print machine-readable json")
+    .action(async (options) => {
+    await run(async () => {
+        const script = [
+            "#!/usr/bin/env sh",
+            "set -eu",
+            "command -v npm >/dev/null 2>&1 || { echo 'npm is required' >&2; exit 127; }",
+            "npx --yes native-shortcuts-herd install"
+        ].join("\n");
+        if (options.json)
+            jsonOk({ script });
+        else
+            process.stdout.write(`${script}\n`);
+    }, options);
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(pc.red(message));
+    process.exitCode = 1;
+});
+function addSharedOptions(command) {
+    return command
+        .option("--profile <id>", "profile: chrome-spaces, chrome-tabs, minimal", "chrome-spaces")
+        .option("--cmd-numbers <target>", "cmd+1..9 target: workspaces, tabs, off")
+        .option("--ctrl-tab <target>", "ctrl+tab target: workspaces, tabs, off")
+        .option("--ctrl-opt-tab <target>", "ctrl+option+tab target: workspaces, tabs, off")
+        .option("--prompt-new-tab-name", "keep herdr's new-tab rename prompt")
+        .option("--ghostty-config <path...>", "specific ghostty config path(s)")
+        .option("--ghostty-key <trigger=action...>", "extra managed ghostty keybind", collect, [])
+        .option("--herdr-key <action=key...>", "extra managed herdr [keys] binding", collect, [])
+        .option("--skip-ghostty", "do not patch ghostty")
+        .option("--skip-herdr", "do not patch herdr")
+        .option("--skip-herdr-install", "do not offer automatic herdr install/update")
+        .option("--no-reload", "write config but skip live reload attempts")
+        .option("--dry-run", "preview without writing")
+        .option("--yes", "accept safe defaults and allow herdr install/update")
+        .option("--json", "print machine-readable json");
+}
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+async function promptForChoices(options) {
+    if (options.yes || !process.stdin.isTTY)
+        return choicesFromOptions(options);
+    const base = getProfile(String(options.profile ?? "chrome-spaces"));
+    const answers = await prompts([
+        {
+            type: "select",
+            name: "profile",
+            message: "choose a base shortcut feel",
+            initial: profiles.findIndex((profile) => profile.id === base.id),
+            choices: profiles.map((profile) => ({
+                title: profile.name,
+                value: profile.id,
+                description: profile.description
+            }))
+        },
+        {
+            type: "select",
+            name: "cmdNumbers",
+            message: "what should cmd+1..9 jump to?",
+            initial: 0,
+            choices: targetChoices()
+        },
+        {
+            type: "select",
+            name: "ctrlTab",
+            message: "what should ctrl+tab cycle?",
+            initial: 0,
+            choices: targetChoices()
+        },
+        {
+            type: "select",
+            name: "ctrlOptTab",
+            message: "what should ctrl+option+tab cycle?",
+            initial: 1,
+            choices: targetChoices()
+        },
+        {
+            type: "confirm",
+            name: "promptNewTabName",
+            message: "keep herdr's rename prompt when creating new tabs?",
+            initial: false
+        }
+    ], { onCancel: () => process.exit(130) });
+    const selected = getProfile(answers.profile);
+    return {
+        ...choicesFromOptions(options),
+        profile: selected.id,
+        cmdNumbers: targetFrom(answers.cmdNumbers, selected.cmdNumbers),
+        ctrlTab: targetFrom(answers.ctrlTab, selected.ctrlTab),
+        ctrlOptTab: targetFrom(answers.ctrlOptTab, selected.ctrlOptTab),
+        promptNewTabName: Boolean(answers.promptNewTabName)
+    };
+}
+function targetChoices() {
+    return [
+        { title: "spaces", value: "workspaces", description: "herdr workspaces / spaces" },
+        { title: "tabs", value: "tabs", description: "herdr tabs inside the current space" },
+        { title: "off", value: "off", description: "leave this shortcut family unmanaged" }
+    ];
+}
+function toApplyRequest(choices, options) {
+    return {
+        choices,
+        dryRun: Boolean(options.dryRun),
+        yes: Boolean(options.yes),
+        ghosttyConfigPaths: options.ghosttyConfig,
+        skipGhostty: Boolean(options.skipGhostty),
+        skipHerdr: Boolean(options.skipHerdr),
+        skipHerdrInstall: Boolean(options.skipHerdrInstall),
+        noReload: options.reload === false
+    };
+}
+async function run(task, options) {
+    try {
+        await task();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json)
+            jsonError("COMMAND_FAILED", message, false);
+        else
+            console.error(pc.red(message));
+        process.exitCode = 1;
+    }
+}
+function outputResult(title, result, options) {
+    if (options.json)
+        jsonOk(result);
+    else
+        printHuman(title, result.changes, result.warnings);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,5 @@
+import type { Change } from "./types.js";
+export declare function printHuman(title: string, changes: Change[], warnings: string[]): void;
+export declare function jsonOk(result: unknown): void;
+export declare function jsonError(code: string, message: string, retryable?: boolean): void;
+export declare function formatDiff(changes: Change[]): string;

package/dist/format.js

@@ -0,0 +1,39 @@
+import pc from "picocolors";
+export function printHuman(title, changes, warnings) {
+    console.error(pc.bold(title));
+    for (const warning of warnings) {
+        console.error(`${pc.yellow("warn")} ${warning}`);
+    }
+    for (const change of changes) {
+        const marker = change.kind === "noop" ? pc.dim("-") : change.kind === "warn" ? pc.yellow("!") : pc.green("+");
+        console.error(`${marker} ${change.message} ${pc.dim(change.path)}`);
+    }
+}
+export function jsonOk(result) {
+    process.stdout.write(`${JSON.stringify({ ok: true, result, error: null, schema_version: "v1" }, null, 2)}\n`);
+}
+export function jsonError(code, message, retryable = false) {
+    process.stdout.write(`${JSON.stringify({
+        ok: false,
+        result: null,
+        error: { class: "error", code, message, retryable },
+        schema_version: "v1"
+    }, null, 2)}\n`);
+}
+export function formatDiff(changes) {
+    return changes
+        .map((change) => {
+        if (!change.before && !change.after)
+            return `# ${change.kind}: ${change.message}\n# ${change.path}\n`;
+        return [
+            `# ${change.kind}: ${change.message}`,
+            `# ${change.path}`,
+            "--- before",
+            change.before ?? "",
+            "+++ after",
+            change.after ?? ""
+        ].join("\n");
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAiB,EAAE,QAAkB;IAC7E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9G,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAe;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,SAAS,GAAG,KAAK;IACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CACf;QACE,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE;QACnD,cAAc,EAAE,IAAI;KACrB,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAiB;IAC1C,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC;QACtG,OAAO;YACL,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE;YACrC,KAAK,MAAM,CAAC,IAAI,EAAE;YAClB,YAAY;YACZ,MAAM,CAAC,MAAM,IAAI,EAAE;YACnB,WAAW;YACX,MAAM,CAAC,KAAK,IAAI,EAAE;SACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/fs-utils.d.ts

@@ -0,0 +1,22 @@
+import type { Change } from "./types.js";
+export declare const appName = "native-shortcuts-herd";
+export declare function homePath(...parts: string[]): string;
+export declare function configRoot(): string;
+export declare function statePath(): string;
+export declare function backupRoot(): string;
+export declare function ensureDir(path: string): void;
+export declare function readText(path: string): string;
+export declare function writeText(path: string, content: string): void;
+export declare function removeFile(path: string): void;
+export declare function timestamp(): string;
+export declare function backupFile(path: string, label: string): string | null;
+export declare function runOptional(command: string, args: string[]): {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+};
+export declare function bufferToString(value: Buffer | string | undefined): string;
+export declare function sha256(buffer: Buffer): string;
+export declare function isMac(): boolean;
+export declare function diffChange(path: string, before: string, after: string, message: string): Change;
+export declare function sortedUnique(values: string[]): string[];

package/dist/fs-utils.js

@@ -0,0 +1,81 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+export const appName = "native-shortcuts-herd";
+export function homePath(...parts) {
+    return join(homedir(), ...parts);
+}
+export function configRoot() {
+    if (process.env.NATIVE_SHORTCUTS_HERD_CONFIG_ROOT) {
+        return process.env.NATIVE_SHORTCUTS_HERD_CONFIG_ROOT;
+    }
+    return homePath(".config", appName);
+}
+export function statePath() {
+    return join(configRoot(), "state.json");
+}
+export function backupRoot() {
+    return join(configRoot(), "backups");
+}
+export function ensureDir(path) {
+    mkdirSync(path, { recursive: true });
+}
+export function readText(path) {
+    return readFileSync(path, "utf8");
+}
+export function writeText(path, content) {
+    ensureDir(dirname(path));
+    writeFileSync(path, content, "utf8");
+}
+export function removeFile(path) {
+    if (existsSync(path))
+        rmSync(path);
+}
+export function timestamp() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+export function backupFile(path, label) {
+    if (!existsSync(path))
+        return null;
+    const target = join(backupRoot(), `${label}-${timestamp()}.bak`);
+    ensureDir(dirname(target));
+    copyFileSync(path, target);
+    return target;
+}
+export function runOptional(command, args) {
+    try {
+        const stdout = execFileSync(command, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        return { ok: true, stdout, stderr: "" };
+    }
+    catch (error) {
+        const detail = error;
+        return {
+            ok: false,
+            stdout: bufferToString(detail.stdout),
+            stderr: bufferToString(detail.stderr)
+        };
+    }
+}
+export function bufferToString(value) {
+    if (!value)
+        return "";
+    return Buffer.isBuffer(value) ? value.toString("utf8") : value;
+}
+export function sha256(buffer) {
+    return createHash("sha256").update(buffer).digest("hex");
+}
+export function isMac() {
+    return platform() === "darwin";
+}
+export function diffChange(path, before, after, message) {
+    if (before === after) {
+        return { path, kind: "noop", message: `${message}: already current` };
+    }
+    return { path, kind: before ? "update" : "create", before, after, message };
+}
+export function sortedUnique(values) {
+    return [...new Set(values)].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

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

package/dist/ghostty.d.ts

@@ -0,0 +1,9 @@
+import type { Change } from "./types.js";
+export declare function ghosttySidecarPath(): string;
+export declare function discoverGhosttyConfigs(explicit: string[] | undefined): string[];
+export declare function planGhosttyPatch(configPaths: string[], lines: string[]): Change[];
+export declare function applyGhosttyPatch(configPaths: string[], lines: string[], dryRun: boolean): Change[];
+export declare function planGhosttyRevert(configPaths: string[]): Change[];
+export declare function applyGhosttyRevert(configPaths: string[], dryRun: boolean): Change[];
+export declare function validateGhosttyConfigs(configPaths: string[]): string[];
+export declare function reloadGhosttyIfRunning(): void;