@terminalhere/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TerminalHere Contributors
+
+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,53 @@
+# TerminalHere for npm
+
+[![CI](https://github.com/mehmetduran932/terminalhere-npm/actions/workflows/ci.yml/badge.svg)](https://github.com/mehmetduran932/terminalhere-npm/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Cross-platform file-manager integration for opening a folder in a terminal.
+
+## Install
+
+```powershell
+npm install --global @terminalhere/cli
+terminalhere install
+terminalhere status
+```
+
+Windows adds Explorer entries beneath `HKCU\\Software\\Classes` without administrator privileges. macOS installs a Finder Quick Action, while Linux installs a Nautilus Script; restart Nautilus after installation if it does not appear immediately.
+
+## Commands
+
+```text
+terminalhere install | uninstall | status
+terminalhere enable <terminal|powershell|cmd|gitbash|vscode>
+terminalhere disable <terminal|powershell|cmd|gitbash|vscode>
+terminalhere enable-all | disable-all
+terminalhere open [directory]
+```
+
+Add `--json` to `status`, `install`, or enable/disable commands for automation.
+
+## Security and project rules
+
+- No administrator privileges are required or requested.
+- The package changes only the current user's supported file-manager integration locations.
+- Report vulnerabilities privately; see [SECURITY.md](SECURITY.md).
+- Contributions follow the fork/PR, branch naming, review, and CI requirements in
+  [CONTRIBUTING.md](CONTRIBUTING.md).
+- This repository is public, but no npm package has been published from it.
+
+## Development
+
+```bash
+npm install
+npm test
+npm run build
+npm pack --dry-run
+```
+
+No npm release has been published from this repository.
+
+## Package migration
+
+`@mdsoft2026/terminalhere` has been replaced by `@terminalhere/cli`. The
+`terminalhere` command is unchanged; reinstall the package under its new name.

package/dist/apps.d.ts

@@ -0,0 +1,4 @@
+import type { AppInfo, TerminalTarget } from './types.js';
+export declare function detectApp(target: TerminalTarget): Promise<AppInfo>;
+export declare const targets: TerminalTarget[];
+export declare function commandFor(target: TerminalTarget, executablePath: string, token: '%V' | '%1'): string;

package/dist/apps.js

@@ -0,0 +1,88 @@
+import { access } from 'node:fs/promises';
+import { delimiter, join } from 'node:path';
+const targetDetails = {
+    terminal: {
+        target: 'terminal',
+        displayName: 'Open in Terminal',
+        registryKeyName: 'TerminalHere.WindowsTerminal',
+    },
+    powershell: {
+        target: 'powershell',
+        displayName: 'Open in PowerShell',
+        registryKeyName: 'TerminalHere.PowerShell',
+    },
+    cmd: {
+        target: 'cmd',
+        displayName: 'Open in Command Prompt',
+        registryKeyName: 'TerminalHere.CommandPrompt',
+    },
+    gitbash: {
+        target: 'gitbash',
+        displayName: 'Open in Git Bash',
+        registryKeyName: 'TerminalHere.GitBash',
+    },
+    vscode: {
+        target: 'vscode',
+        displayName: 'Open in VS Code',
+        registryKeyName: 'TerminalHere.VSCode',
+    },
+};
+const candidates = {
+    terminal: [],
+    powershell: [],
+    cmd: process.env.ComSpec ? [process.env.ComSpec] : [],
+    gitbash: ['C:\\Program Files\\Git\\git-bash.exe', 'C:\\Program Files (x86)\\Git\\git-bash.exe'],
+    vscode: [
+        join(process.env.LOCALAPPDATA ?? '', 'Programs', 'Microsoft VS Code', 'Code.exe'),
+        'C:\\Program Files\\Microsoft VS Code\\Code.exe',
+    ],
+};
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findOnPath(names) {
+    const paths = (process.env.PATH ?? '').split(delimiter).filter(Boolean);
+    for (const directory of paths) {
+        for (const name of names) {
+            const candidate = join(directory, name);
+            if (await exists(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+export async function detectApp(target) {
+    const details = targetDetails[target];
+    const pathNames = {
+        terminal: ['wt.exe'],
+        powershell: ['powershell.exe'],
+        cmd: ['cmd.exe'],
+        gitbash: ['git-bash.exe'],
+        vscode: ['Code.exe'],
+    };
+    const executablePath = (await findOnPath(pathNames[target])) ??
+        (await Promise.all(candidates[target].map(async (path) => ((await exists(path)) ? path : undefined)))).find(Boolean);
+    return { ...details, executablePath, iconPath: executablePath };
+}
+export const targets = Object.keys(targetDetails);
+export function commandFor(target, executablePath, token) {
+    switch (target) {
+        case 'terminal':
+            return `wt.exe -d "${token}"`;
+        case 'powershell':
+            return `powershell.exe -NoExit -Command "Set-Location -LiteralPath '${token}'"`;
+        case 'cmd':
+            return `cmd.exe /K cd /d "${token}"`;
+        case 'gitbash':
+            return `"${executablePath}" --cd="${token}"`;
+        case 'vscode':
+            return `"${executablePath}" "${token}"`;
+    }
+}
+//# sourceMappingURL=apps.js.map

package/dist/apps.js.map

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

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { PlatformIntegration } from './platform.js';
+import { targets } from './apps.js';
+const commands = [
+    'install',
+    'uninstall',
+    'status',
+    'enable',
+    'disable',
+    'enable-all',
+    'disable-all',
+    'open',
+];
+function usage() {
+    return `TerminalHere\n\nUsage: terminalhere <${commands.join('|')}> [target] [--json]\nTargets: ${targets.join(', ')}`;
+}
+function isTarget(value) {
+    return Boolean(value && targets.includes(value));
+}
+function print(statuses, json) {
+    if (json)
+        console.log(JSON.stringify(statuses, null, 2));
+    else
+        for (const item of statuses)
+            console.log(`${item.displayName}: ${item.installed ? 'Available' : 'Not found'} / ${item.enabled ? 'Enabled' : 'Disabled'}`);
+}
+async function main() {
+    const [command, target, ...flags] = process.argv.slice(2);
+    const json = flags.includes('--json') || target === '--json';
+    if (!command || command === '--help' || command === '-h') {
+        console.log(usage());
+        return;
+    }
+    const service = new PlatformIntegration();
+    if (command === 'install' || command === 'enable-all')
+        return void print(await service.install(isTarget(target) ? target : 'terminal'), json);
+    if (command === 'uninstall' || command === 'disable-all')
+        return void print(await service.uninstall(isTarget(target) ? target : 'terminal'), json);
+    if (command === 'status')
+        return void print(await service.getStatus(isTarget(target) ? target : undefined), json);
+    if (command === 'open')
+        return service.open(target && target !== '--json' ? target : undefined);
+    if ((command === 'enable' || command === 'disable') && isTarget(target)) {
+        print(command === 'enable' ? await service.install(target) : await service.uninstall(target), json);
+        return;
+    }
+    throw new Error(usage());
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});
+//# 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/index.d.ts

@@ -0,0 +1,5 @@
+export * from './apps.js';
+export * from './registry.js';
+export * from './service.js';
+export * from './platform.js';
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './apps.js';
+export * from './registry.js';
+export * from './service.js';
+export * from './platform.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,8 @@
+import type { TerminalStatus, TerminalTarget } from './types.js';
+export declare class PlatformIntegration {
+    private readonly windows;
+    install(target?: TerminalTarget): Promise<TerminalStatus[]>;
+    uninstall(target?: TerminalTarget): Promise<TerminalStatus[]>;
+    getStatus(target?: TerminalTarget): Promise<TerminalStatus[]>;
+    open(directory?: string): Promise<void>;
+}

package/dist/platform.js

@@ -0,0 +1,134 @@
+import { execFile as execFileCallback } from 'node:child_process';
+import { chmod, mkdir, rm, stat, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { promisify } from 'node:util';
+import { ContextMenuService } from './service.js';
+import { RegExeClient } from './registry.js';
+const execFile = promisify(execFileCallback);
+const macWorkflow = join(homedir(), 'Library', 'Services', 'TerminalHere.workflow');
+const linuxScript = join(homedir(), '.local', 'share', 'nautilus', 'scripts', 'TerminalHere');
+const finderWorkflow = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+    '<plist version="1.0"><dict><key>AMDocumentVersion</key><string>2</string><key>AMWorkflowType</key><string>Service</string>',
+    '<key>actions</key><array><dict><key>action</key><dict><key>AMAccepts</key><dict><key>Container</key><string>List</string><key>Optional</key><true/><key>Types</key><array><string>com.apple.cocoa.path</string></array></dict>',
+    '<key>AMActionVersion</key><string>2.0.3</string><key>AMApplication</key><array><string>Automator</string></array><key>AMParameterProperties</key><dict><key>COMMAND_STRING</key><dict><key>default value</key><string>for f in "$@"; do osascript - "$f" &lt;&lt;\'APPLESCRIPT\'\non run argv\n tell application "Terminal"\n  activate\n  do script "cd " &amp; quoted form of item 1 of argv\n end tell\nend run\nAPPLESCRIPT\ndone</string></dict><key>inputMethod</key><dict><key>default value</key><integer>1</integer></dict><key>shell</key><dict><key>default value</key><string>/bin/zsh</string></dict></dict>',
+    '<key>AMProvides</key><dict><key>Container</key><string>List</string><key>Types</key><array><string>com.apple.cocoa.path</string></array></dict><key>ActionBundlePath</key><string>/System/Library/Automator/Run Shell Script.action</string><key>ActionName</key><string>Run Shell Script</string><key>BundleIdentifier</key><string>com.apple.RunShellScript</string><key>CFBundleVersion</key><string>2.0.3</string></dict><key>isViewVisible</key><true/></dict></array>',
+    '<key>workflowMetaData</key><dict><key>serviceApplicationBundleID</key><string>com.apple.finder</string><key>serviceInputTypeIdentifier</key><string>com.apple.cocoa.path</string><key>serviceOutputTypeIdentifier</key><string>com.apple.cocoa.path</string></dict></dict></plist>',
+].join('');
+const nautilusScript = [
+    '#!/bin/sh',
+    'for target in "$@"; do',
+    '  if command -v xdg-terminal-exec >/dev/null 2>&1; then xdg-terminal-exec --working-directory="$target" && continue; fi',
+    '  if command -v gnome-terminal >/dev/null 2>&1; then gnome-terminal --working-directory="$target" && continue; fi',
+    '  if command -v konsole >/dev/null 2>&1; then konsole --workdir "$target" && continue; fi',
+    '  xterm -e sh -lc \'cd "$1"; exec "$SHELL"\' sh "$target"',
+    'done',
+    '',
+].join('\n');
+function asStatus(target, displayName, enabled) {
+    return { target, displayName, registryKeyName: 'TerminalHere', installed: true, enabled };
+}
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class PlatformIntegration {
+    windows = new ContextMenuService(new RegExeClient());
+    async install(target = 'terminal') {
+        if (process.platform === 'win32')
+            return target === 'terminal' ? this.windows.enableAll() : [await this.windows.enable(target)];
+        if (target !== 'terminal')
+            throw new Error(`${target} is currently supported on Windows only.`);
+        if (process.platform === 'darwin') {
+            const document = join(macWorkflow, 'Contents', 'document.wflow');
+            await mkdir(dirname(document), { recursive: true });
+            await writeFile(document, finderWorkflow);
+            return [asStatus('terminal', 'Finder Quick Action: TerminalHere', true)];
+        }
+        if (process.platform === 'linux') {
+            await mkdir(dirname(linuxScript), { recursive: true });
+            await writeFile(linuxScript, nautilusScript);
+            await chmod(linuxScript, 0o755);
+            return [asStatus('terminal', 'Nautilus Script: TerminalHere', true)];
+        }
+        throw new Error(`Unsupported platform: ${process.platform}`);
+    }
+    async uninstall(target = 'terminal') {
+        if (process.platform === 'win32')
+            return target === 'terminal'
+                ? this.windows.disableAll()
+                : [await this.windows.disable(target)];
+        if (target !== 'terminal')
+            throw new Error(`${target} is currently supported on Windows only.`);
+        const path = process.platform === 'darwin'
+            ? macWorkflow
+            : process.platform === 'linux'
+                ? linuxScript
+                : undefined;
+        if (!path)
+            throw new Error(`Unsupported platform: ${process.platform}`);
+        await rm(path, { recursive: true, force: true });
+        return [
+            asStatus('terminal', process.platform === 'darwin'
+                ? 'Finder Quick Action: TerminalHere'
+                : 'Nautilus Script: TerminalHere', false),
+        ];
+    }
+    async getStatus(target) {
+        if (process.platform === 'win32')
+            return target ? [await this.windows.status(target)] : this.windows.allStatuses();
+        if (target && target !== 'terminal')
+            return [
+                {
+                    target,
+                    displayName: target,
+                    registryKeyName: 'TerminalHere',
+                    installed: false,
+                    enabled: false,
+                },
+            ];
+        if (process.platform === 'darwin')
+            return [
+                asStatus('terminal', 'Finder Quick Action: TerminalHere', await fileExists(macWorkflow)),
+            ];
+        if (process.platform === 'linux')
+            return [asStatus('terminal', 'Nautilus Script: TerminalHere', await fileExists(linuxScript))];
+        return [
+            {
+                target: 'terminal',
+                displayName: 'TerminalHere',
+                registryKeyName: 'TerminalHere',
+                installed: false,
+                enabled: false,
+            },
+        ];
+    }
+    async open(directory = process.cwd()) {
+        if (process.platform === 'win32') {
+            await execFile('wt.exe', ['-d', directory]);
+            return;
+        }
+        if (process.platform === 'darwin') {
+            await execFile('open', ['-a', 'Terminal', directory]);
+            return;
+        }
+        if (process.platform === 'linux') {
+            try {
+                await execFile('xdg-terminal-exec', [`--working-directory=${directory}`]);
+            }
+            catch {
+                await execFile('gnome-terminal', [`--working-directory=${directory}`]);
+            }
+            return;
+        }
+        throw new Error(`Unsupported platform: ${process.platform}`);
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+import type { RegistryClient } from './types.js';
+/** Windows Registry client using argument arrays: values are never shell-interpolated. */
+export declare class RegExeClient implements RegistryClient {
+    private run;
+    keyExists(path: string): Promise<boolean>;
+    setDefaultValue(path: string, value: string): Promise<void>;
+    setStringValue(path: string, name: string, value: string): Promise<void>;
+    deleteTree(path: string): Promise<void>;
+}

package/dist/registry.js

@@ -0,0 +1,37 @@
+import { execFile as execFileCallback } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFile = promisify(execFileCallback);
+const HKCU = 'HKCU\\';
+function registryPath(path) {
+    return `${HKCU}${path}`;
+}
+/** Windows Registry client using argument arrays: values are never shell-interpolated. */
+export class RegExeClient {
+    async run(args) {
+        await execFile('reg.exe', args, { windowsHide: true });
+    }
+    async keyExists(path) {
+        try {
+            await this.run(['QUERY', registryPath(path)]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async setDefaultValue(path, value) {
+        await this.run(['ADD', registryPath(path), '/ve', '/t', 'REG_SZ', '/d', value, '/f']);
+    }
+    async setStringValue(path, name, value) {
+        await this.run(['ADD', registryPath(path), '/v', name, '/t', 'REG_SZ', '/d', value, '/f']);
+    }
+    async deleteTree(path) {
+        try {
+            await this.run(['DELETE', registryPath(path), '/f']);
+        }
+        catch {
+            // Deleting a missing key is idempotent.
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC;AAEtB,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,0FAA0F;AAC1F,MAAM,OAAO,YAAY;IACf,KAAK,CAAC,GAAG,CAAC,IAAc;QAC9B,MAAM,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,KAAa;QAC/C,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa;QAC5D,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;CACF"}

package/dist/service.d.ts

@@ -0,0 +1,12 @@
+import type { RegistryClient, TerminalStatus, TerminalTarget } from './types.js';
+export declare class ContextMenuService {
+    private readonly registry;
+    constructor(registry: RegistryClient);
+    enable(target: TerminalTarget): Promise<TerminalStatus>;
+    disable(target: TerminalTarget): Promise<TerminalStatus>;
+    status(target: TerminalTarget): Promise<TerminalStatus>;
+    enableAll(): Promise<TerminalStatus[]>;
+    disableAll(): Promise<TerminalStatus[]>;
+    allStatuses(): Promise<TerminalStatus[]>;
+    private writeEntry;
+}

package/dist/service.js

@@ -0,0 +1,59 @@
+import { commandFor, detectApp, targets } from './apps.js';
+const backgroundPaths = [
+    'Software\\Classes\\Directory\\Background\\shell',
+    'Software\\Classes\\Drive\\Background\\shell',
+];
+const directoryPaths = ['Software\\Classes\\Directory\\shell', 'Software\\Classes\\Drive\\shell'];
+export class ContextMenuService {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async enable(target) {
+        const app = await detectApp(target);
+        if (!app.executablePath)
+            throw new Error(`${app.displayName} could not be found on this computer.`);
+        for (const parent of backgroundPaths)
+            await this.writeEntry(parent, app, '%V');
+        for (const parent of directoryPaths)
+            await this.writeEntry(parent, app, '%1');
+        return { ...app, installed: true, enabled: true };
+    }
+    async disable(target) {
+        const app = await detectApp(target);
+        for (const parent of [...backgroundPaths, ...directoryPaths])
+            await this.registry.deleteTree(`${parent}\\${app.registryKeyName}`);
+        return { ...app, installed: Boolean(app.executablePath), enabled: false };
+    }
+    async status(target) {
+        const app = await detectApp(target);
+        const enabled = await this.registry.keyExists(`${backgroundPaths[0]}\\${app.registryKeyName}`);
+        return { ...app, installed: Boolean(app.executablePath), enabled };
+    }
+    async enableAll() {
+        const results = [];
+        for (const target of targets) {
+            try {
+                results.push(await this.enable(target));
+            }
+            catch {
+                results.push(await this.status(target));
+            }
+        }
+        return results;
+    }
+    async disableAll() {
+        return Promise.all(targets.map((target) => this.disable(target)));
+    }
+    async allStatuses() {
+        return Promise.all(targets.map((target) => this.status(target)));
+    }
+    async writeEntry(parent, app, token) {
+        const path = `${parent}\\${app.registryKeyName}`;
+        await this.registry.setDefaultValue(path, app.displayName);
+        if (app.iconPath)
+            await this.registry.setStringValue(path, 'Icon', app.iconPath);
+        await this.registry.setDefaultValue(`${path}\\command`, commandFor(app.target, app.executablePath, token));
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export type TerminalTarget = 'terminal' | 'powershell' | 'cmd' | 'gitbash' | 'vscode';
+export interface AppInfo {
+    target: TerminalTarget;
+    displayName: string;
+    registryKeyName: string;
+    executablePath?: string;
+    iconPath?: string;
+}
+export interface TerminalStatus extends AppInfo {
+    installed: boolean;
+    enabled: boolean;
+}
+export interface RegistryClient {
+    keyExists(path: string): Promise<boolean>;
+    setDefaultValue(path: string, value: string): Promise<void>;
+    setStringValue(path: string, name: string, value: string): Promise<void>;
+    deleteTree(path: string): Promise<void>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@terminalhere/cli",
+  "version": "0.2.0",
+  "description": "Manage Windows Explorer terminal context-menu entries from npm.",
+  "type": "module",
+  "bin": {
+    "terminalhere": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": "./dist/index.js",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "windows",
+    "macos",
+    "linux",
+    "context-menu",
+    "terminal",
+    "explorer",
+    "finder",
+    "nautilus",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mehmetduran932/terminalhere-npm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mehmetduran932/terminalhere-npm/issues"
+  },
+  "homepage": "https://github.com/mehmetduran932/terminalhere-npm#readme",
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}