chrome-tools 1.0.4 → 1.0.6

package/README.md

@@ -80,8 +80,8 @@ npx chrome-tools passwords
 # Filter credentials using a search term (matches URL or username)
 npx chrome-tools passwords --search "gmail"
 
-# Target a specific profile directory only
-npx chrome-tools passwords --profile "Profile 1"
+# Target a specific profile directory only (placed before the subcommand)
+npx chrome-tools --profile "Profile 1" passwords
 ```
 
 #### Bookmarks
@@ -149,20 +149,20 @@ npx chrome-tools top-sites
 
 ### Global Options
 
-These options apply globally to all subcommands and can be placed anywhere in your command line:
+These options apply globally to all subcommands and should be placed before the command (e.g. `npx chrome-tools --profile-path <path> --profile <name> cookies --url <url>`):
 
-- `--chrome-dir <path>`: Specify a custom Chrome User Data folder (e.g., a backed-up profile from another machine).
-- `--profile <name>`: Limit operations to a single profile directory (e.g., `Default`, `Profile 1`).
+- `--profile-path <path>`: Specify a custom Chrome User Data/profile folder (e.g., a backed-up profile from another machine). Defaults to the `PROFILE_PATH` env/`.env` variable, or falls back to the standard macOS Chrome User Data location.
+- `--profile <name>`: Target a specific profile directory (e.g., `Default`, `Profile 1`). Defaults to the `PROFILE_NAME` env/`.env` variable.
 - `--json`: Output strictly in JSON format (ideal for programmatic pipes or exporting to files).
 - `--limit <number>`: Restrict the output results count (for history, autofill, cookies, etc.).
 
 #### Custom Directory & JSON Examples
 ```bash
 # Export bookmarks from a backed-up Chrome folder directly to a JSON file
-npx chrome-tools bookmarks --chrome-dir "/path/to/backup/Chrome" --json > bookmarks.json
+npx chrome-tools --profile-path "/path/to/backup/Chrome" bookmarks --json > bookmarks.json
 
 # Retrieve all history from a specific profile in JSON format
-npx chrome-tools history --profile "Profile 2" --json --limit 10
+npx chrome-tools --profile-path "/path/to/backup/Chrome" --profile "Profile 2" history --json --limit 10
 ```
 
 ---
@@ -187,7 +187,7 @@ console.log(profiles);
 
 // 2. Fetch bookmarks programmatically
 const githubBookmarks = getBookmarks({
-  chromeDir: "/path/to/chrome/User Data",
+  profilePath: "/path/to/chrome/User Data",
   search: "github"
 });
 
@@ -214,27 +214,28 @@ for (const cred of credentials) {
 ### Available API Modules & Signatures
 
 All core functions accept an options object with the following fields:
-- `chromeDir` *(string)*: Custom Chrome User Data directory.
+- `profilePath` *(string)*: Custom Chrome User Data/profile directory (alias: `chromeDir`).
+- `chromeDir` *(string)*: Alias for `profilePath`.
 - `profile` *(string)*: Specific profile subdirectory name (e.g., `"Default"`).
 - `search` *(string)*: Case-insensitive filter term.
 - `limit` *(number)*: Maximum returned rows count.
 
 | Function | Module Path | Returns |
 | --- | --- | --- |
-| `discoverProfiles(chromeDir)` | `chrome-tools` | `Array<{name, path}>` |
-| `getProfileStates(chromeDir)` | `chrome-tools` | `Array<ProfileState>` |
-| `getPasswords({chromeDir, profile, search})` | `chrome-tools/passwords` | `Array<Credentials>` |
-| `getBookmarks({chromeDir, profile, folder, search})` | `chrome-tools/bookmarks` | `Array<Bookmark>` |
-| `getHistory({chromeDir, profile, search, limit})` | `chrome-tools/history` | `Array<HistoryEntry>` |
-| `getSearchTerms({chromeDir, profile, limit})` | `chrome-tools/history` | `Array<SearchTerm>` |
-| `getCookies({chromeDir, profile, domain, url, decrypt, limit})` | `chrome-tools/cookies` | `Array<Cookie>` |
-| `getAutofillEntries({chromeDir, profile, search, limit})` | `chrome-tools/autofill` | `Array<AutofillEntry>` |
-| `getCreditCards({chromeDir, profile})` | `chrome-tools/autofill` | `Array<CreditCard>` |
-| `getAddresses({chromeDir, profile})` | `chrome-tools/autofill` | `Array<Address>` |
-| `getDownloads({chromeDir, profile, search, limit})` | `chrome-tools/downloads` | `Array<Download>` |
-| `getExtensions({chromeDir, profile, search})` | `chrome-tools/extensions` | `Array<Extension>` |
-| `getSearchEngines({chromeDir, profile})` | `chrome-tools/search-engines` | `Array<SearchEngine>` |
-| `getTopSites({chromeDir, profile})` | `chrome-tools/top-sites` | `Array<TopSite>` |
+| `discoverProfiles(profilePath)` | `chrome-tools` | `Array<{name, path}>` |
+| `getProfileStates(profilePath)` | `chrome-tools` | `Array<ProfileState>` |
+| `getPasswords({profilePath, chromeDir, profile, search})` | `chrome-tools/passwords` | `Array<Credentials>` |
+| `getBookmarks({profilePath, chromeDir, profile, folder, search})` | `chrome-tools/bookmarks` | `Array<Bookmark>` |
+| `getHistory({profilePath, chromeDir, profile, search, limit})` | `chrome-tools/history` | `Array<HistoryEntry>` |
+| `getSearchTerms({profilePath, chromeDir, profile, limit})` | `chrome-tools/history` | `Array<SearchTerm>` |
+| `getCookies({profilePath, chromeDir, profile, domain, url, decrypt, limit})` | `chrome-tools/cookies` | `Array<Cookie>` |
+| `getAutofillEntries({profilePath, chromeDir, profile, search, limit})` | `chrome-tools/autofill` | `Array<AutofillEntry>` |
+| `getCreditCards({profilePath, chromeDir, profile})` | `chrome-tools/autofill` | `Array<CreditCard>` |
+| `getAddresses({profilePath, chromeDir, profile})` | `chrome-tools/autofill` | `Array<Address>` |
+| `getDownloads({profilePath, chromeDir, profile, search, limit})` | `chrome-tools/downloads` | `Array<Download>` |
+| `getExtensions({profilePath, chromeDir, profile, search})` | `chrome-tools/extensions` | `Array<Extension>` |
+| `getSearchEngines({profilePath, chromeDir, profile})` | `chrome-tools/search-engines` | `Array<SearchEngine>` |
+| `getTopSites({profilePath, chromeDir, profile})` | `chrome-tools/top-sites` | `Array<TopSite>` |
 
 ---
 

package/dist/bin/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * chrome-tools CLI
+ *
+ * A comprehensive command-line interface for extracting Chrome browser data on macOS.
+ * Supports subcommands and shortcut flags for quick access to all data types.
+ */
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,543 @@
+#!/usr/bin/env node
+/**
+ * chrome-tools CLI
+ *
+ * A comprehensive command-line interface for extracting Chrome browser data on macOS.
+ * Supports subcommands and shortcut flags for quick access to all data types.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { Command } from "commander";
+import chalk from "chalk";
+import Table from "cli-table3";
+import { discoverProfiles, getProfileMetadata, getProfileStates, getDefaultChromeDir } from "../src/core/chrome.js";
+import { getPasswords } from "../src/modules/passwords.js";
+import { getBookmarks } from "../src/modules/bookmarks.js";
+import { getHistory, getSearchTerms } from "../src/modules/history.js";
+import { getCookies } from "../src/modules/cookies.js";
+import { getAutofillEntries, getCreditCards, getAddresses } from "../src/modules/autofill.js";
+import { getDownloads } from "../src/modules/downloads.js";
+import { getExtensions } from "../src/modules/extensions.js";
+import { getSearchEngines } from "../src/modules/search-engines.js";
+import { getTopSites } from "../src/modules/top-sites.js";
+// ─── Environment Loading ─────────────────────────────────────────────────────
+function loadEnv() {
+    const env = { ...process.env };
+    const envPath = join(process.cwd(), ".env");
+    if (existsSync(envPath)) {
+        try {
+            const content = readFileSync(envPath, "utf8");
+            for (const line of content.split(/\r?\n/)) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith("#"))
+                    continue;
+                const index = trimmed.indexOf("=");
+                if (index !== -1) {
+                    const key = trimmed.substring(0, index).trim();
+                    let val = trimmed.substring(index + 1).trim();
+                    // Remove wrapping quotes
+                    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+                        val = val.slice(1, -1);
+                    }
+                    env[key] = val;
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return env;
+}
+const env = loadEnv();
+const defaultProfilePath = env.PROFILE_PATH || getDefaultChromeDir();
+const defaultProfileName = env.PROFILE_NAME || undefined;
+// ─── Output Helpers ──────────────────────────────────────────────────────────
+function outputJSON(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function makeTable(headers, colWidths) {
+    return new Table({
+        head: headers.map((h) => chalk.bold.white(h)),
+        colWidths,
+        wordWrap: true,
+        style: { border: ["grey"], head: [] },
+    });
+}
+function printCount(label, count) {
+    if (count === 0) {
+        console.log(chalk.yellow(`\n⚠ No ${label} found.\n`));
+    }
+    else {
+        console.log(chalk.green(`\n✔ Found ${count} ${label}.\n`));
+    }
+}
+// ─── Shared Options ──────────────────────────────────────────────────────────
+function addCommonOptions(cmd) {
+    return cmd
+        .option("--profile-path <path>", "Custom Chrome Profile Path", defaultProfilePath)
+        .option("--profile <name>", "Target a specific profile", defaultProfileName)
+        .option("--json", "Output as JSON");
+}
+function addSearchOption(cmd) {
+    return cmd.option("--search <term>", "Filter results (case-insensitive)");
+}
+function addLimitOption(cmd, defaultLimit = 100) {
+    return cmd.option("--limit <n>", "Limit number of results", String(defaultLimit));
+}
+// ─── Program Setup ───────────────────────────────────────────────────────────
+const program = new Command();
+const pkg = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+program
+    .name("chrome-tools")
+    .description(chalk.bold.cyan("Chrome Data Toolkit") +
+    chalk.dim(" — Extract passwords, bookmarks, history, cookies, and more from Chrome on macOS"))
+    .version(pkg.version)
+    .option("--passwords", "Shortcut: list saved passwords")
+    .option("--bookmarks", "Shortcut: list bookmarks")
+    .option("--profiles", "Shortcut: list profiles")
+    .option("--profile-path <path>", "Custom Chrome Profile Path", defaultProfilePath)
+    .option("--profile <name>", "Target a specific profile", defaultProfileName)
+    .option("--json", "Output as JSON")
+    .option("--search <term>", "Filter results (for shortcut flags)")
+    .option("--limit <n>", "Limit results (for shortcut flags)");
+// ─── Profiles Command ───────────────────────────────────────────────────────
+const profilesCmd = program
+    .command("profiles")
+    .description("List Chrome profiles");
+addCommonOptions(profilesCmd).action((opts, cmd) => {
+    handleProfiles(cmd.optsWithGlobals());
+});
+profilesCmd
+    .command("states")
+    .description("Show detailed profile states with available data files")
+    .option("--profile-path <path>", "Custom Chrome Profile Path", defaultProfilePath)
+    .option("--json", "Output as JSON")
+    .action((opts, cmd) => handleProfileStates(cmd.optsWithGlobals()));
+function handleProfiles(opts) {
+    const profiles = discoverProfiles(opts.profilePath);
+    const metadata = getProfileMetadata(opts.profilePath);
+    if (opts.json) {
+        const metaMap = new Map(metadata.map((m) => [m.directory, m]));
+        const enriched = profiles.map((p) => ({
+            ...p,
+            ...(metaMap.get(p.name) || {}),
+        }));
+        return outputJSON(enriched);
+    }
+    if (profiles.length === 0) {
+        console.log(chalk.yellow("\n⚠ No Chrome profiles found.\n"));
+        return;
+    }
+    const metaMap = new Map(metadata.map((m) => [m.directory, m]));
+    console.log(chalk.bold(`\n📁 Discovered ${profiles.length} profile(s):\n`));
+    const table = makeTable(["Directory", "Display Name", "Email", "Path"], [16, 22, 30, 50]);
+    for (const p of profiles) {
+        const meta = (metaMap.get(p.name) || {});
+        table.push([
+            chalk.cyan(p.name),
+            chalk.white(meta.name || p.name),
+            chalk.dim(meta.email || "—"),
+            chalk.dim(p.path),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("profile(s)", profiles.length);
+}
+function handleProfileStates(opts) {
+    const states = getProfileStates(opts.profilePath);
+    if (opts.json) {
+        return outputJSON(states);
+    }
+    if (states.length === 0) {
+        console.log(chalk.yellow("\n⚠ No Chrome profiles found.\n"));
+        return;
+    }
+    console.log(chalk.bold(`\n📊 Profile States (${states.length} profile(s)):\n`));
+    for (const state of states) {
+        console.log(chalk.bold.cyan(`  ${state.displayName}`) + chalk.dim(` (${state.directory})`));
+        if (state.email) {
+            console.log(chalk.dim(`    Email: ${state.email}`));
+        }
+        console.log(chalk.dim(`    Path:  ${state.path}`));
+        const files = state.dataFiles;
+        const available = Object.entries(files)
+            .filter(([, exists]) => exists)
+            .map(([name]) => name);
+        const missing = Object.entries(files)
+            .filter(([, exists]) => !exists)
+            .map(([name]) => name);
+        console.log(`    Available: ${available.map((f) => chalk.green(f)).join(", ") || chalk.dim("none")}`);
+        if (missing.length > 0) {
+            console.log(`    Missing:   ${missing.map((f) => chalk.dim(f)).join(", ")}`);
+        }
+        console.log();
+    }
+}
+// ─── Passwords Command ──────────────────────────────────────────────────────
+const passwordsCmd = program.command("passwords").description("List saved passwords");
+addSearchOption(addCommonOptions(passwordsCmd)).action((opts, cmd) => handlePasswords(cmd.optsWithGlobals()));
+function handlePasswords(opts) {
+    const results = getPasswords({
+        chromeDir: opts.profilePath,
+        profile: opts.profile,
+        search: opts.search,
+    });
+    if (opts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("passwords", 0);
+    }
+    console.log(chalk.bold("\n🔑 Saved Passwords:\n"));
+    const showProfile = new Set(results.map((r) => r.profile)).size > 1;
+    const head = showProfile
+        ? ["Profile", "URL", "Username", "Password", "Last Used"]
+        : ["URL", "Username", "Password", "Last Used"];
+    const widths = showProfile ? [12, 40, 24, 22, 20] : [45, 28, 25, 22];
+    const table = makeTable(head, widths);
+    for (const r of results) {
+        const row = [
+            chalk.cyan(r.url),
+            chalk.green(r.username || "<empty>"),
+            chalk.yellow(r.password || "<empty>"),
+            chalk.dim(r.lastUsed),
+        ];
+        if (showProfile)
+            row.unshift(chalk.magenta(r.profile));
+        table.push(row);
+    }
+    console.log(table.toString());
+    printCount("password(s)", results.length);
+}
+// ─── Bookmarks Command ──────────────────────────────────────────────────────
+const bookmarksCmd = program.command("bookmarks").description("List bookmarks");
+addSearchOption(addCommonOptions(bookmarksCmd))
+    .option("--folder <name>", "Filter by folder name")
+    .action((opts, cmd) => handleBookmarks(cmd.optsWithGlobals()));
+function handleBookmarks(opts) {
+    const results = getBookmarks({
+        chromeDir: opts.profilePath,
+        profile: opts.profile,
+        folder: opts.folder,
+        search: opts.search,
+    });
+    if (opts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("bookmarks", 0);
+    }
+    console.log(chalk.bold("\n📚 Bookmarks:\n"));
+    const table = makeTable(["Title", "URL", "Folder", "Date Added"], [30, 50, 25, 20]);
+    for (const r of results) {
+        table.push([
+            chalk.white(r.title),
+            chalk.cyan(r.url),
+            chalk.dim(r.folder || "/"),
+            chalk.dim(r.dateAdded),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("bookmark(s)", results.length);
+}
+// ─── History Command ─────────────────────────────────────────────────────────
+const historyCmd = program.command("history").description("List browsing history");
+addSearchOption(addLimitOption(addCommonOptions(historyCmd))).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getHistory({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        search: mergedOpts.search,
+        limit: parseInt(mergedOpts.limit, 10) || 100,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("history entries", 0);
+    }
+    console.log(chalk.bold("\n🕐 Browsing History:\n"));
+    const table = makeTable(["URL", "Title", "Visits", "Last Visit"], [50, 30, 8, 22]);
+    for (const r of results) {
+        table.push([
+            chalk.cyan(r.url),
+            chalk.white(r.title || "—"),
+            chalk.yellow(String(r.visitCount)),
+            chalk.dim(r.lastVisit),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("history entry(ies)", results.length);
+});
+// ─── Search Terms Command ────────────────────────────────────────────────────
+const searchTermsCmd = program.command("search-terms").description("List search terms from history");
+addLimitOption(addCommonOptions(searchTermsCmd)).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getSearchTerms({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        limit: parseInt(mergedOpts.limit, 10) || 100,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("search terms", 0);
+    }
+    console.log(chalk.bold("\n🔍 Search Terms:\n"));
+    const table = makeTable(["Term", "URL"], [40, 80]);
+    for (const r of results) {
+        table.push([chalk.white(r.term), chalk.dim(r.url)]);
+    }
+    console.log(table.toString());
+    printCount("search term(s)", results.length);
+});
+// ─── Cookies Command ─────────────────────────────────────────────────────────
+const cookiesCmd = program.command("cookies").description("List cookies (encrypted values decrypted)");
+addLimitOption(addCommonOptions(cookiesCmd))
+    .option("--domain <domain>", "Filter by domain")
+    .option("--url <url>", "Filter by URL with path")
+    .option("--no-decrypt", "Skip decryption of encrypted values")
+    .action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getCookies({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        domain: mergedOpts.domain,
+        url: mergedOpts.url,
+        decrypt: mergedOpts.decrypt !== false,
+        limit: parseInt(mergedOpts.limit, 10) || 100,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("cookies", 0);
+    }
+    console.log(chalk.bold("\n🍪 Cookies:\n"));
+    const table = makeTable(["Domain", "Name", "Value", "Secure", "Expires"], [30, 25, 30, 8, 22]);
+    for (const r of results) {
+        table.push([
+            chalk.cyan(r.domain),
+            chalk.white(r.name),
+            chalk.dim(r.value ? r.value.substring(0, 50) + (r.value.length > 50 ? "…" : "") : "—"),
+            r.secure ? chalk.green("✓") : chalk.dim("✗"),
+            chalk.dim(r.expires),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("cookie(s)", results.length);
+});
+// ─── Autofill Command ────────────────────────────────────────────────────────
+const autofillCmd = program.command("autofill").description("List autofill entries");
+addSearchOption(addLimitOption(addCommonOptions(autofillCmd))).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getAutofillEntries({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        search: mergedOpts.search,
+        limit: parseInt(mergedOpts.limit, 10) || 100,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("autofill entries", 0);
+    }
+    console.log(chalk.bold("\n📝 Autofill Entries:\n"));
+    const table = makeTable(["Field Name", "Value", "Count", "Last Used"], [25, 40, 8, 22]);
+    for (const r of results) {
+        table.push([
+            chalk.cyan(r.name),
+            chalk.white(r.value),
+            chalk.yellow(String(r.count)),
+            chalk.dim(r.dateLastUsed),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("autofill entry(ies)", results.length);
+});
+// ─── Credit Cards Command ────────────────────────────────────────────────────
+const creditCardsCmd = program.command("credit-cards").description("List saved credit cards");
+addCommonOptions(creditCardsCmd).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getCreditCards({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("credit cards", 0);
+    }
+    console.log(chalk.bold("\n💳 Saved Credit Cards:\n"));
+    const table = makeTable(["Name on Card", "Card Number", "Expires", "Nickname"], [25, 25, 14, 20]);
+    for (const r of results) {
+        table.push([
+            chalk.white(r.nameOnCard || "—"),
+            chalk.yellow(r.cardNumber || "—"),
+            chalk.dim(`${r.expirationMonth}/${r.expirationYear}`),
+            chalk.dim(r.nickname || "—"),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("credit card(s)", results.length);
+});
+// ─── Addresses Command ───────────────────────────────────────────────────────
+const addressesCmd = program.command("addresses").description("List saved addresses");
+addCommonOptions(addressesCmd).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getAddresses({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("addresses", 0);
+    }
+    console.log(chalk.bold("\n🏠 Saved Addresses:\n"));
+    const table = makeTable(["Name", "Email", "Phone", "Address", "City/State/Zip"], [20, 25, 16, 30, 25]);
+    for (const r of results) {
+        table.push([
+            chalk.white(r.fullName || "—"),
+            chalk.cyan(r.email || "—"),
+            chalk.dim(r.phone || "—"),
+            chalk.white(r.streetAddress || "—"),
+            chalk.dim([r.city, r.state, r.zipcode].filter(Boolean).join(", ") || "—"),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("address(es)", results.length);
+});
+// ─── Downloads Command ───────────────────────────────────────────────────────
+const downloadsCmd = program.command("downloads").description("List download history");
+addSearchOption(addLimitOption(addCommonOptions(downloadsCmd))).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getDownloads({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        search: mergedOpts.search,
+        limit: parseInt(mergedOpts.limit, 10) || 100,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("downloads", 0);
+    }
+    console.log(chalk.bold("\n⬇️  Download History:\n"));
+    const table = makeTable(["File", "URL", "Size", "State", "Date"], [35, 40, 12, 12, 20]);
+    for (const r of results) {
+        const filename = r.targetPath ? r.targetPath.split("/").pop() : "—";
+        const sizeStr = r.totalBytes > 0 ? formatBytes(r.totalBytes) : "—";
+        table.push([
+            chalk.white(filename || ""),
+            chalk.cyan(r.url ? r.url.substring(0, 60) : "—"),
+            chalk.dim(sizeStr),
+            r.state === "complete" ? chalk.green(r.state) : chalk.yellow(r.state),
+            chalk.dim(r.startTime),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("download(s)", results.length);
+});
+// ─── Extensions Command ─────────────────────────────────────────────────────
+const extensionsCmd = program.command("extensions").description("List installed extensions");
+addSearchOption(addCommonOptions(extensionsCmd)).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getExtensions({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+        search: mergedOpts.search,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("extensions", 0);
+    }
+    console.log(chalk.bold("\n🧩 Installed Extensions:\n"));
+    const table = makeTable(["Name", "Version", "ID", "Enabled", "Webstore"], [30, 12, 36, 9, 9]);
+    for (const r of results) {
+        table.push([
+            chalk.white(r.name),
+            chalk.dim(r.version),
+            chalk.dim(r.id),
+            r.enabled ? chalk.green("✓") : chalk.red("✗"),
+            r.fromWebstore ? chalk.green("✓") : chalk.dim("✗"),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("extension(s)", results.length);
+});
+// ─── Search Engines Command ─────────────────────────────────────────────────
+const searchEnginesCmd = program.command("search-engines").description("List configured search engines");
+addCommonOptions(searchEnginesCmd).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getSearchEngines({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("search engines", 0);
+    }
+    console.log(chalk.bold("\n🔎 Search Engines:\n"));
+    const table = makeTable(["Name", "Keyword", "URL", "Active"], [20, 16, 60, 8]);
+    for (const r of results) {
+        table.push([
+            chalk.white(r.name),
+            chalk.cyan(r.keyword),
+            chalk.dim(r.url ? r.url.substring(0, 80) : "—"),
+            r.isActive ? chalk.green("✓") : chalk.dim("✗"),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("search engine(s)", results.length);
+});
+// ─── Top Sites Command ──────────────────────────────────────────────────────
+const topSitesCmd = program.command("top-sites").description("List top sites");
+addCommonOptions(topSitesCmd).action((opts, cmd) => {
+    const mergedOpts = cmd.optsWithGlobals();
+    const results = getTopSites({
+        chromeDir: mergedOpts.profilePath,
+        profile: mergedOpts.profile,
+    });
+    if (mergedOpts.json)
+        return outputJSON(results);
+    if (results.length === 0) {
+        return printCount("top sites", 0);
+    }
+    console.log(chalk.bold("\n⭐ Top Sites:\n"));
+    const table = makeTable(["Rank", "Title", "URL"], [8, 30, 80]);
+    for (const r of results) {
+        table.push([
+            chalk.yellow(String(r.rank + 1)),
+            chalk.white(r.title || "—"),
+            chalk.cyan(r.url),
+        ]);
+    }
+    console.log(table.toString());
+    printCount("top site(s)", results.length);
+});
+// ─── Utilities ───────────────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
+}
+// ─── Run ─────────────────────────────────────────────────────────────────────
+program.parse();
+const rootOpts = program.opts();
+const hasSubcommand = program.args.length > 0;
+if (!hasSubcommand) {
+    if (rootOpts.passwords) {
+        handlePasswords(rootOpts);
+    }
+    else if (rootOpts.bookmarks) {
+        handleBookmarks(rootOpts);
+    }
+    else if (rootOpts.profiles) {
+        handleProfiles(rootOpts);
+    }
+    else {
+        program.help();
+    }
+}