@abhiseck/zssh 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Abhiseck Bhattacharya
+
+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,80 @@
+# sshc - SSH Chain
+
+**sshc** is a modern, cross-platform CLI tool to manage and connect to your SSH servers with encrypted local storage and cloud sync capabilities.
+
+## Features
+
+- **Secure**: All configuration is encrypted using AES-256-GCM with a master password.
+- **Cross-Platform**: Works on macOS, Windows, and Linux.
+- **Cloud Sync**: Sync your connections across devices using GitHub Gists (Encrypted).
+- **Shortcuts**: Connect to servers using short aliases or IDs.
+- **Auto-Login**: Supports password auto-fill (requires `sshpass`) and private keys.
+
+## Installation
+
+```bash
+npm install -g sshc
+```
+
+## Usage
+
+### Add a Connection
+
+```bash
+sshc add
+```
+
+Follow the interactive prompts to save your server details.
+
+### List Connections
+
+```bash
+sshc list
+```
+
+Displays a table of all saved connections.
+
+### Connect
+
+```bash
+sshc connect <alias_or_id>
+# Example:
+sshc connect my-server
+```
+
+### Remove a Connection
+
+```bash
+sshc remove <alias_or_id>
+```
+
+### Cloud Sync
+
+To enable cloud sync, you need a GitHub Personal Access Token (PAT) with `gist` scope.
+
+**Save to Cloud:**
+
+```bash
+sshc save
+```
+
+**Sync from Cloud:**
+
+```bash
+sshc sync
+```
+
+## Security
+
+Your configuration is stored in `~/.sshc.json`. The entire content is encrypted. You will be prompted for your master password when running commands.
+
+## Requirements
+
+- Node.js >= 14
+- `sshpass` (Optional, for password auto-fill)
+  - macOS: `brew install sshpass`
+  - Ubuntu: `apt-get install sshpass`
+
+## License
+
+ISC

package/dist/commands/add.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommand = addCommand;
+const chalk = __importStar(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const uuid_1 = require("uuid");
+async function addCommand(configManager) {
+    console.log(chalk.blue("Adding new SSH connection..."));
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: "input",
+            name: "host",
+            message: "Host (IP or Domain):",
+            validate: (input) => (input ? true : "Host is required"),
+        },
+        {
+            type: "input",
+            name: "port",
+            message: "Port:",
+            default: "22",
+            validate: (input) => !isNaN(parseInt(input)) ? true : "Port must be a number",
+        },
+        {
+            type: "input",
+            name: "username",
+            message: "Username:",
+            validate: (input) => (input ? true : "Username is required"),
+        },
+        {
+            type: "list",
+            name: "authType",
+            message: "Authentication Method:",
+            choices: ["Password", "Private Key", "Agent (No Password/Key stored)"],
+        },
+        {
+            type: "password",
+            name: "password",
+            message: "Password:",
+            when: (answers) => answers.authType === "Password",
+            mask: "*",
+        },
+        {
+            type: "input",
+            name: "privateKeyPath",
+            message: "Private Key Path:",
+            when: (answers) => answers.authType === "Private Key",
+            default: "~/.ssh/id_rsa",
+        },
+        {
+            type: "input",
+            name: "alias",
+            message: "Alias (short name):",
+        },
+        {
+            type: "input",
+            name: "description",
+            message: "Description (optional):",
+        },
+    ]);
+    const connection = {
+        id: (0, uuid_1.v4)().split("-")[0], // Short ID
+        alias: answers.alias,
+        host: answers.host,
+        port: parseInt(answers.port),
+        username: answers.username,
+        password: answers.password,
+        privateKeyPath: answers.privateKeyPath,
+        description: answers.description,
+        createdAt: new Date().toISOString(),
+    };
+    configManager.addConnection(connection);
+    console.log(chalk.green(`\nConnection added successfully!`));
+    console.log(`ID: ${chalk.cyan(connection.id)}`);
+    if (connection.alias)
+        console.log(`Alias: ${chalk.cyan(connection.alias)}`);
+}

package/dist/commands/connect.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectCommand = connectCommand;
+const chalk = __importStar(require("chalk"));
+const child_process_1 = require("child_process");
+async function isSshpassInstalled() {
+    return new Promise((resolve) => {
+        const check = (0, child_process_1.spawn)("command", ["-v", "sshpass"]);
+        check.on("close", (code) => {
+            resolve(code === 0);
+        });
+    });
+}
+async function connectCommand(configManager, idOrAlias) {
+    const conn = configManager.getConnection(idOrAlias);
+    if (!conn) {
+        console.log(chalk.red(`Connection not found: ${idOrAlias}`));
+        return;
+    }
+    console.log(chalk.blue(`Connecting to ${conn.alias || conn.id} (${conn.username}@${conn.host})...`));
+    const args = [];
+    // Port
+    if (conn.port) {
+        args.push("-p", conn.port.toString());
+    }
+    // Identity file
+    if (conn.privateKeyPath) {
+        args.push("-i", conn.privateKeyPath);
+    }
+    // Destination
+    args.push(`${conn.username}@${conn.host}`);
+    let command = "ssh";
+    let finalArgs = args;
+    const env = { ...process.env };
+    // Handle Password
+    if (conn.password) {
+        const hasSshpass = await isSshpassInstalled();
+        if (hasSshpass) {
+            command = "sshpass";
+            // options for sshpass
+            // -p password
+            // We can also use SSHPASS env var to avoid showing in process list (slightly safer)
+            env["SSHPASS"] = conn.password;
+            finalArgs = ["-e", "ssh", ...args]; // -e means take password from env
+        }
+        else {
+            console.log(chalk.yellow('Warning: "sshpass" is not installed.'));
+            console.log(chalk.yellow("Cannot auto-fill password. You will be prompted by SSH."));
+            console.log(chalk.dim('Install sshpass (e.g. "brew install sshpass" on Mac) to enable auto-login.'));
+        }
+    }
+    const child = (0, child_process_1.spawn)(command, finalArgs, {
+        stdio: "inherit",
+        env: env,
+    });
+    child.on("close", (code) => {
+        if (code !== 0) {
+            console.log(chalk.red(`\nSSH session ended with code ${code}`));
+        }
+        else {
+            console.log(chalk.green("\nDisconnected."));
+        }
+    });
+}

package/dist/commands/list.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCommand = listCommand;
+const chalk = __importStar(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+async function listCommand(configManager) {
+    const connections = configManager.getConnections();
+    if (connections.length === 0) {
+        console.log(chalk.yellow('No connections found. Use "sshc add" to add one.'));
+        return;
+    }
+    const table = new cli_table3_1.default({
+        head: [
+            chalk.cyan("ID"),
+            chalk.cyan("Alias"),
+            chalk.cyan("Host"),
+            chalk.cyan("User"),
+            chalk.cyan("Port"),
+        ],
+        style: { head: [], border: [] },
+    });
+    connections.forEach((conn) => {
+        table.push([
+            conn.id,
+            conn.alias || "",
+            conn.host,
+            conn.username,
+            conn.port,
+        ]);
+    });
+    console.log(table.toString());
+}

package/dist/commands/remove.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeCommand = removeCommand;
+const chalk = __importStar(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+async function removeCommand(configManager, idOrAlias) {
+    const conn = configManager.getConnection(idOrAlias);
+    if (!conn) {
+        console.log(chalk.red(`Connection not found: ${idOrAlias}`));
+        return;
+    }
+    const { confirm } = await inquirer_1.default.prompt([
+        {
+            type: "confirm",
+            name: "confirm",
+            message: `Are you sure you want to delete ${conn.alias || conn.id} (${conn.username}@${conn.host})?`,
+            default: false,
+        },
+    ]);
+    if (confirm) {
+        configManager.removeConnection(idOrAlias);
+        console.log(chalk.green("Connection removed."));
+    }
+}

package/dist/commands/sync.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveCommand = saveCommand;
+exports.syncCommand = syncCommand;
+const axios_1 = __importDefault(require("axios"));
+const chalk = __importStar(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const GITHUB_API = "https://api.github.com";
+async function getGithubToken(configManager) {
+    const config = configManager.getConfig();
+    if (config.githubToken) {
+        return config.githubToken;
+    }
+    const { token } = await inquirer_1.default.prompt([
+        {
+            type: "password", // or input? token is long.
+            name: "token",
+            message: "Enter GitHub Personal Access Token (with gist scope):",
+            mask: "*",
+        },
+    ]);
+    configManager.setGithubToken(token);
+    return token;
+}
+async function saveCommand(configManager) {
+    const token = await getGithubToken(configManager);
+    const config = configManager.getConfig();
+    const encryptedContent = configManager.getEncryptedContent(); // We need a way to get raw encrypted string
+    if (!encryptedContent) {
+        console.log(chalk.red("Error: Could not retrieve encrypted config."));
+        return;
+    }
+    const files = {
+        "sshc_config.lock": {
+            content: encryptedContent,
+        },
+    };
+    try {
+        if (config.gistId) {
+            // Update existing Gist
+            console.log(chalk.blue("Updating existing Gist..."));
+            await axios_1.default.patch(`${GITHUB_API}/gists/${config.gistId}`, { files }, {
+                headers: { Authorization: `token ${token}` },
+            });
+            console.log(chalk.green("Config saved to Gist successfully."));
+        }
+        else {
+            // Create new Gist
+            console.log(chalk.blue("Creating new Gist..."));
+            const response = await axios_1.default.post(`${GITHUB_API}/gists`, {
+                description: "SSHC Encrypted Config",
+                public: false,
+                files,
+            }, {
+                headers: { Authorization: `token ${token}` },
+            });
+            const gistId = response.data.id;
+            configManager.setGistId(gistId);
+            console.log(chalk.green(`Gist created with ID: ${gistId}`));
+            console.log(chalk.green("Config saved to Gist successfully."));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to save to Gist:"), error.response?.data?.message || error.message);
+    }
+}
+async function syncCommand(configManager) {
+    const token = await getGithubToken(configManager);
+    let { gistId } = configManager.getConfig();
+    if (!gistId) {
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: "input",
+                name: "gistId",
+                message: "Enter Gist ID to sync with:",
+            },
+        ]);
+        gistId = answer.gistId;
+        configManager.setGistId(gistId);
+    }
+    try {
+        console.log(chalk.blue("Fetching Gist..."));
+        const response = await axios_1.default.get(`${GITHUB_API}/gists/${gistId}`, {
+            headers: { Authorization: `token ${token}` },
+        });
+        const file = response.data.files["sshc_config.lock"];
+        if (!file) {
+            console.log(chalk.red("Invalid Gist: sshc_config.lock not found."));
+            return;
+        }
+        const encryptedContent = file.content;
+        // Merge strategy:
+        // 1. Decrypt remote content
+        // 2. Merge connections (Remote adds to Local)
+        // 3. Save merged to Local
+        // 4. (Optional) Push back to Remote? No, `sync` in this context usually means "pull and apply".
+        // Use `save` to push.
+        const merged = configManager.mergeEncrypted(encryptedContent);
+        if (merged) {
+            console.log(chalk.green("Sync completed. Remote changes merged into local config."));
+        }
+        else {
+            console.log(chalk.yellow("Sync completed but no changes were made or merge failed."));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to sync with Gist:"), error.response?.data?.message || error.message);
+    }
+}