@indah_sekar/os-t 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# OS Troubleshooter
+
+Quick access to common troubleshooting commands for **Windows**, **Linux**, and **macOS**.
+
+Available as a **web app** and a **CLI tool**.
+
+## Install (CLI)
+
+```bash
+npm install -g os-t
+```
+
+## CLI Usage
+
+```bash
+# Show help
+os-t --help
+
+# List all commands
+os-t --list
+
+# List commands for a specific OS
+os-t --os linux --list
+
+# List commands in a category
+os-t --os windows --category Network --list
+
+# Search for a command
+os-t --search ping
+
+# Get a specific command
+os-t "Flush DNS Cache"
+
+# Filter by OS
+os-t --os macos "System Info"
+
+# Copy command to clipboard
+os-t --copy "Flush DNS Cache"
+```
+
+## Web App
+
+```bash
+npm install
+npm run dev
+```
+
+Open [http://localhost:5173](http://localhost:5173) in your browser.
+
+## Build
+
+```bash
+npm run build
+npm run preview
+```
+
+## Programmatic Usage (import as module)
+
+```js
+import commands from "os-t";
+
+// commands.windows, commands.linux, commands.macos
+```
+
+## Features
+
+- **Multi-OS Support** — Windows, Linux, and macOS troubleshooting commands
+- **Categorized Commands** — Network, System, Process & Services, Disk, Power, Logs, and more
+- **Search & Filter** — Instantly find commands by name, description, or keyword
+- **Dropdown Selector** — Select commands from a dropdown with detail preview
+- **One-Click Copy** — Copy any command to clipboard
+- **Simulated Terminal** — Execute commands and view history in a visual terminal panel
+- **Recently Used** — Quick access to your most frequently used commands
+- **Export History** — Download terminal history as a text file
+- **Difficulty Indicators** — See at a glance whether a command is easy, medium, or hard
+- **CLI Tool** — Use from the command line after `npm install -g`

package/bin/cli.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+
+import { readFileSync } from "fs";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const commandsPath = join(__dirname, "..", "dist", "data", "commands.json");
+let commands;
+try {
+  commands = JSON.parse(readFileSync(commandsPath, "utf-8"));
+} catch {
+  const srcPath = join(__dirname, "..", "src", "data", "commands.json");
+  commands = JSON.parse(readFileSync(srcPath, "utf-8"));
+}
+
+const args = process.argv.slice(2);
+
+function printHelp() {
+  console.log(`
+  OS Troubleshooter - Quick troubleshooting commands for Windows, Linux & macOS
+
+  Usage:
+    os-troubleshooter [options] [command-name]
+
+  Options:
+    --help, -h       Show this help message
+    --list, -l       List all available commands
+    --os <os>        Filter by OS (windows, linux, macos). Default: all
+    --category <cat> Filter by category
+    --search <query> Search commands by name/description
+    --copy           Copy command to clipboard (requires xclip/xsel/pbcopy)
+
+  Examples:
+    os-troubleshooter --list
+    os-troubleshooter --os linux --list
+    os-troubleshooter "Flush DNS Cache"
+    os-troubleshooter --os windows "System File Checker"
+    os-troubleshooter --search ping
+    os-troubleshooter --category Network --os linux
+    os-troubleshooter --copy "Flush DNS Cache"
+`);
+}
+
+function listCommands(osFilter, categoryFilter, searchQuery) {
+  const osList = osFilter ? [osFilter] : Object.keys(commands);
+
+  let total = 0;
+  for (const os of osList) {
+    if (!commands[os]) {
+      console.log(
+        `\n  Unknown OS: "${os}". Available: ${Object.keys(commands).join(", ")}`,
+      );
+      continue;
+    }
+    const categories = commands[os];
+    for (const cat of categories) {
+      if (
+        categoryFilter &&
+        cat.category.toLowerCase() !== categoryFilter.toLowerCase()
+      ) {
+        continue;
+      }
+      let cmds = cat.commands;
+      if (searchQuery) {
+        const q = searchQuery.toLowerCase();
+        cmds = cmds.filter(
+          (c) =>
+            c.name.toLowerCase().includes(q) ||
+            c.description.toLowerCase().includes(q) ||
+            c.command.toLowerCase().includes(q),
+        );
+      }
+      if (cmds.length === 0) continue;
+      console.log(`\n  [${os.toUpperCase()}] ${cat.category}`);
+      console.log("  " + "-".repeat(50));
+      for (const cmd of cmds) {
+        console.log(`    ${cmd.name}`);
+        console.log(`      ${cmd.description}`);
+        console.log(`      $ ${cmd.command}`);
+        console.log();
+        total++;
+      }
+    }
+  }
+  console.log(`  Total: ${total} command(s)`);
+}
+
+function findCommand(query) {
+  const q = query.toLowerCase();
+  const results = [];
+  for (const [os, categories] of Object.entries(commands)) {
+    for (const cat of categories) {
+      for (const cmd of cat.commands) {
+        if (
+          cmd.name.toLowerCase().includes(q) ||
+          cmd.command.toLowerCase().includes(q) ||
+          cmd.description.toLowerCase().includes(q)
+        ) {
+          results.push({ os, category: cat.category, ...cmd });
+        }
+      }
+    }
+  }
+  return results;
+}
+
+function copyToClipboard(text) {
+  const platform = process.platform;
+  try {
+    if (platform === "darwin") {
+      execSync("pbcopy", { input: text });
+    } else if (platform === "linux") {
+      try {
+        execSync("xclip -selection clipboard", { input: text });
+      } catch {
+        execSync("xsel --clipboard --input", { input: text });
+      }
+    } else if (platform === "win32") {
+      execSync("clip", { input: text });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function prepareCommand(cmd, os) {
+  if (os === "linux") {
+    if (cmd.startsWith("sudo ")) return cmd;
+    return `sudo ${cmd}`;
+  }
+  if (os === "macos") {
+    if (cmd.startsWith("sudo ")) return cmd;
+    return `sudo ${cmd}`;
+  }
+  return cmd;
+}
+
+function printResults(results) {
+  for (const r of results) {
+    const finalCmd = prepareCommand(r.command, r.os);
+    console.log(`\n  [${r.os.toUpperCase()}] ${r.category}`);
+    console.log(`  Name:        ${r.name}`);
+    console.log(`  Description: ${r.description}`);
+    console.log(`  Difficulty:  ${r.difficulty}`);
+    console.log(`  Command:`);
+    console.log(`    $ ${finalCmd}`);
+    console.log();
+  }
+  console.log(`  Found: ${results.length} command(s)`);
+}
+
+function main() {
+  if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+    printHelp();
+    return;
+  }
+
+  const osFlag = args.indexOf("--os");
+  let osFilter = null;
+  let filteredArgs = [...args];
+  if (osFlag !== -1 && args[osFlag + 1]) {
+    osFilter = args[osFlag + 1].toLowerCase();
+    filteredArgs.splice(osFlag, 2);
+  }
+
+  const catFlag = args.indexOf("--category");
+  let categoryFilter = null;
+  if (catFlag !== -1 && args[catFlag + 1]) {
+    categoryFilter = args[catFlag + 1];
+    const catIdx = filteredArgs.indexOf("--category");
+    filteredArgs.splice(catIdx, 2);
+  }
+
+  const searchFlag = args.indexOf("--search");
+  let searchQuery = null;
+  if (searchFlag !== -1 && args[searchFlag + 1]) {
+    searchQuery = args[searchFlag + 1];
+    const searchIdx = filteredArgs.indexOf("--search");
+    filteredArgs.splice(searchIdx, 2);
+  }
+
+  const shouldCopy = filteredArgs.includes("--copy");
+  filteredArgs = filteredArgs.filter((a) => a !== "--copy");
+
+  if (filteredArgs.includes("--list") || filteredArgs.includes("-l")) {
+    listCommands(osFilter, categoryFilter, searchQuery);
+    return;
+  }
+
+  const query = filteredArgs.join(" ");
+  if (!query && !searchQuery && !categoryFilter) {
+    printHelp();
+    return;
+  }
+
+  const finalQuery = searchQuery || query;
+  const results = findCommand(finalQuery);
+
+  if (results.length === 0) {
+    console.log(`\n  No commands found matching "${finalQuery}"`);
+    console.log(
+      "  Try: os-troubleshooter --list to see all available commands\n",
+    );
+    return;
+  }
+
+  if (osFilter) {
+    const filtered = results.filter((r) => r.os === osFilter);
+    if (filtered.length === 0) {
+      console.log(
+        `\n  No commands found matching "${finalQuery}" for ${osFilter}`,
+      );
+      return;
+    }
+    printResults(filtered);
+    if (shouldCopy && filtered.length === 1) {
+      const cmdToSend = prepareCommand(filtered[0].command, filtered[0].os);
+      const copied = copyToClipboard(cmdToSend);
+      if (copied) {
+        console.log("  Command copied to clipboard!");
+      } else {
+        console.log(
+          "  Failed to copy. Install xclip or xsel for clipboard support.",
+        );
+      }
+    }
+  } else {
+    printResults(results);
+    if (shouldCopy && results.length === 1) {
+      const cmdToSend = prepareCommand(results[0].command, results[0].os);
+      const copied = copyToClipboard(cmdToSend);
+      if (copied) {
+        console.log("  Command copied to clipboard!");
+      } else {
+        console.log(
+          "  Failed to copy. Install xclip or xsel for clipboard support.",
+        );
+      }
+    }
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@indah_sekar/os-t",
+  "version": "1.0.0",
+  "description": "Quick troubleshooting commands for Windows, Linux & macOS. CLI tool + web app.",
+  "keywords": [
+    "troubleshooting",
+    "windows",
+    "linux",
+    "macos",
+    "commands",
+    "cli",
+    "system-admin",
+    "network",
+    "diagnostics"
+  ],
+  "homepage": "https://github.com/indah0503/os-t#readme",
+  "bugs": {
+    "url": "https://github.com/indah0503/os-t/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/indah0503/os-t.git"
+  },
+  "license": "MIT",
+  "author": "indah sekar",
+  "type": "module",
+  "exports": {
+    ".": "./src/data/commands.json",
+    "./data": "./src/data/commands.json"
+  },
+  "main": "./src/data/commands.json",
+  "bin": {
+    "os-troubleshooter": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/data/commands.json",
+    "src/data/commands.js"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "start": "node server.js",
+    "lint": "oxlint",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.3",
+    "oxlint": "^1.71.0",
+    "vite": "^8.1.1"
+  }
+}