github-search-cli 0.8.1 → 0.8.2

package/README.md

@@ -2,10 +2,18 @@
 
 > Search GitHub repos from your terminal. No browser needed.
 
+<p align="center">
+  <a href="https://x.com/frankli23709971">
+    <img src="https://img.shields.io/badge/made%20by-%40frankli23709971-000000?logo=x&labelColor=000000&color=000000&link=https://x.com/frankli23709971" alt="Made by @frankli23709971">
+  </a>
+</p>
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/codersdfs/search-cli/main/demo.svg" alt="ghfind demo" width="100%">
 </p>
 
+[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ---
 
 ## Install
@@ -21,8 +29,7 @@ npm install -g github-search-cli
 > |---------|-----|-----------|
 > | Bundled Bun | ✅ | ✅ |
 > | System Bun | ✅ | ✅ |
-> | Node 20–22 | ✅ | ✅ |
-> | Node 23+ | ❌ | ✅ |
+> | Node 20+ | ✅ | ✅ |
 
 ## Use
 
@@ -60,6 +67,18 @@ ghfind --completion fish | source
 
 ---
 
+## Changelog
+
+### v0.8.1
+- Fixed postinstall to download Bun binary correctly on all platforms
+- Fixed zip asset names to match Bun's current release naming
+- Fixed zip parsing to use central directory instead of local file headers
+- Removed `vendor/` from npm package (Bun binary downloaded at install time)
+- Changed `postinstall` to use `node` instead of `bun run` (works without Bun pre-installed)
+- TUI now works on Node.js 20+ via bundled Bun binary
+
+---
+
 ## Features
 
 <table>

package/bin/ghfind.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * ghfind — npm bin entry point.
  * Requires Node.js >= 20 or Bun.

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "github-search-cli",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Terminal-native GitHub search — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
   "type": "module",
+  "packageManager": "bun@1",
+  "volta": {
+    "extensions": [".ts"]
+  },
   "bin": {
     "ghfind": "bin/ghfind.js"
   },
+  "bun": {
+    "smol": true
+  },
   "files": [
     "bin/",
     "src/",
-    "vendor/",
+    "scripts/",
     "completions/",
     "demo.svg",
     "LICENSE",
@@ -18,13 +25,12 @@
   "scripts": {
     "start": "bun run src/cli.ts",
     "build": "tsup",
-    "prepublishOnly": "npm run build",
-    "test": "vitest run",
-    "test:bun": "bun test",
+    "prepublishOnly": "bun run build",
+    "test": "bun test",
     "dev": "bun run --watch src/tui.ts",
     "postinstall": "node scripts/postinstall.js",
-    "format:check": "prettier --check .",
-    "format": "prettier --write ."
+    "format:check": "bunx prettier --check .",
+    "format": "bunx prettier --write ."
   },
   "dependencies": {
     "@opentui/core": "^0.4.3"
@@ -34,12 +40,11 @@
     "@types/node": "^20.0.0",
     "prettier": "^3.2.0",
     "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.2.0"
+    "typescript": "^5.3.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.0.0",
+    "bun": ">=1.0.0"
   },
   "repository": {
     "type": "git",

package/scripts/brew.rb

@@ -0,0 +1,32 @@
+# typed: true
+# frozen_string_literal: true
+
+class SearchCli < Formula
+  desc "Interactive GitHub repository browser for the terminal"
+  homepage "https://github.com/frank/search-cli"
+  version "0.1.0"
+  license "MIT"
+
+  on_macos do
+    if Hardware::CPU.arm?
+      url "https://github.com/frank/search-cli/releases/download/v#{version}/search-cli-darwin-arm64"
+      sha256 "SHA256_PLACEHOLDER"
+    else
+      url "https://github.com/frank/search-cli/releases/download/v#{version}/search-cli-darwin-x64"
+      sha256 "SHA256_PLACEHOLDER"
+    end
+  end
+
+  on_linux do
+    url "https://github.com/frank/search-cli/releases/download/v#{version}/search-cli-linux-x64"
+    sha256 "SHA256_PLACEHOLDER"
+  end
+
+  def install
+    bin.install "search-cli"
+  end
+
+  test do
+    assert_match "search-cli", shell_output("#{bin}/search-cli --version")
+  end
+end

package/scripts/build.ts

@@ -0,0 +1,19 @@
+/**
+ * Build script — compile ghfind for distribution.
+ * Usage: npm run build
+ */
+import { execFileSync } from "child_process";
+
+async function main() {
+  console.log("Building ghfind...");
+
+  // ESM bundle via tsup
+  execFileSync("npx", ["tsup", "src/cli.ts", "--format", "esm", "--target", "node20", "--out-dir", "dist", "--external", "@opentui/core"], { stdio: "inherit" });
+
+  console.log("✓ dist/cli.js (Node.js ESM bundle)");
+}
+
+main().catch((err) => {
+  console.error("Build failed:", err.message);
+  process.exit(1);
+});

package/scripts/generate-svg-demo.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+/**
+ * Generate an SVG screenshot of ghfind matching the actual TUI layout.
+ * Single frame with blinking cursor — honest and accurate.
+ *
+ * Usage: node scripts/generate-svg-demo.js > demo.svg
+ */
+
+const C = {
+  bg: "#1e1e2e",
+  surface: "#181825",
+  text: "#cdd6f4",
+  muted: "#6c7086",
+  blue: "#89b4fa",
+  green: "#a6e3a1",
+  yellow: "#f9e2af",
+  red: "#f38ba8",
+  teal: "#94e2d5",
+  border: "#45475a",
+  selBg: "#2d5bcf",
+  selText: "#ffffff",
+  star: "#f9e2af",
+};
+
+const FW = 9.6, FH = 21, PX = 14, PY = 12, WIN_H = 36;
+const W = 90, H = 35;
+const SW = Math.round(W * FW + PX * 2 + 8);
+const SH = Math.round(H * FH + PY * 2 + WIN_H + 8);
+
+const esc = s => String(s).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");
+
+const repos = [
+  {fn:"shadcn/ui",s:78500,l:"TypeScript"},
+  {fn:"vercel/next.js",s:129000,l:"TypeScript"},
+  {fn:"tailwindlabs/tailwindcss",s:84200,l:"CSS"},
+  {fn:"tauri-apps/tauri",s:84100,l:"Rust"},
+  {fn:"oven-sh/bun",s:74500,l:"Zig"},
+  {fn:"n8n-io/n8n",s:54400,l:"TypeScript"},
+  {fn:"astral-sh/ruff",s:36100,l:"Rust"},
+  {fn:"missive/emoji-mart",s:8800,l:"TypeScript"},
+  {fn:"sharkdp/bat",s:50300,l:"Rust"},
+  {fn:"BurntSushi/ripgrep",s:48800,l:"Rust"},
+  {fn:"jdx/mise",s:14300,l:"Rust"},
+  {fn:"nektos/act",s:56100,l:"Go"},
+  {fn:"astral-sh/uv",s:40200,l:"Rust"},
+  {fn:"zed-industries/zed",s:52000,l:"Rust"},
+];
+
+const f = n => n >= 1000 ? `★ ${(n/1000).toFixed(1).replace(/\.0$/,"")}k` : `★ ${n}`;
+const num = n => n.toLocaleString();
+
+function tx(x, y, text, fill, cls="") {
+  const c = cls ? ` class="${cls}"` : "";
+  return `<text x="${x}" y="${y}" fill="${fill}" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14"${c}>${esc(text)}</text>\n`;
+}
+
+function rx(x, y, w, h, fill, stroke="", r=0) {
+  const s = stroke ? ` stroke="${stroke}" stroke-width="1"` : "";
+  const rc = r ? ` rx="${r}"` : "";
+  return `<rect x="${x}" y="${y}" width="${w}" height="${h}" fill="${fill}"${s}${rc}/>\n`;
+}
+
+let svg = "";
+
+// ─── Header ──
+svg += tx(PX, PY+WIN_H+14, "ghfind — GitHub repo browser   [t]rending  [/]search  [g]raph  [r]efresh  [q]uit", C.muted);
+
+// ─── Search box (blue border, 3 lines height) ──
+const sbY = PY+WIN_H+1*FH;
+svg += rx(PX, sbY, W*FW-4, FH*2.5+2, C.bg, C.blue, 3);
+svg += tx(PX+8, sbY+FH-2, "> language:TypeScript stars:>1000", C.blue);
+
+// ─── Toolbar ──
+svg += tx(PX, PY+WIN_H+4.2*FH+14, "sort: stars   limit: 50   (s=cycle sort  l=cycle limit)", C.muted);
+
+// ─── Body: Results (left) + Detail (right) ──
+const bY = 5.5;
+const paneW = (W*FW-8)/2;
+const pH = 18;
+
+// Left pane background
+svg += rx(PX, PY+WIN_H+(bY-0.2)*FH, paneW+4, pH*FH, C.bg, C.border, 3);
+svg += tx(PX+8, PY+WIN_H+(bY)*FH+14, " Results ", C.blue);
+
+// Results list
+repos.forEach((r, i) => {
+  if (i >= 14) return;
+  const ry = bY + 1 + i * 1.1;
+  const isSel = i === 0;
+  if (isSel) {
+    svg += rx(PX+4, PY+WIN_H+(ry-0.3)*FH, paneW-4, FH-1, C.selBg, "", 3);
+  }
+  const fgc = isSel ? C.selText : C.text;
+  const line = `${r.fn}  ${f(r.s)}`;
+  svg += tx(PX+10, PY+WIN_H+ry*FH+14, line, fgc);
+});
+
+// Right pane background
+svg += rx(PX+paneW+8, PY+WIN_H+(bY-0.2)*FH, paneW+4, pH*FH, C.bg, C.border, 3);
+svg += tx(PX+paneW+14, PY+WIN_H+(bY)*FH+14, " Details ", C.green);
+
+// Detail content (matches actual format from tui.ts line ~685)
+const detail = [
+  `Name     shadcn/ui`,
+  `Stars    ${num(78500)}`,
+  `Forks    ${num(4200)}`,
+  `Lang     TypeScript`,
+  `Updated  2026-07-12`,
+  `Topics   react, ui, components, shadcn`,
+  ``,
+  `Beautifully designed components built with Radix UI and`,
+  `Tailwind CSS.`,
+  ``,
+  `https://github.com/shadcn/ui`,
+];
+
+detail.forEach((line, i) => {
+  if (line === "") return;
+  const ry = bY + 1 + i * 1.1;
+  let fgc = C.text;
+  if (i <= 5) fgc = C.muted;
+  if (line.startsWith("http")) fgc = C.blue;
+  svg += tx(PX+paneW+16, PY+WIN_H+ry*FH+14, line, fgc);
+});
+
+// ─── Bottom status bar ──
+svg += rx(PX, PY+WIN_H+21*FH, W*FW-4, FH+4, C.surface, "", 3);
+svg += rx(PX, PY+WIN_H+21*FH, W*FW-4, 2, C.border);
+svg += tx(PX+4, PY+WIN_H+21.9*FH+14, "15,842 results  (↑↓ nav  Enter open  o browser  Ctrl+R history)", C.muted);
+
+// ─── Cursor blinking after query text ──
+const queryText = "language:TypeScript stars:>1000";
+const cursorX = PX + 8 + 2 * FW + queryText.length * FW;
+svg += `<rect x="${cursorX}" y="${PY + WIN_H + 1 * FH + 1}" width="${FW * 0.6}" height="16" fill="${C.blue}" opacity="0.8">
+  <animate attributeName="opacity" values="0.8;0.1;0.8" dur="1s" repeatCount="indefinite"/>
+</rect>\n`;
+
+// ─── Assemble ──
+const output = `<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${SW} ${SH}" width="${SW}" height="${SH}">
+  <defs>
+    <style>
+      @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&amp;display=swap');
+    </style>
+    <filter id="shadow" x="-5%" y="-5%" width="115%" height="115%">
+      <feDropShadow dx="0" dy="4" stdDeviation="8" flood-color="#000" flood-opacity="0.4"/>
+    </filter>
+  </defs>
+
+  <rect width="100%" height="100%" fill="#0d0d1a"/>
+
+  <!-- Window -->
+  <rect x="${PX-2}" y="${PY-2}" width="${SW-PX*2+4}" height="${SH-PY*2+4}" fill="${C.bg}" rx="8" filter="url(#shadow)"/>
+  <rect x="${PX-2}" y="${PY-2}" width="${SW-PX*2+4}" height="36" fill="${C.surface}" rx="8"/>
+  <rect x="${PX-2}" y="${PY+34}" width="${SW-PX*2+4}" height="2" fill="#313244"/>
+
+  <!-- Traffic lights -->
+  <circle cx="${PX+10}" cy="${PY+16}" r="5" fill="#f38ba8"/>
+  <circle cx="${PX+28}" cy="${PY+16}" r="5" fill="#f9e2af"/>
+  <circle cx="${PX+46}" cy="${PY+16}" r="5" fill="#a6e3a1"/>
+  <text x="${SW/2}" y="${PY+22}" fill="${C.muted}" font-family="'JetBrains Mono','Fira Code',monospace" font-size="13" text-anchor="middle">ghfind — terminal GitHub browser</text>
+
+  <g font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">
+    ${svg}
+  </g>
+</svg>`;
+
+process.stdout.write(output);

package/scripts/postinstall.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script — ensures a Bun binary is available for ghfind.
+ *
+ * If vendor/bun or vendor/bun.exe already exists (bundled with the package),
+ * this is a no-op. Otherwise, it attempts to download the correct binary
+ * for the user's platform.
+ */
+import { existsSync, mkdirSync, chmodSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { platform, arch } from "os";
+import { inflateRawSync } from "zlib";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+const VENDOR_DIR = join(ROOT, "vendor");
+
+const bunName = platform() === "win32" ? "bun.exe" : "bun";
+const bunPath = join(VENDOR_DIR, bunName);
+
+// Already bundled — nothing to do
+if (existsSync(bunPath)) {
+  process.exit(0);
+}
+
+// Skip in CI/test environments
+if (process.env.GHFIND_SKIP_BUN === "1" || process.env.CI === "true") {
+  process.exit(0);
+}
+
+// Try to download
+const map = {
+  "win32-x64": "bun-windows-x64.zip",
+  "win32-arm64": "bun-windows-aarch64.zip",
+  "darwin-x64": "bun-darwin-x64.zip",
+  "darwin-arm64": "bun-darwin-aarch64.zip",
+  "linux-x64": "bun-linux-x64-musl.zip",
+  "linux-arm64": "bun-linux-aarch64-musl.zip",
+};
+
+const key = `${platform()}-${arch}`;
+const assetName = map[key];
+const version = "1.3.12";
+
+if (!assetName) {
+  console.error(`[ghfind] Unsupported platform: ${key}. Install Bun manually: https://bun.sh`);
+  process.exit(0);
+}
+
+const url = `https://github.com/oven-sh/bun/releases/download/bun-v${version}/${assetName}`;
+
+try {
+  mkdirSync(VENDOR_DIR, { recursive: true });
+  console.error(`[ghfind] Downloading Bun ${version} for ${key}...`);
+
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+
+  const buffer = Buffer.from(await res.arrayBuffer());
+
+  // Find the central directory file header signature (PK\x01\x02)
+  const cdSig = "PK\x01\x02";
+  let cdOffset = buffer.indexOf(cdSig, 0);
+  while (cdOffset !== -1) {
+    const nameLen = buffer.readUInt16LE(cdOffset + 28);
+    const extraLen = buffer.readUInt16LE(cdOffset + 30);
+    const commentLen = buffer.readUInt16LE(cdOffset + 32);
+    const localHeaderOffset = buffer.readUInt32LE(cdOffset + 42);
+    const compSize = buffer.readUInt32LE(cdOffset + 20);
+    const compMethod = buffer.readUInt16LE(cdOffset + 10);
+    const nameStart = cdOffset + 46;
+    const fileName = buffer.subarray(nameStart, nameStart + nameLen).toString("utf8");
+
+    if (fileName.endsWith(bunName)) {
+      // Read the local file header to get the actual data offset
+      const localSig = buffer.readUInt32LE(localHeaderOffset);
+      if (localSig !== 0x04034b50) throw new Error("Invalid local file header");
+      const localNameLen = buffer.readUInt16LE(localHeaderOffset + 26);
+      const localExtraLen = buffer.readUInt16LE(localHeaderOffset + 28);
+      const dataOffset = localHeaderOffset + 30 + localNameLen + localExtraLen;
+
+      let fileData;
+      if (compMethod === 0) {
+        // Stored (no compression)
+        fileData = buffer.subarray(dataOffset, dataOffset + compSize);
+      } else {
+        // Deflated
+        fileData = inflateRawSync(buffer.subarray(dataOffset, dataOffset + compSize));
+      }
+
+      writeFileSync(bunPath, fileData);
+      if (platform() !== "win32") chmodSync(bunPath, 0o755);
+      console.error(`[ghfind] Bun installed to vendor/${bunName}`);
+      process.exit(0);
+    }
+
+    cdOffset = buffer.indexOf(cdSig, cdOffset + 4);
+  }
+
+  throw new Error("Bun binary not found in archive");
+} catch (err) {
+  console.error(`[ghfind] Failed to download Bun: ${err instanceof Error ? err.message : String(err)}`);
+  console.error("[ghfind] Install Bun manually: https://bun.sh/docs/install");
+  process.exit(0);
+}

package/src/tui.ts

@@ -90,11 +90,21 @@ export async function launchBrowser(): Promise<void> {
   try {
     renderer = await createCliRenderer();
   } catch (err) {
-    console.error(
-      "Failed to start the interactive browser. OpenTUI native backend unavailable.\n",
-      `Reason: ${err instanceof Error ? err.message : String(err)}\n`,
-      "Install Zig or use a platform with native OpenTUI support.",
-    );
+    const isNode = process.versions.bun === undefined;
+    if (isNode) {
+      console.error("\n❌  The interactive TUI requires Bun runtime.\n");
+      console.error("  Install Bun:  curl -fsSL https://bun.sh/install | bash");
+      console.error("  Then run:    bunx ghfind");
+      console.error("\n  Or use non-interactive mode (works on Node.js):");
+      console.error("  ghfind \"language:Rust\" --json | jq '.[].fullName'");
+      console.error("  ghfind --trending --count");
+    } else {
+      console.error(
+        "Failed to start the interactive browser. OpenTUI native backend unavailable.\n",
+        `Reason: ${err instanceof Error ? err.message : String(err)}\n`,
+        "Install Zig or use a platform with native OpenTUI support.",
+      );
+    }
     process.exit(1);
     return;
   }
@@ -1534,9 +1544,14 @@ export async function launchBrowser(): Promise<void> {
       return;
     }
 
-    // Space opens leader menu
-    if (key.name === "space") {
-      showLeaderMenu();
+    // Space toggles leader menu (open if closed, close if open)
+    // Skip when the search input is focused so spaces can be typed in queries
+    if (key.name === "space" && !searchInput.focused) {
+      if (currentOverlay === "leader") {
+        showOverlay("none");
+      } else {
+        showLeaderMenu();
+      }
       return;
     }