brew-tui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MoLines Designs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# Brew-TUI
+
+A visual terminal UI for [Homebrew](https://brew.sh) package management.
+
+![License](https://img.shields.io/badge/license-MIT-blue)
+![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+![npm](https://img.shields.io/npm/v/brew-tui)
+
+## Features
+
+- **Dashboard** -- overview of installed packages, outdated counts, services, and system info
+- **Installed** -- browse and filter formulae and casks with version info and status badges
+- **Search** -- find and install packages directly from the TUI
+- **Outdated** -- see available upgrades with version comparison arrows, upgrade individually or all at once
+- **Services** -- start, stop, and restart Homebrew services
+- **Doctor** -- run `brew doctor` and see warnings at a glance
+- **Package Info** -- detailed view with dependencies, caveats, and quick install/uninstall
+
+### Pro Features
+
+- **Profiles** -- export and import your Homebrew setup across machines
+- **Smart Cleanup** -- find orphaned packages and reclaim disk space
+- **Action History** -- track every install, uninstall, and upgrade
+- **Security Audit** -- scan packages against the OSV vulnerability database
+
+## Install
+
+```bash
+# npm / pnpm / yarn / bun (all use the same npm registry)
+npm install -g brew-tui
+pnpm add -g brew-tui
+yarn global add brew-tui
+bun add -g brew-tui
+
+# Homebrew
+brew tap MoLinesGitHub/tap
+brew install brew-tui
+
+# GitHub Packages
+npm install -g @MoLinesGitHub/brew-tui --registry https://npm.pkg.github.com
+
+# npx (run without installing)
+npx brew-tui
+```
+
+## Usage
+
+```bash
+brew-tui              # Launch the TUI
+brew-tui status       # Show license status
+brew-tui activate <key>   # Activate Pro license
+brew-tui deactivate   # Deactivate Pro license
+```
+
+### Install BrewBar (Pro)
+
+BrewBar is a companion macOS menu bar app that shows outdated package counts, sends notifications, and lets you upgrade packages without opening a terminal. Pro users can install it directly from the CLI:
+
+```bash
+brew-tui install-brewbar          # Download & install to /Applications
+brew-tui install-brewbar --force  # Reinstall / update
+brew-tui uninstall-brewbar        # Remove from /Applications
+```
+
+### Keyboard Navigation
+
+| Key | Action |
+|-----|--------|
+| `1`-`0` | Jump to view |
+| `Tab` / `Shift+Tab` | Cycle views |
+| `j` / `k` | Navigate lists |
+| `Enter` | Select / confirm |
+| `/` | Search / filter |
+| `Escape` | Go back |
+| `L` | Toggle language (en/es) |
+| `q` | Quit |
+
+## Language
+
+Brew-TUI supports English and Spanish. The language is detected automatically from your system locale (`LANG` environment variable). You can also:
+
+- Pass `--lang=es` or `--lang=en` as a CLI flag
+- Press `L` inside the TUI to toggle between languages
+
+## BrewBar
+
+BrewBar is a companion macOS menu bar app (Swift 6 / SwiftUI) that shows outdated package counts, sends notifications, and lets you upgrade packages without opening a terminal.
+
+BrewBar lives in the `menubar/` directory and is built separately with [Tuist](https://tuist.io):
+
+```bash
+cd menubar
+tuist generate
+xcodebuild -workspace BrewBar.xcworkspace -scheme BrewBar build
+```
+
+## Requirements
+
+- **Node.js** >= 18
+- **Homebrew** installed on your system
+- **macOS** 14+ (for BrewBar)
+
+## License
+
+[MIT](LICENSE) -- MoLines Designs

package/bin/brew-tui.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../build/index.js';

package/build/brewbar-installer-CPCOE3MI.js

@@ -0,0 +1,64 @@
+import {
+  t,
+  verifyPro
+} from "./chunk-P6PTN4HR.js";
+
+// src/lib/brewbar-installer.ts
+import { rm, access } from "fs/promises";
+import { createWriteStream } from "fs";
+import { pipeline } from "stream/promises";
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+var BREWBAR_APP_PATH = "/Applications/BrewBar.app";
+var DOWNLOAD_URL = "https://github.com/MoLinesGitHub/Brew-TUI/releases/latest/download/BrewBar.app.zip";
+var TMP_ZIP = "/tmp/BrewBar.app.zip";
+async function isBrewBarInstalled() {
+  try {
+    await access(BREWBAR_APP_PATH);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function installBrewBar(force = false) {
+  if (process.platform !== "darwin") {
+    throw new Error(t("cli_brewbarMacOnly"));
+  }
+  if (!verifyPro()) {
+    throw new Error(t("cli_brewbarProRequired"));
+  }
+  if (!force && await isBrewBarInstalled()) {
+    throw new Error(t("cli_brewbarAlreadyInstalled"));
+  }
+  console.log(t("cli_brewbarInstalling"));
+  const res = await fetch(DOWNLOAD_URL);
+  if (!res.ok || !res.body) {
+    throw new Error(t("cli_brewbarDownloadFailed", { error: `HTTP ${res.status}` }));
+  }
+  const fileStream = createWriteStream(TMP_ZIP);
+  await pipeline(res.body, fileStream);
+  if (force && await isBrewBarInstalled()) {
+    await rm(BREWBAR_APP_PATH, { recursive: true, force: true });
+  }
+  try {
+    await execFileAsync("ditto", ["-xk", TMP_ZIP, "/Applications/"]);
+  } catch (err) {
+    throw new Error(t("cli_brewbarDownloadFailed", { error: err instanceof Error ? err.message : String(err) }));
+  } finally {
+    await rm(TMP_ZIP, { force: true }).catch(() => {
+    });
+  }
+}
+async function uninstallBrewBar() {
+  if (!await isBrewBarInstalled()) {
+    throw new Error(t("cli_brewbarNotInstalled"));
+  }
+  await rm(BREWBAR_APP_PATH, { recursive: true, force: true });
+}
+export {
+  installBrewBar,
+  isBrewBarInstalled,
+  uninstallBrewBar
+};
+//# sourceMappingURL=brewbar-installer-CPCOE3MI.js.map

package/build/brewbar-installer-CPCOE3MI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/brewbar-installer.ts"],"sourcesContent":["import { rm, access } from 'node:fs/promises';\nimport { createWriteStream } from 'node:fs';\nimport { pipeline } from 'node:stream/promises';\nimport { execFile } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport { t } from '../i18n/index.js';\nimport { verifyPro } from './license/pro-guard.js';\n\nconst execFileAsync = promisify(execFile);\nconst BREWBAR_APP_PATH = '/Applications/BrewBar.app';\nconst DOWNLOAD_URL = 'https://github.com/MoLinesGitHub/Brew-TUI/releases/latest/download/BrewBar.app.zip';\nconst TMP_ZIP = '/tmp/BrewBar.app.zip';\n\nexport async function isBrewBarInstalled(): Promise<boolean> {\n  try {\n    await access(BREWBAR_APP_PATH);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function installBrewBar(force = false): Promise<void> {\n  // macOS only\n  if (process.platform !== 'darwin') {\n    throw new Error(t('cli_brewbarMacOnly'));\n  }\n\n  // Pro check\n  if (!verifyPro()) {\n    throw new Error(t('cli_brewbarProRequired'));\n  }\n\n  // Already installed check\n  if (!force && await isBrewBarInstalled()) {\n    throw new Error(t('cli_brewbarAlreadyInstalled'));\n  }\n\n  console.log(t('cli_brewbarInstalling'));\n\n  // Download zip\n  const res = await fetch(DOWNLOAD_URL);\n  if (!res.ok || !res.body) {\n    throw new Error(t('cli_brewbarDownloadFailed', { error: `HTTP ${res.status}` }));\n  }\n\n  // Write to tmp file\n  const fileStream = createWriteStream(TMP_ZIP);\n  await pipeline(res.body as any, fileStream);\n\n  // Remove old app if force reinstall\n  if (force && await isBrewBarInstalled()) {\n    await rm(BREWBAR_APP_PATH, { recursive: true, force: true });\n  }\n\n  // Unzip to /Applications\n  try {\n    await execFileAsync('ditto', ['-xk', TMP_ZIP, '/Applications/']);\n  } catch (err) {\n    throw new Error(t('cli_brewbarDownloadFailed', { error: err instanceof Error ? err.message : String(err) }));\n  } finally {\n    // Clean up tmp zip\n    await rm(TMP_ZIP, { force: true }).catch(() => {});\n  }\n}\n\nexport async function uninstallBrewBar(): Promise<void> {\n  if (!await isBrewBarInstalled()) {\n    throw new Error(t('cli_brewbarNotInstalled'));\n  }\n\n  await rm(BREWBAR_APP_PATH, { recursive: true, force: true });\n}\n"],"mappings":";;;;;;AAAA,SAAS,IAAI,cAAc;AAC3B,SAAS,yBAAyB;AAClC,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAI1B,IAAM,gBAAgB,UAAU,QAAQ;AACxC,IAAM,mBAAmB;AACzB,IAAM,eAAe;AACrB,IAAM,UAAU;AAEhB,eAAsB,qBAAuC;AAC3D,MAAI;AACF,UAAM,OAAO,gBAAgB;AAC7B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,eAAe,QAAQ,OAAsB;AAEjE,MAAI,QAAQ,aAAa,UAAU;AACjC,UAAM,IAAI,MAAM,EAAE,oBAAoB,CAAC;AAAA,EACzC;AAGA,MAAI,CAAC,UAAU,GAAG;AAChB,UAAM,IAAI,MAAM,EAAE,wBAAwB,CAAC;AAAA,EAC7C;AAGA,MAAI,CAAC,SAAS,MAAM,mBAAmB,GAAG;AACxC,UAAM,IAAI,MAAM,EAAE,6BAA6B,CAAC;AAAA,EAClD;AAEA,UAAQ,IAAI,EAAE,uBAAuB,CAAC;AAGtC,QAAM,MAAM,MAAM,MAAM,YAAY;AACpC,MAAI,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM;AACxB,UAAM,IAAI,MAAM,EAAE,6BAA6B,EAAE,OAAO,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC;AAAA,EACjF;AAGA,QAAM,aAAa,kBAAkB,OAAO;AAC5C,QAAM,SAAS,IAAI,MAAa,UAAU;AAG1C,MAAI,SAAS,MAAM,mBAAmB,GAAG;AACvC,UAAM,GAAG,kBAAkB,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EAC7D;AAGA,MAAI;AACF,UAAM,cAAc,SAAS,CAAC,OAAO,SAAS,gBAAgB,CAAC;AAAA,EACjE,SAAS,KAAK;AACZ,UAAM,IAAI,MAAM,EAAE,6BAA6B,EAAE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EAAE,CAAC,CAAC;AAAA,EAC7G,UAAE;AAEA,UAAM,GAAG,SAAS,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACnD;AACF;AAEA,eAAsB,mBAAkC;AACtD,MAAI,CAAC,MAAM,mBAAmB,GAAG;AAC/B,UAAM,IAAI,MAAM,EAAE,yBAAyB,CAAC;AAAA,EAC9C;AAEA,QAAM,GAAG,kBAAkB,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAC7D;","names":[]}

package/build/chunk-3BK3B53S.js

@@ -0,0 +1,55 @@
+import {
+  HISTORY_PATH,
+  ensureDataDirs,
+  requirePro
+} from "./chunk-P6PTN4HR.js";
+
+// src/lib/history/history-logger.ts
+import { readFile, writeFile, rename } from "fs/promises";
+var MAX_ENTRIES = 1e3;
+async function loadHistory() {
+  requirePro();
+  try {
+    const raw = await readFile(HISTORY_PATH, "utf-8");
+    const file = JSON.parse(raw);
+    const entries = file.entries;
+    return Array.isArray(entries) ? entries : [];
+  } catch {
+    return [];
+  }
+}
+async function saveHistory(entries) {
+  await ensureDataDirs();
+  const file = { version: 1, entries };
+  const tmp = HISTORY_PATH + ".tmp";
+  await writeFile(tmp, JSON.stringify(file, null, 2), "utf-8");
+  await rename(tmp, HISTORY_PATH);
+}
+async function appendEntry(action, packageName, success, error = null) {
+  requirePro();
+  const entries = await loadHistory();
+  const entry = {
+    id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    action,
+    packageName,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    success,
+    error
+  };
+  entries.unshift(entry);
+  if (entries.length > MAX_ENTRIES) {
+    entries.length = MAX_ENTRIES;
+  }
+  await saveHistory(entries);
+}
+async function clearHistory() {
+  requirePro();
+  await saveHistory([]);
+}
+
+export {
+  loadHistory,
+  appendEntry,
+  clearHistory
+};
+//# sourceMappingURL=chunk-3BK3B53S.js.map

package/build/chunk-3BK3B53S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/history/history-logger.ts"],"sourcesContent":["import { readFile, writeFile, rename } from 'node:fs/promises';\nimport { HISTORY_PATH, ensureDataDirs } from '../data-dir.js';\nimport { requirePro } from '../license/pro-guard.js';\nimport type { HistoryEntry, HistoryFile, HistoryAction } from './types.js';\n\nconst MAX_ENTRIES = 1000;\n\nexport async function loadHistory(): Promise<HistoryEntry[]> {\n  requirePro();\n\n  try {\n    const raw = await readFile(HISTORY_PATH, 'utf-8');\n    const file = JSON.parse(raw) as HistoryFile;\n    const entries = file.entries;\n    return Array.isArray(entries) ? entries : [];\n  } catch {\n    return [];\n  }\n}\n\nasync function saveHistory(entries: HistoryEntry[]): Promise<void> {\n  await ensureDataDirs();\n  const file: HistoryFile = { version: 1, entries };\n  const tmp = HISTORY_PATH + '.tmp';\n  await writeFile(tmp, JSON.stringify(file, null, 2), 'utf-8');\n  await rename(tmp, HISTORY_PATH);\n}\n\nexport async function appendEntry(\n  action: HistoryAction,\n  packageName: string | null,\n  success: boolean,\n  error: string | null = null,\n): Promise<void> {\n  requirePro();\n  const entries = await loadHistory();\n\n  const entry: HistoryEntry = {\n    id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,\n    action,\n    packageName,\n    timestamp: new Date().toISOString(),\n    success,\n    error,\n  };\n\n  entries.unshift(entry);\n\n  if (entries.length > MAX_ENTRIES) {\n    entries.length = MAX_ENTRIES;\n  }\n\n  await saveHistory(entries);\n}\n\nexport async function clearHistory(): Promise<void> {\n  requirePro();\n  await saveHistory([]);\n}\n"],"mappings":";;;;;;;AAAA,SAAS,UAAU,WAAW,cAAc;AAK5C,IAAM,cAAc;AAEpB,eAAsB,cAAuC;AAC3D,aAAW;AAEX,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,cAAc,OAAO;AAChD,UAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,UAAM,UAAU,KAAK;AACrB,WAAO,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC;AAAA,EAC7C,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,eAAe,YAAY,SAAwC;AACjE,QAAM,eAAe;AACrB,QAAM,OAAoB,EAAE,SAAS,GAAG,QAAQ;AAChD,QAAM,MAAM,eAAe;AAC3B,QAAM,UAAU,KAAK,KAAK,UAAU,MAAM,MAAM,CAAC,GAAG,OAAO;AAC3D,QAAM,OAAO,KAAK,YAAY;AAChC;AAEA,eAAsB,YACpB,QACA,aACA,SACA,QAAuB,MACR;AACf,aAAW;AACX,QAAM,UAAU,MAAM,YAAY;AAElC,QAAM,QAAsB;AAAA,IAC1B,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAAA,IAC3D;AAAA,IACA;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC;AAAA,IACA;AAAA,EACF;AAEA,UAAQ,QAAQ,KAAK;AAErB,MAAI,QAAQ,SAAS,aAAa;AAChC,YAAQ,SAAS;AAAA,EACnB;AAEA,QAAM,YAAY,OAAO;AAC3B;AAEA,eAAsB,eAA8B;AAClD,aAAW;AACX,QAAM,YAAY,CAAC,CAAC;AACtB;","names":[]}