File naming fixes + unification

Author: Explosion-Scratch

.dir2md.json

@@ -1,15 +1,23 @@
 {
   "selectedFiles": [
-    "lib/utils.js",
+    ".dir2md.json",
+    ".github/workflows/build-release.yml",
+    ".gitignore",
+    ".npmignore",
+    "README.md",
+    "build.sh",
+    "index.js",
+    "jsconfig.json",
     "lib/config.js",
+    "lib/installer.js",
+    "lib/installers.js",
     "lib/search.js",
     "lib/sources.js",
     "lib/updater.js",
-    "lib/installer.js",
-    "lib/installers.js",
-    "index.js"
+    "lib/utils.js",
+    "package.json"
   ],
-  "prompt": "Why is dmg installation not working - additionally when downloading a file from github or somewhere else log the full path to the downloaded file in its temp dir.",
-  "timestamp": "2025-08-14T21:11:52.711Z",
-  "cwd": "/Users/tjs/Documents/.coding/repos/justinstall"
+  "timestamp": "2025-09-09T00:06:22.210Z",
+  "cwd": "/Users/tjs/Documents/.coding/repos/justinstall",
+  "prompt": "Find bugs comprehensively across this project then make a plan to fix them, finally write out the fixed code. Adhere to clean code principles"
 }

.github/workflows/build-release.yml

@@ -88,7 +88,7 @@ jobs:
         for platform in "${!EXPECTED_BINARIES[@]}"; do
           binary="${EXPECTED_BINARIES[$platform]}"
           if [[ -f "$BUILD_DIR/$binary" ]]; then
-            size=$(stat -f%z "$BUILD_DIR/$binary" 2>/dev/null || stat -c%s "$BUILD_DIR/$binary" 2>/dev/null)
+            size=$(stat -c%s "$BUILD_DIR/$binary" 2>/dev/null)
             echo "✅ $platform: $binary (${size} bytes)"
           else
             echo "❌ Missing $platform binary: $binary"
@@ -157,4 +157,4 @@ jobs:
         fail_on_unmatched_files: true
         generate_release_notes: false
       env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -38,39 +38,3 @@ You can find the latest pre-releases in the [releases page](https://github.com/E
 (Add installation instructions here, e.g., how to download and set up the tool)
 
 ## Usage
-```
-justinstall <github-url|file-url|local-file>
-	v1.0.0 - Just install anything. Supports .tar.gz, .zip, .dmg, .app, .pkg, and .deb files. Binaries will be installed to ~/.local/bin.
-
-	Example:
-		justinstall atuinsh/atuin
-		justinstall https://github.com/junegunn/fzf/
-		justinstall https://dl.google.com/chrome/mac/universal/stable/GGRO/googlechrome.dmg
-		justinstall tailscale.pkg
-```
-
-## Supported Installation Methods
-
-1. GitHub Repositories: Automatically fetches the latest release and selects the most compatible asset. **or** finds snippets from release notes and README files using hueristics.
-2. Direct URLs: Downloads and installs files from direct links.
-3. Local Files: Installs software from files already present on the local system.
-
-## Contributing
-
-
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## Acknowledgements
-
-Created by [Explosion-Scratch](https://github.com/explosion-scratch)
-
-## Disclaimer
-Don't use on windows. I don't have windows so I haven't tested it on windows. It would probably still work well for binaries though.
-
-This tool attempts to install software as safely as possible, but I'm not responsible if you install malware of if this breaks your system or harms anything in any way directly or indirectly. Always verify the source and contents of packages before installation.
-
-Less scary note: I've included confirmations for many operations as a failsafe.
-
-### Why's does the recording have errors:
-<small>Ignore the mise errors, I uninstalled it before recording to install it again. Also the regex thought it detected an install script but it didn't.</small>

build.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
+set -e
+
 rm -rf build
-mkdir build
+mkdir -p build
 
 VERSION=$(cat package.json | jq -r '.version')
 bun build --compile --target=bun-linux-x64 index.js --outfile build/justinstall-$VERSION-linux-x64
 bun build --compile --target=bun-linux-arm64 index.js --outfile build/justinstall-$VERSION-linux-arm64
-bun build --compile --target=bun-windows-x64 index.js --outfile build/justinstall-$VERSION-windows-x64
+bun build --compile --target=bun-windows-x64 index.js --outfile build/justinstall-$VERSION-windows-x64.exe
 bun build --compile --target=bun-darwin-x64 index.js --outfile build/justinstall-$VERSION-darwin-x64
 bun build --compile --target=bun-darwin-arm64 index.js --outfile build/justinstall-$VERSION-darwin-arm64

index.js

@@ -41,7 +41,7 @@ const HELP = `justinstall <github-url|website-url|file-url|local-file> [options]
 \tExamples:
 \t  justinstall atuinsh/atuin
 \t  justinstall https://github.com/junegunn/fzf/
-\t  justinstall https://github.com/Explosion-Scratch/whisper-mac/releases/tag/v1.0.0-pre-41e7098-20250906-154430
+\t  justinstall https://github.com/Explosion-Scratch/whisper-mac
 \t  justinstall https://example.com/downloads/
 \t  justinstall https://dl.google.com/chrome/mac/universal/stable/GGRO/googlechrome.dmg
 \t  justinstall tailscale.pkg

lib/config.js

@@ -103,12 +103,16 @@ const extractName = (selected) => {
   return selected.name
     .replace(/\.(tar\.gz|zip|dmg|pkg|deb|app)$/i, "")
     .replace(/v?[0-9]+\.[0-9]+\.[0-9]+/i, "")
-    .replace(
-      /(?:darwin|linux|windows|mac|osx|x64|arm64|aarch64|universal)/gi,
-      ""
-    )
-    .replace(/[ _\-\.]+$/, "")
-    .replace(/^[ _\-\.]+/, "");
+    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
+    .replace(/(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
+    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)$/gi, "")
+    .replace(/^(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]+/gi, "")
+    .replace(/[0-9]+\.[0-9]+\.[0-9]+/i, "")
+    .replace(/[-_]+$/, "")
+    .replace(/^[-_]+/, "")
+    .replace(/[-_]{2,}/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .replace(/os$/, "");
 };
 
 module.exports = {

lib/installer.js

@@ -1,6 +1,7 @@
 const fs = require("fs");
 const path = require("path");
 const { execSync } = require("child_process");
+const os = require("os");
 
 const {
   parseSource,
@@ -62,7 +63,6 @@ const performInstallation = async (args, isUpdate = false) => {
   const customFilePath = args[1]; // For update with custom file path
 
   tmpdir = execSync("mktemp -d").toString().trim();
-  process.chdir(tmpdir);
 
   const platformInfo = getPlatformInfo();
   const capabilities = getInstallCapabilities();
@@ -177,10 +177,11 @@ const handleFileSource = async (source, customFilePath, log) => {
   log.debug(`Installing from local file: ${filePath}`);
 
   const stats = fs.statSync(filePath);
+  const basename = path.basename(filePath);
   return {
-    name: path.basename(filePath),
+    name: extractName({ name: basename }),
     size: stats.size,
-    extension: require("./sources").getExtension(path.basename(filePath)),
+    extension: require("./sources").getExtension(basename),
     localPath: filePath,
   };
 };
@@ -220,10 +221,6 @@ const handleSmartUrlSource = async (
     // It was a direct download
     log.debug(`Direct download: ${result.filename} (${result.size} bytes)`);
 
-    // Write the buffer to a temporary file
-    const tempFilename = path.join(tmpdir, result.filename);
-    fs.writeFileSync(tempFilename, result.buffer);
-
     const extension = require("./sources").getExtension(result.filename);
 
     return {
@@ -232,7 +229,7 @@ const handleSmartUrlSource = async (
         size: result.size,
         extension: extension,
         browser_download_url: result.url,
-        localPath: tempFilename,
+        localPath: result.localPath,
       },
       releaseInfo: { body: `Direct download of ${result.filename}` },
     };
@@ -585,8 +582,10 @@ const installSelected = async (selected, downloadPath, log) => {
       installationMethod = "dmg";
 
       try {
-        mountDMG(downloadPath, outputDir, log);
-        const dmgBinaries = getBinaries(outputDir);
+        const mountDir = path.join(tmpdir, "dmg-mount");
+        fs.mkdirSync(mountDir, { recursive: true });
+        mountDMG(downloadPath, mountDir, log);
+        const dmgBinaries = getBinaries(mountDir);
         log.debug(
           `Found ${dmgBinaries.length} items in DMG: ${dmgBinaries.join(", ")}`,
         );
@@ -596,7 +595,7 @@ const installSelected = async (selected, downloadPath, log) => {
 
         if (appFile) {
           log.log(`Installing .app bundle: ${appFile}`);
-          destinations = await installApp(appFile, outputDir, checkPath, log);
+          destinations = await installApp(appFile, mountDir, checkPath, log);
           binariesList = [appFile];
 
           // Ask to open app
@@ -605,7 +604,7 @@ const installSelected = async (selected, downloadPath, log) => {
           }
         } else if (pkgFile) {
           log.log(`Installing .pkg file: ${pkgFile}`);
-          destinations = installPkg(path.join(outputDir, pkgFile));
+          destinations = installPkg(path.join(mountDir, pkgFile));
           binariesList = [pkgFile];
         } else if (dmgBinaries.length > 0) {
           // Handle DMGs with executables but no .app or .pkg
@@ -614,7 +613,7 @@ const installSelected = async (selected, downloadPath, log) => {
           );
           destinations = await installBinaries(
             dmgBinaries,
-            outputDir,
+            mountDir,
             selected.name,
             checkPath,
             log,
@@ -639,7 +638,7 @@ const installSelected = async (selected, downloadPath, log) => {
     case "app":
       installationMethod = "app";
       destinations = await installApp(
-        selected.name,
+        path.basename(selected.name),
         path.dirname(downloadPath),
         checkPath,
         log,

lib/installers.js

@@ -60,12 +60,12 @@ const getInstallCapabilities = () => {
   };
 
   return {
-    deb: process.platform === "linux" && ebool("which apt"),
+    deb: process.platform === "linux" && ebool("which dpkg"),
     dmg: process.platform === "darwin",
     pkg: process.platform === "darwin",
     app: process.platform === "darwin",
-    rpm: ebool("which dnf"),
-    "tar.zst": ebool("which pacman"),
+    rpm: process.platform === "linux" && ebool("which rpm"),
+    "tar.zst": ebool("which unzstd") || ebool("which zstd"),
   };
 };
 
@@ -178,7 +178,7 @@ const extractArchive = (filePath, outputDir, extension) => {
       break;
     case "tar.zst":
       execSync(
-        `tar -xf ${JSON.stringify(filePath)} --directory ${JSON.stringify(
+        `unzstd < ${JSON.stringify(filePath)} | tar -xf - --directory ${JSON.stringify(
           outputDir
         )}`
       );
@@ -288,10 +288,12 @@ const processExtractedPackages = async (
   if (dmgFile) {
     logger.log(`Found DMG file in ZIP: ${dmgFile}`);
     const dmgPath = path.join(outputDir, dmgFile);
+    const mountDir = path.join(outputDir, "dmg-mount");
+    fs.mkdirSync(mountDir, { recursive: true });
 
     try {
-      mountDMG(dmgPath, outputDir, logger);
-      const dmgBinaries = getBinaries(outputDir);
+      mountDMG(dmgPath, mountDir, logger);
+      const dmgBinaries = getBinaries(mountDir);
       logger.debug(
         `Found ${dmgBinaries.length} items in DMG: ${dmgBinaries.join(", ")}`
       );
@@ -301,15 +303,15 @@ const processExtractedPackages = async (
 
       if (appFile) {
         logger.log(`Installing .app bundle from DMG: ${appFile}`);
-        const destinations = await installApp(appFile, outputDir, checkPathFn, logger);
+        const destinations = await installApp(appFile, mountDir, checkPathFn, logger);
         return {
           method: "dmg_app",
           destinations,
           binaries: [appFile],
         };
       } else if (nestedPkgFile) {
         logger.log(`Installing .pkg file from DMG: ${nestedPkgFile}`);
-        const destinations = installPkg(path.join(outputDir, nestedPkgFile));
+        const destinations = installPkg(path.join(mountDir, nestedPkgFile));
         return {
           method: "dmg_pkg",
           destinations,
@@ -319,7 +321,7 @@ const processExtractedPackages = async (
         logger.log("No .app or .pkg found in DMG, trying to install executables");
         const destinations = await installBinaries(
           dmgBinaries,
-          outputDir,
+          mountDir,
           selectedName,
           checkPathFn,
           logger,
@@ -334,7 +336,7 @@ const processExtractedPackages = async (
         throw new Error("No installable files found in DMG");
       }
     } finally {
-      ejectDMG(outputDir, logger);
+      ejectDMG(mountDir, logger);
     }
   } else if (pkgFile) {
     logger.log(`Found PKG file in ZIP: ${pkgFile}`);
@@ -397,6 +399,12 @@ const installPkg = (pkgPath) => {
 
 const mountDMG = (dmgPath, mountPoint, logger = null) => {
   try {
+    // Ensure mount point is empty
+    if (fs.existsSync(mountPoint)) {
+      fs.rmSync(mountPoint, { recursive: true, force: true });
+    }
+    fs.mkdirSync(mountPoint, { recursive: true });
+
     execSync(
       `hdiutil attach ${JSON.stringify(
         dmgPath
@@ -489,7 +497,7 @@ const installBinaries = async (
 };
 
 const installDeb = (debPath) => {
-  execSync(`dpkg -i ${JSON.stringify(debPath)}`);
+  execSync(`sudo dpkg -i ${JSON.stringify(debPath)}`);
   return ["System-wide deb installation"];
 };
 

lib/search.js

@@ -13,7 +13,11 @@ const searchRepositories = async (query, options = {}) => {
   url.searchParams.set("order", order);
   url.searchParams.set("per_page", per_page);
 
-  const response = await fetch(url.toString());
+  const response = await fetch(url.toString(), {
+    headers: {
+      "User-Agent": "justinstall/1.2.0",
+    },
+  });
 
   if (!response.ok) {
     throw new Error(`GitHub API error: ${response.statusText}`);