github-search-cli 0.8.1 → 0.9.0

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
@@ -17,12 +25,11 @@ npm install -g github-search-cli
 > **No separate runtime needed!** The package bundles a Bun binary, so the TUI
 > works out of the box on Windows, macOS, and Linux — no Node FFI, no `--experimental-ffi`.
 >
-> | Runtime | TUI | CLI modes |
-> |---------|-----|-----------|
-> | Bundled Bun | ✅ | ✅ |
-> | System Bun | ✅ | ✅ |
-> | Node 20–22 | ✅ | ✅ |
-> | Node 23+ | ❌ | ✅ |
+> | Runtime     | TUI | CLI modes |
+> | ----------- | --- | --------- |
+> | Bundled Bun | ✅  | ✅        |
+> | System Bun  | ✅  | ✅        |
+> | Node 20+    | ✅  | ✅        |
 
 ## Use
 
@@ -65,44 +72,82 @@ ghfind --completion fish | source
 <table>
 <tr><td><b>Search</b></td><td>Free-text + qualifiers (<code>language:</code>, <code>stars:</code>, <code>topic:</code>), sort by stars/updated/forks</td></tr>
 <tr><td><b>Trending</b></td><td>Today, week, month, year — filter by language</td></tr>
-<tr><td><b>Bookmarks</b></td><td><code>b</code> / <code>B</code> — save repos, tag them</td></tr>
-<tr><td><b>Deep-dive</b></td><td><code>d</code> — languages, contributors, README, activity chart</td></tr>
-<tr><td><b>Compare</b></td><td><code>c</code> / <code>C</code> — side-by-side, select 2+ repos</td></tr>
-<tr><td><b>Explore</b></td><td><code>E</code> — browse popular topics</td></tr>
-<tr><td><b>History</b></td><td><code>Ctrl+R</code> — recall past searches</td></tr>
-<tr><td><b>Export</b></td><td><code>Ctrl+E</code> — JSON, CSV, Markdown to file</td></tr>
-<tr><td><b>Share</b></td><td><code>Ctrl+P</code> — copy to clipboard (markdown, plain, gh-cli)</td></tr>
+<tr><td><b>Bookmarks</b></td><td>Space → Bookmark / Bookmarks panel — save repos, tag them</td></tr>
+<tr><td><b>Deep-dive</b></td><td>Space → Deep-dive — languages, contributors, README, activity chart</td></tr>
+<tr><td><b>Compare</b></td><td>Space → Compare select / Compare view — side-by-side, select 2+ repos</td></tr>
+<tr><td><b>Explore</b></td><td>Space → Topics — browse popular GitHub topics</td></tr>
+<tr><td><b>History</b></td><td>Space → History — recall past searches</td></tr>
+<tr><td><b>Saved</b></td><td>Space → Saved searches — load or save queries</td></tr>
+<tr><td><b>Export</b></td><td>Space → Export — JSON, CSV, Markdown to file</td></tr>
+<tr><td><b>Share</b></td><td>Space → Share repo — copy repo link to clipboard</td></tr>
+<tr><td><b>Notifications</b></td><td>Space → Notifications — view & dismiss alerts</td></tr>
+<tr><td><b>Graph</b></td><td>Space → Activity graph — commit chart, fullscreen toggle</td></tr>
+<tr><td><b>Help</b></td><td><code>?</code> / <code>Ctrl+H</code> — keybindings reference</td></tr>
 <tr><td><b>Watch</b></td><td><code>--watch</code> — poll for new results</td></tr>
 </table>
 
 <details>
 <summary>Keybindings</summary>
 
-| Key | Action |
-|-----|--------|
-| `/` | Focus search |
-| `Enter` | Search / open repo |
-| `↑`/`↓` / `j`/`k` | Navigate |
-| `t` | Toggle search / trending |
-| `s` | Cycle sort |
-| `l` | Cycle limit |
-| `r` | Refresh |
-| `d` | Deep-dive |
-| `o` | Open in browser |
-| `b` / `B` | Bookmark / bookmarks panel |
-| `c` / `C` | Compare select / view |
-| `E` | Topic explorer |
-| `Tab` | Auto-complete qualifier |
-| `?` / `Ctrl+H` | Help |
-| `Ctrl+R` | History |
-| `Ctrl+S` / `Ctrl+O` | Save / open searches |
-| `Ctrl+E` | Export |
-| `Ctrl+N` | Notifications |
-| `Ctrl+P` | Share |
-| `Esc` | Close overlay |
-| `q` | Quit |
-
-Trending tabs: `1`–`5` (Today → All) or `←`/`→` / `h`/`l`
+**Global shortcuts** (main view, no overlay active)
+
+| Key                   | Action                                         |
+| --------------------- | ---------------------------------------------- |
+| `/`                   | Focus search input                             |
+| `Enter`               | Execute search / open selected repo in browser |
+| `↑` / `↓` — `j` / `k` | Navigate results & menus                       |
+| `Space`               | Open leader menu (contextual actions)          |
+| `Tab`                 | Auto-complete search qualifier                 |
+| `?` or `Ctrl+H`       | Help overlay                                   |
+| `1`–`5`               | Switch trending tabs (Today → All)             |
+| `←` / `→` — `h` / `l` | Switch trending tabs (left/right)              |
+| `PageUp`              | Jump to top of results                         |
+| `PageDown`            | Load next page of results                      |
+| `Esc`                 | Close current overlay                          |
+| `q`                   | Quit ghfind                                    |
+
+**Leader menu** — press `Space`, navigate with `↑`/`↓`, press `Enter` to dispatch
+
+Actions shown depend on current mode (search vs trending) and selection:
+
+| Menu item       | Description                                             |
+| --------------- | ------------------------------------------------------- |
+| Sort            | Cycle sort strategy (best-match, stars, updated, forks) |
+| Limit           | Cycle result limit (10, 25, 50, 100)                    |
+| Refresh         | Re-run current search (or reload trending)              |
+| Toggle trending | Switch between search and trending views                |
+| Deep-dive       | Show languages, contributors, README excerpt            |
+| Readme          | Full README viewer                                      |
+| Activity graph  | Toggle commit chart fullscreen                          |
+| Bookmark        | Save / unsave selected repo                             |
+| Compare         | Add/remove repo to comparison set                       |
+| Compare view    | Show side-by-side comparison table                      |
+| Open in browser | Open selected repo URL                                  |
+| History         | Recall past searches                                    |
+| Saved searches  | Load a saved search                                     |
+| Save search     | Save current query                                      |
+| Export          | Export results to JSON / CSV / Markdown                 |
+| Share repo      | Copy repo link to clipboard                             |
+| Notifications   | View and dismiss alerts                                 |
+| Topics          | Browse popular GitHub topics                            |
+| Bookmarks panel | Browse saved bookmarks                                  |
+| Help            | Keybindings reference                                   |
+
+**Overlay-specific shortcuts**
+
+| Key             | Context                                              | Action                                      |
+| --------------- | ---------------------------------------------------- | ------------------------------------------- |
+| `Esc` / `q`     | Any overlay                                          | Close overlay                               |
+| `Enter`         | Leader / History / Saved / Export / Topics / Share   | Confirm selection                           |
+| `d`             | History / Bookmarks / Saved searches / Notifications | Delete current entry                        |
+| `Ctrl+X`        | History                                              | Clear all history                           |
+| `Ctrl+C`        | Notifications                                        | Dismiss all notifications                   |
+| `Y` / `N` / `L` | Update modal                                         | Yes (install) / No (skip) / Later (dismiss) |
+
+Trending tabs: `1`–`5` (Today → All) or `←`/`→` — `h`/`l`
+
+> Most actions are accessed via the **leader menu** (`Space`). This keeps the keymap minimal while providing a full command palette. The leader menu filters actions contextually — items that don't apply (e.g., Bookmark with no repo selected) are hidden.
+
 </details>
 
 ---
@@ -158,6 +203,33 @@ npm run build    # build dist/
 
 ---
 
+## Changelog
+
+### v0.8.2
+
+- Added automatic update checking against the npm registry
+- Added leader menu (Space) consolidating all contextual actions
+- Added update modal with Y/N/L (install now / skip / dismiss)
+- Added topic explorer, notifications panel, and saved searches overlay
+- Added activity graph toggle (commit chart fullscreen)
+- Added README viewer (full markdown rendering in TUI)
+- Added result auto-complete for search qualifiers (Tab)
+- Added PageUp/PageDown for quick navigation
+- Added Ctrl+X to clear history, Ctrl+C to clear all notifications
+- Improved export error handling and format selection
+- Updated keybindings reference
+
+### 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
+
+---
+
 ## License
 
-MIT
+MIT

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "github-search-cli",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "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/bookmarks.ts

@@ -1,30 +1,17 @@
 /**
  * Bookmarks — saved repos with tags, persisted as JSON.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
 import type { Bookmark, Repo } from "./types";
-import { stateDir } from "./config";
+import { readJSON, writeJSON } from "./storage";
 
-const BOOKMARK_FILE = join(stateDir(), "bookmarks.json");
-
-function ensureDir() {
-  mkdirSync(stateDir(), { recursive: true });
-}
+const BOOKMARK_FILE = "bookmarks.json";
 
 function loadRaw(): Bookmark[] {
-  ensureDir();
-  try {
-    const raw = readFileSync(BOOKMARK_FILE, "utf-8");
-    return JSON.parse(raw) as Bookmark[];
-  } catch {
-    return [];
-  }
+  return readJSON<Bookmark[]>(BOOKMARK_FILE, []);
 }
 
 function saveRaw(bookmarks: Bookmark[]): void {
-  ensureDir();
-  writeFileSync(BOOKMARK_FILE, JSON.stringify(bookmarks, null, 2));
+  writeJSON(BOOKMARK_FILE, bookmarks);
 }
 
 /** Get all bookmarks, newest first. */