git0 0.2.12 → 0.2.14

package/docs-config/src/functions/index.md

@@ -1,28 +1,14 @@
 <p align="center">
-    <img  src="https://i.imgur.com/poOtI3N.png" />
+    <img  src="https://i.imgur.com/RLXLAzY.png" />
 </p>
 <p align="center">
-    <a href="https://discord.gg/SJdBqBz3tV">
-        <img src="https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat"
-            alt="Join Discord" />
-    </a>
-     <a href="https://github.com/vtempest/git0/discussions">
-     <img alt="GitHub Stars" src="https://img.shields.io/github/stars/vtempest/git0" /></a>
-    <a href="https://github.com/vtempest/git0/discussions">
-    <img alt="GitHub Discussions"
-        src="https://img.shields.io/github/discussions/vtempest/git0" />
-    </a>
-    <a href="https://github.com/vtempest/git0/pulse" alt="Activity">
-        <img src="https://img.shields.io/github/commit-activity/m/vtempest/git0" />
-    </a>
-    <img src="https://img.shields.io/github/last-commit/vtempest/git0.svg?style=flat-square" alt="GitHub last commit" />
-</p>
-<p align="center">
-        <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"
-            alt="PRs Welcome" />
-    <a href="https://codespaces.new/vtempest/git0">
-    <img src="https://github.com/codespaces/badge.svg" width="150" height="20" />
-    </a>
+    <a href="https://discord.gg/SJdBqBz3tV"><img src="https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat"/></a>
+    <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/vtempest/git0" /></a>
+    <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/vtempest/git0" /></a>
+    <a href="https://github.com/vtempest/git0/pulse" alt="Activity"><img src="https://img.shields.io/github/commit-activity/m/vtempest/git0" /></a>
+    <img src="https://img.shields.io/github/last-commit/vtempest/git0.svg" alt="GitHub last commit" />
+    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" />
+    <a href="https://codespaces.new/vtempest/git0"><img src="https://github.com/codespaces/badge.svg" width="150" height="20" /></a>
 </p>  
 
 # Git0: Download Git Repo on Step Zero 
@@ -46,26 +32,28 @@ bun install -g git0
 - **Search GitHub repositories** by name with fuzzy matching
 - **Download repositories** directly from GitHub URLs or owner/repo shortcuts. Skip the manual git clone, cd, install dance
 - **Get Releases** instantly download latest release for your system or all systems
-- **Automatic dependency detection** and installation for multiple project types
+- **Automatic dependency installation** and installation for multiple project types
 - **Smart IDE integration** - automatically opens projects in your preferred editor
 - **Cross-platform support** - works on Windows, macOS, and Linux
 - **Conflict resolution** - handles directory naming conflicts automatically
+- **Faster than git** - skips `.git` history and uncompresses while downloading
 
 ## 🎯 Usage
 
 ```bash
-# Search for repositories by name
-gg react starter
 
 # Direct download from GitHub URL
-## gg and git0 both work
-gg https://github.com/facebook/react
+## g and git0 both work
+g https://github.com/facebook/react
+
+# Search for repositories by name
+g react starter
 
 # Download using owner/repo shorthand
-git0 react starter
+git0 facebook/react
 
-## Use git0 without installing, (only node needed)
-# (copy into your project's readme for quick setup)
+# Use git0 without installing, (only node needed)
+# (copy this line into your project's readme to help others setup)
 npx git0 facebook/react
 ```
 
@@ -90,6 +78,7 @@ git0 automatically detects and opens projects in your preferred IDE:
 - **VS Code** (`code`)
 - **Code Server** (`code-server`)
 - **Neovim** (`nvim`)
+- **Webstorm** (`webstorm`)
 
 ## 🔧 Configuration
 

package/docs-config/src/functions/modules.md

@@ -1,4 +1,5 @@
 ## Modules
 
+- [fm](fm.md)
 - [git0](git0.md)
 - [github-api](github-api.md)

package/docs-config/src/functions/typedoc-sidebar.cjs

@@ -2,6 +2,11 @@
 /** @type {import("@docusaurus/plugin-content-docs").SidebarsConfig} */
 const typedocSidebar = {
   items: [
+    {
+      type: "doc",
+      id: "functions/fm",
+      label: "fm"
+    },
     {
       type: "doc",
       id: "functions/git0",

package/docs-config/src/pages/index.tsx

@@ -171,10 +171,9 @@ function App() {
     script.id = 'tailwind-cdn';
     script.src = "https://cdn.tailwindcss.com";
     script.async = true;
+    script.onload = () => setIsLoaded(true); // Only called when Tailwind is actually loaded
     document.head.appendChild(script);
-    setTimeout(() =>
-      setIsLoaded(true),
-      900)
+
   }, []);
 
   const copyToClipboard = (text: string, command: string) => {

package/package.json

@@ -1,8 +1,15 @@
 {
     "name": "git0",
     "description": "CLI tool to search GitHub repositories, download source & releases for your system, and instantly set up, then install dependencies and open code editor.",
-    "version": "0.2.12",
+    "version": "0.2.14",
     "author": "vtempest",
+    "scripts": {
+        "build": "bun build src/cli.ts --outdir dist --target node --format esm --sourcemap",
+        "test": "bun test",
+        "docs": "cd docs-config && bun run build:docs",
+        "demo": "bun src/cli.ts react template",
+        "publish:npm": "npm version patch && npm publish --access public"
+    },
     "dependencies": {
         "chalk": "^5.4.1",
         "git-url-parse": "^16.1.0",
@@ -12,24 +19,27 @@
         "tar": "^7.4.3"
     },
     "exports": {
-        ".": "./src/github-api.js"
+        ".": "./dist/cli.js"
     },
     "bin": {
-        "g": "./src/git0.js",
-        "gg": "./src/git0.js",
+        "g": "./dist/cli.js",
+        "gg": "./dist/cli.js",
         "fm": "./src/fm.js",
-        "git0": "./src/git0.js"
+        "git0": "./dist/cli.js"
     },
+    "type": "module",
     "keywords": [
         "github",
+        "git",
+        "package",
+        "manager",
         "cli",
         "download"
     ],
     "license": "MIT",
-    "scripts": {
-        "docs": "cd docs-config && bun run build:docs",
-        "demo": "bun src/git0.js react template",
-        "publish:npm": "npm version patch && npm publish --access public"
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/OpenSourceAGI/appdemo-dev-tools/tree/master/packages/git0-repo-downloader"
     },
-    "type": "module"
+    "homepage": "https://github.com/OpenSourceAGI/appdemo-dev-tools/tree/master/packages/git0-repo-downloader"
 }

package/readme.md

@@ -1,21 +1,21 @@
 <p align="center">
-    <img  src="https://i.imgur.com/poOtI3N.png" />
+    <img  src="https://i.imgur.com/td0AVb7.png" />
 </p>
 <p align="center">
     <a href="https://discord.gg/SJdBqBz3tV"><img src="https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat"/></a>
     <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/vtempest/git0" /></a>
     <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/vtempest/git0" /></a>
     <a href="https://github.com/vtempest/git0/pulse" alt="Activity"><img src="https://img.shields.io/github/commit-activity/m/vtempest/git0" /></a>
+    <br />
     <img src="https://img.shields.io/github/last-commit/vtempest/git0.svg" alt="GitHub last commit" />
     <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" />
     <a href="https://codespaces.new/vtempest/git0"><img src="https://github.com/codespaces/badge.svg" width="150" height="20" /></a>
-</p>  
+</p>
 
+# Step 0: Download Git Repo
 
-# Git0: Download Git Repo on Step Zero 
 CLI tool to search GitHub repositories, download source & releases for your system, and instantly set up, then install dependencies and open code editor.
 
-
 ## 🚀 Installation
 
 ```bash
@@ -29,7 +29,6 @@ bun install -g git0
 ![livepreview](https://i.imgur.com/Io3ukRC.gif)
 ![preview](https://i.imgur.com/K22NiBq.png)
 
-
 ## ✨ Features
 
 - **Search GitHub repositories** by name with fuzzy matching
@@ -41,7 +40,6 @@ bun install -g git0
 - **Conflict resolution** - handles directory naming conflicts automatically
 - **Faster than git** - skips `.git` history and uncompresses while downloading
 
-
 ## 🎯 Usage
 
 ```bash
@@ -65,28 +63,28 @@ npx git0 facebook/react
 
 git0 automatically detects and sets up the following project types:
 
-| Project Type | Detection | Installation |
-|-------------|-----------|-------------|
-| **Node.js** | `package.json` | `bun install` (fallback to `npm install`) |
-| **Docker** | `Dockerfile`, `docker-compose.yml` | `docker-compose up -d` or `docker build` |
-| **Python** | `requirements.txt`, `setup.py` | Virtual environment + pip install |
-| **Rust** | `Cargo.toml` | `cargo build` |
-| **Go** | `go.mod` | `go mod tidy` |
+| Project Type      | Detection                              | Installation                                  |
+| ----------------- | -------------------------------------- | --------------------------------------------- |
+| **Node.js** | `package.json`                       | `bun install` (fallback to `npm install`) |
+| **Docker**  | `Dockerfile`, `docker-compose.yml` | `docker-compose up -d` or `docker build`  |
+| **Python**  | `requirements.txt`, `setup.py`     | Virtual environment + pip install             |
+| **Rust**    | `Cargo.toml`                         | `cargo build`                               |
+| **Go**      | `go.mod`                             | `go mod tidy`                               |
 
 ### Supported IDEs
 
 git0 automatically detects and opens projects in your preferred IDE:
 
-- **Cursor** (`cursor`)
-- **Windsurf** (`windsurf`) 
-- **VS Code** (`code`)
-- **Code Server** (`code-server`)
-- **Neovim** (`nvim`)
-- **Webstorm** (`webstorm`)
+- **Antigravity**
+- **Cursor**
+- **Windsurf**
+- **VS Code**
+- **VSCode Server WebUI**
+- **Neovim**
+- **Webstorm**
 
 ## 🔧 Configuration
 
-
 ### What Happens After Download
 
 1. **Repository is downloaded** to your current directory
@@ -105,4 +103,4 @@ For higher API rate limits, set [your GitHub token](https://docs.github.com/en/a
 export GITHUB_TOKEN=your_github_token_here
 ```
 
-Without a token, you're limited to 60 requests per hour. With a token, you get 5,000 requests per hour.
+Without a token, you're limited to 60 requests per hour. With a token, you get 5,000 requests per hour.

package/src/cli.ts

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import GithubAPI from './github-api.js';
+import { openInIDE } from './ide.js';
+import { installDependencies } from './install.js';
+import { showPackageMenu } from './package-menu.js';
+import { printLogo } from './utils.js';
+import type { SearchResult } from './types.js';
+
+const Github = new GithubAPI({ debug: false });
+
+/**
+ * Downloads a GitHub repository tarball, then immediately opens the project in
+ * an IDE and installs its dependencies.
+ *
+ * The IDE launch is deferred 500 ms so the extraction can finish writing files
+ * before the editor tries to index them.
+ *
+ * @param repo       - GitHub URL (`https://…`) or `owner/repo` shorthand.
+ * @param folderPath - Optional name for the extraction directory; defaults to
+ *   the repository name.
+ *
+ * @example
+ * await downloadRepoAndSetup('https://github.com/vitejs/vite');
+ * // Downloads vite/, opens it in the first available IDE, runs bun install
+ */
+async function downloadRepoAndSetup(repo: string, folderPath: string | null = null): Promise<void> {
+  printLogo();
+  const extractPath = await Github.downloadRepo(repo, folderPath);
+  setTimeout(() => openInIDE(extractPath), 500);
+  await installDependencies(extractPath);
+}
+
+/**
+ * Builds the display label shown in the repository selection list.
+ *
+ * Shows the full `owner/name` slug, description, star count, language, and a
+ * colored badge when release packages are available for the current platform.
+ *
+ * @param repo - Enriched search result from `searchRepositories`.
+ * @returns Multi-line string suitable for an `inquirer` list choice label.
+ *
+ * @internal
+ */
+function formatRepoChoice(repo: SearchResult): string {
+  const packageInfo = repo.hasCompatibleReleases
+    ? chalk.green(' 📦 Packages available')
+    : repo.hasReleases
+      ? chalk.yellow(' 📦 Packages (other platforms)')
+      : '';
+
+  return (
+    `${chalk.bold(repo.full_name)} - ${chalk.gray(repo.description || 'No description')}\n` +
+    `      ${chalk.yellow(`★ ${repo.stargazers_count}`)} | ${chalk.blue(repo.language || 'Unknown')}${packageInfo}`
+  );
+}
+
+/**
+ * Prompts the user to choose between downloading the binary package, the
+ * source code, or both when a repository has release assets.
+ *
+ * @param selectedRepo - The repository the user chose in the search results.
+ *
+ * @internal
+ */
+async function handleRepoDownload(selectedRepo: SearchResult): Promise<void> {
+  if (!selectedRepo.hasReleases && !selectedRepo.hasCompatibleReleases) {
+    await downloadRepoAndSetup(selectedRepo.url);
+    return;
+  }
+
+  const { downloadChoice } = await inquirer.prompt({
+    type: 'list',
+    name: 'downloadChoice',
+    message: 'This repository has downloadable packages. What would you like to do?',
+    choices: [
+      { name: '📦 Download package/binary', value: 'package' },
+      { name: '📂 Download source code',    value: 'source'  },
+      { name: '📦📂 Download both',          value: 'both'    },
+    ],
+  });
+
+  if (downloadChoice === 'package' || downloadChoice === 'both') {
+    await showPackageMenu(
+      selectedRepo,
+      Github.downloadPackage.bind(Github),
+      Github.getCurrentPlatform()
+    );
+  }
+  if (downloadChoice === 'source' || downloadChoice === 'both') {
+    await downloadRepoAndSetup(selectedRepo.url);
+  }
+}
+
+/**
+ * CLI entry point for the `git0` / `g` / `gg` commands.
+ *
+ * **Flow:**
+ * 1. Parse `process.argv` for a search query or direct repo URL.
+ * 2. If the argument looks like a GitHub URL or `owner/repo`, download it
+ *    directly — optionally into a custom folder (second CLI argument).
+ * 3. Otherwise, search GitHub and present an interactive list.
+ * 4. After the user picks a repo, offer package vs. source download when
+ *    releases are available.
+ *
+ * Exits with code `1` on missing arguments or an empty search result.
+ *
+ * @example
+ * // Direct download:
+ * //   git0 facebook/react
+ * //   git0 https://github.com/vitejs/vite my-vite-copy
+ *
+ * // Search:
+ * //   git0 react template starter
+ */
+async function main(): Promise<void> {
+  printLogo();
+
+  const args = process.argv.slice(2);
+  if (!args.length) {
+    console.log(chalk.yellow('Usage: git0 <github-url | owner/repo | search-query>'));
+    process.exit(1);
+  }
+
+  const query = args.join(' ');
+  const parsed = Github.parseURL(query);
+
+  if (parsed && parsed.owner && parsed.name) {
+    await downloadRepoAndSetup(parsed.href, args[1] ?? null);
+    return;
+  }
+
+  const results = await Github.searchRepositories(query);
+  if (!results?.length) {
+    console.log(chalk.yellow('No repositories found'));
+    process.exit(1);
+  }
+
+  const { selectedRepo } = await inquirer.prompt({
+    type: 'list',
+    name: 'selectedRepo',
+    message: 'Select a repository to download:',
+    choices: results.map(repo => ({ name: formatRepoChoice(repo), value: repo })),
+  });
+
+  await handleRepoDownload(selectedRepo);
+}
+
+main();

package/src/download.ts

@@ -0,0 +1,240 @@
+import chalk from 'chalk';
+import gitUrlParse from 'git-url-parse';
+import fs from 'fs';
+import * as tar from 'tar';
+import path from 'path';
+import { getCurrentPlatform } from './platform.js';
+
+/**
+ * Returns `basePath` unchanged when the path does not yet exist on disk.
+ * When it does exist, appends `-2`, `-3`, … until an unused path is found.
+ *
+ * Used so that downloading the same repo twice never silently overwrites the
+ * first copy.
+ *
+ * @param basePath - Desired extraction directory path.
+ * @returns An available directory path guaranteed not to exist yet.
+ *
+ * @example
+ * // ./react already exists, ./react-2 does not
+ * getAvailableDirectoryName('./react'); // → './react-2'
+ */
+export function getAvailableDirectoryName(basePath: string): string {
+  if (!fs.existsSync(basePath)) return basePath;
+  let counter = 2;
+  while (true) {
+    const candidate = `${basePath}-${counter}`;
+    if (!fs.existsSync(candidate)) return candidate;
+    counter++;
+  }
+}
+
+/**
+ * Streams a GitHub tarball response directly into a `tar` extractor.
+ *
+ * `strip: 1` removes the top-level directory that GitHub adds to every
+ * tarball (e.g. `owner-repo-abc1234/`) so files land directly in
+ * `extractPath`.
+ *
+ * @param res - The `ReadableStream` body from the GitHub API response.
+ * @param extractPath - Absolute directory to extract into (must already exist).
+ * @returns Promise that resolves when extraction is complete.
+ *
+ * @internal
+ */
+async function streamTarball(res: ReadableStream, extractPath: string): Promise<void> {
+  const { Readable } = await import('stream');
+  const nodeStream = Readable.fromWeb(res);
+  await new Promise<void>((resolve, reject) => {
+    nodeStream
+      .pipe(tar.x({ C: extractPath, strip: 1 }))
+      .on('finish', resolve)
+      .on('error', reject);
+  });
+}
+
+/**
+ * Streams a GitHub API response body directly to a file on disk.
+ *
+ * @param res - The `ReadableStream` body from the GitHub API response.
+ * @param dest - Absolute path of the file to create/overwrite.
+ * @returns Promise that resolves when the file is fully written.
+ *
+ * @internal
+ */
+async function streamToFile(res: ReadableStream, dest: string): Promise<void> {
+  const { Readable } = await import('stream');
+  const nodeStream = Readable.fromWeb(res);
+  await new Promise<void>((resolve, reject) => {
+    nodeStream
+      .pipe(fs.createWriteStream(dest))
+      .on('finish', resolve)
+      .on('error', reject);
+  });
+}
+
+/**
+ * Downloads a GitHub repository tarball and extracts it into a local directory.
+ *
+ * The function first attempts to download the `master` branch; if that request
+ * returns an error it retries with `main`. The extracted directory name is
+ * derived from the repository name, with a numeric suffix appended when the
+ * target already exists (see {@link getAvailableDirectoryName}).
+ *
+ * @param callGithub - Pre-configured `grab` instance bound to the GitHub API.
+ * @param repo - GitHub URL (`https://github.com/owner/repo`) or `owner/repo`.
+ * @param targetDir - Optional custom folder name; defaults to the repo name.
+ * @returns Absolute path of the directory the repo was extracted into.
+ *
+ * @example
+ * const dir = await downloadRepo(callGithub, 'https://github.com/facebook/react');
+ * // → '/current/working/dir/react'
+ */
+export async function downloadRepo(
+  callGithub: Function,
+  repo: string,
+  targetDir: string | null = null
+): Promise<string> {
+  const parsed = gitUrlParse(repo);
+
+  // GitHub tarballs for forks include the fork chain in `owner`, e.g. "upstream/fork".
+  // We only want the last segment.
+  if (parsed.owner.includes('/')) {
+    parsed.owner = parsed.owner.split('/').slice(-1)[0];
+  }
+
+  const defaultDir = path.resolve(process.cwd(), targetDir?.length ? targetDir : parsed.name);
+  const extractPath = getAvailableDirectoryName(defaultDir);
+
+  fs.mkdirSync(extractPath, { recursive: true });
+
+  console.log(chalk.blue(`📦 Downloading ${parsed.name} into ${path.basename(extractPath)}...`));
+
+  const defaultBranch = (parsed as any).default_branch || 'master';
+  const tarballUrl = `/repos/${parsed.owner}/${parsed.name}/tarball/${defaultBranch}`;
+  const params = { onStream: (res: ReadableStream) => streamTarball(res, extractPath) };
+
+  let response = await callGithub(tarballUrl, params);
+  if (response.error) {
+    response = await callGithub(tarballUrl.replace('/master', '/main'), params);
+  }
+
+  return extractPath;
+}
+
+/**
+ * Downloads a single release asset binary from GitHub to a local file.
+ *
+ * After a successful download:
+ * - On non-Windows, extension-less files are made executable (`chmod 755`).
+ * - Platform-specific install instructions are printed via
+ *   {@link printInstallInstructions}.
+ *
+ * @param callGithub - Pre-configured `grab` instance bound to the GitHub API.
+ * @param packageURL - Direct HTTPS download URL for the asset.
+ * @param downloadPath - Absolute local file path to write the asset to.
+ * @returns The `downloadPath` on success.
+ * @throws When the download request fails.
+ *
+ * @example
+ * await downloadPackage(callGithub,
+ *   'https://github.com/user/repo/releases/download/v1.0/app-linux-x64',
+ *   '/tmp/app-linux-x64'
+ * );
+ */
+export async function downloadPackage(
+  callGithub: Function,
+  packageURL: string,
+  downloadPath: string
+): Promise<string> {
+  const fileName = path.basename(downloadPath);
+
+  console.log(chalk.blue(`📦 Downloading ${fileName}...`));
+
+  try {
+    await callGithub(packageURL, {
+      onStream: (res: ReadableStream) => streamToFile(res, downloadPath),
+    });
+
+    console.log(chalk.green(`✅ Downloaded ${fileName} to ${downloadPath}`));
+
+    if (process.platform !== 'win32' && !fileName.includes('.')) {
+      try {
+        fs.chmodSync(downloadPath, '755');
+        console.log(chalk.green(`✅ Made ${fileName} executable`));
+      } catch {
+        console.log(chalk.yellow(`⚠️  Could not make ${fileName} executable`));
+      }
+    }
+
+    printInstallInstructions(downloadPath, fileName);
+    return downloadPath;
+  } catch (error: any) {
+    console.error(chalk.red(`❌ Failed to download ${fileName}:`), error.message);
+    throw error;
+  }
+}
+
+/**
+ * Prints platform-specific shell commands for installing or running a
+ * downloaded asset.
+ *
+ * The output adapts to the current OS and the file's extension:
+ * - **Windows**: `.exe` run command, `.msi` installer command.
+ * - **macOS**: `.dmg` open command, `.pkg` installer command.
+ * - **Linux**: `.deb` dpkg, `.rpm` rpm, `.AppImage` run command,
+ *   extension-less binaries get a `mv` to `/usr/local/bin` suggestion.
+ *
+ * @param filePath - Absolute path of the downloaded file.
+ * @param fileName - Basename of the downloaded file (used for extension checks).
+ *
+ * @example
+ * printInstallInstructions('/tmp/myapp', 'myapp');
+ * // Prints:
+ * //   Binary is ready to use:
+ * //   "/tmp/myapp"
+ * //   Consider moving to PATH:
+ * //   sudo mv "/tmp/myapp" /usr/local/bin/
+ */
+export function printInstallInstructions(filePath: string, fileName: string): void {
+  const platform = getCurrentPlatform();
+
+  if (platform.platform === 'win32') {
+    if (fileName.endsWith('.exe')) {
+      console.log(chalk.white('  Run the executable:'));
+      console.log(chalk.gray(`  ${filePath}`));
+    } else if (fileName.endsWith('.msi')) {
+      console.log(chalk.white('  Install the MSI package:'));
+      console.log(chalk.gray(`  msiexec /i "${filePath}"`));
+    }
+    return;
+  }
+
+  if (platform.platform === 'darwin') {
+    if (fileName.endsWith('.dmg')) {
+      console.log(chalk.white('  Mount and install the DMG:'));
+      console.log(chalk.gray(`  open "${filePath}"`));
+    } else if (fileName.endsWith('.pkg')) {
+      console.log(chalk.white('  Install the package:'));
+      console.log(chalk.gray(`  sudo installer -pkg "${filePath}" -target /`));
+    }
+    return;
+  }
+
+  // Linux / other Unix
+  if (fileName.endsWith('.deb')) {
+    console.log(chalk.white('  Install the DEB package:'));
+    console.log(chalk.gray(`  sudo dpkg -i "${filePath}"`));
+  } else if (fileName.endsWith('.rpm')) {
+    console.log(chalk.white('  Install the RPM package:'));
+    console.log(chalk.gray(`  sudo rpm -i "${filePath}"`));
+  } else if (fileName.endsWith('.AppImage')) {
+    console.log(chalk.white('  Run the AppImage:'));
+    console.log(chalk.gray(`  chmod +x "${filePath}" && "${filePath}"`));
+  } else if (!fileName.includes('.')) {
+    console.log(chalk.white('  Binary is ready to use:'));
+    console.log(chalk.gray(`  "${filePath}"`));
+    console.log(chalk.white('  Consider moving to PATH:'));
+    console.log(chalk.gray(`  sudo mv "${filePath}" /usr/local/bin/`));
+  }
+}

package/src/fm.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import { execSync } from 'child_process';
+import os from 'os';
 
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-const { execSync } = require('child_process');
-const os = require('os');
 
 class FileManager {
   constructor() {