CLI Usage

## install for CLI testing of your APIs
npm i -g grab-url-cli

# use "grab" (or "g") if installed, or "npx grab-url-cli" if not
g https://api.example.com/data

# Basic request — parses JSON and writes output.json
npx grab-url-cli https://api.example.com/data

# Request with query params as JSON
npx grab-url-cli https://api.example.com/search -p '{"q":"hello","limit":10}'

# Print the response instead of saving it
npx grab-url-cli https://api.example.com/data --no-save

# Download a file, or several concurrently
npx grab-url-cli https://releases.ubuntu.com/24.04.2/ubuntu-24.04.2-live-server-amd64.iso
npx grab-url-cli https://example.com/a.zip https://example.com/b.zip -d ./downloads

# Pull a file over SFTP (credentials inline, or as flags to keep them out of shell history)
npx grab-url-cli sftp://user@host/srv/backup.tar.gz --password hunter2
npx grab-url-cli sftp://host:2222/srv/db.tar.zst --user alice --password hunter2 -o backup.tar.zst

# Pin the host key — the transfer aborts if the server presents a different one
npx grab-url-cli sftp://host/srv/db.tar.zst --user alice --password hunter2 \
  --ssh-host-key sha-1=b030503bb45f9f0e0a1e9c4a1e0b8f4c3d2e1f00

# Torrent file or magnet link, with optional seeding after it completes
npx grab-url-cli ./ubuntu.torrent -d ./downloads
npx grab-url-cli "magnet:?xt=urn:btih:HASH" -d ./downloads --seed

# Throttle, or pass any other aria2c flag straight through
npx grab-url-cli ./ubuntu.torrent --aria2-args "--max-overall-download-limit=2M --enable-dht=false"

# Detach at once — prints the PID and log path, then returns
npx grab-url-cli https://example.com/big.iso --background

# List background transfers still running (dead jobs are pruned automatically)
npx grab-url-cli --jobs

import { MultiColorFileDownloaderCLI } from "grab-url/cli";

const downloader = new MultiColorFileDownloaderCLI();

// Download a single file
await downloader.downloadFile(
  "https://example.com/archive.tar.gz",
  "./downloads/archive.tar.gz",
);

// Download multiple files concurrently with progress bars
await downloader.downloadMultipleFiles([
  {
    url: "https://example.com/a.zip",
    outputPath: "./a.zip",
    filename: "a.zip",
  },
  {
    url: "https://example.com/b.zip",
    outputPath: "./b.zip",
    filename: "b.zip",
  },
]);

// Clean up listeners and abort controllers when done
downloader.cleanup();

import { MultiColorFileDownloaderCLI, generateFilename } from "grab-url/cli";

const downloader = new MultiColorFileDownloaderCLI();

// Start with one file (runs in background)
const initialDownload = downloader.downloadMultipleFiles([
  {
    url: "https://example.com/large-file.iso",
    outputPath: "./large-file.iso",
    filename: "large-file.iso",
  },
]);

// Later, add another file to the running session
setTimeout(async () => {
  const url = "https://example.com/extra-data.zip";
  const filename = generateFilename(url); // => 'extra-data.zip'
  await downloader.addToMultipleDownloads(url, `./${filename}`, filename);
}, 5000);

// Wait for all downloads to finish
await initialDownload;
downloader.cleanup();