github-search-cli 0.8.0 → 0.8.2

package/README.md

@@ -1,145 +1,182 @@
-# ghfind
-
-> Search GitHub repos from your terminal. No browser needed.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/codersdfs/search-cli/main/demo.svg" alt="ghfind demo" width="100%">
-</p>
-
----
-
-## Install
-
-```bash
-npm install -g github-search-cli
-```
-
-## Use
-
-```bash
-# TUI
-ghfind
-
-# pipe
-ghfind "language:Rust stars:>1000" --json | jq '.[].fullName'
-ghfind "language:Zig" --count
-ghfind --trending --json --since weekly
-```
-
-### Non-interactive
-
-```bash
-ghfind "query" --json        # JSON
-ghfind "query" --csv         # CSV
-ghfind "query" --markdown    # Markdown
-ghfind "query" --count       # count only
-ghfind "query" --format urls # one URL per line
-ghfind "query" --pipe open   # open in browser
-ghfind "query" --pipe clone  # clone commands
-ghfind --trending --json     # trending as JSON
-ghfind --watch "query"       # poll every 300s
-```
-
-### Completions
-
-```bash
-source <(ghfind --completion bash)
-source <(ghfind --completion zsh)
-ghfind --completion fish | source
-```
-
----
-
-## Features
-
-<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>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`
-</details>
-
----
-
-## Search syntax
-
-```
-language:Rust stars:>1000 topic:cli
-"machine learning" language:Python stars:>5000
-topic:cli -language:JavaScript
-org:rust-lang language:Rust
-```
-
-Prefix with `-` to exclude. Supported: `language`, `stars`, `fork`, `archived`, `topic`, `user`, `org`, `repo`, `updated`, `pushed`, `visibility`, `license`, `created`, `size`, `in`.
-
----
-
-## Config
-
-`~/.config/ghfind/config.json` (auto-created, or run `ghfind init`):
-
-```json
-{
-  "defaultSort": "stars",
-  "defaultLimit": 50,
-  "theme": "tokyo-night",
-  "githubToken": "ghp_..."
-}
-```
-
-Env: `GITHUB_TOKEN`, `GHFIND_CONFIG`, `XDG_CONFIG_HOME`, `XDG_STATE_HOME`
-
----
-
-## From source
-
-```bash
-git clone https://github.com/codersdfs/search-cli.git
-cd ghfind
-npm install
-npm start    # TUI
-npm test     # 100+ tests
-npm run build
-```
-
----
-
-## License
-
+# ghfind
+
+> 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
+
+```bash
+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+ | ✅ | ✅ |
+
+## Use
+
+```bash
+# TUI
+ghfind
+
+# pipe
+ghfind "language:Rust stars:>1000" --json | jq '.[].fullName'
+ghfind "language:Zig" --count
+ghfind --trending --json --since weekly
+```
+
+### Non-interactive
+
+```bash
+ghfind "query" --json        # JSON
+ghfind "query" --csv         # CSV
+ghfind "query" --markdown    # Markdown
+ghfind "query" --count       # count only
+ghfind "query" --format urls # one URL per line
+ghfind "query" --pipe open   # open in browser
+ghfind "query" --pipe clone  # clone commands
+ghfind --trending --json     # trending as JSON
+ghfind --watch "query"       # poll every 300s
+```
+
+### Completions
+
+```bash
+source <(ghfind --completion bash)
+source <(ghfind --completion zsh)
+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>
+<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>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`
+</details>
+
+---
+
+## Search syntax
+
+```
+language:Rust stars:>1000 topic:cli
+"machine learning" language:Python stars:>5000
+topic:cli -language:JavaScript
+org:rust-lang language:Rust
+```
+
+Prefix with `-` to exclude. Supported: `language`, `stars`, `fork`, `archived`, `topic`, `user`, `org`, `repo`, `updated`, `pushed`, `visibility`, `license`, `created`, `size`, `in`.
+
+---
+
+## Config
+
+`~/.config/ghfind/config.json` (auto-created, or run `ghfind init`):
+
+```json
+{
+  "defaultSort": "stars",
+  "defaultLimit": 50,
+  "theme": "tokyo-night",
+  "githubToken": "ghp_..."
+}
+```
+
+Env: `GITHUB_TOKEN`, `GHFIND_CONFIG`, `XDG_CONFIG_HOME`, `XDG_STATE_HOME`
+
+---
+
+## From source
+
+```bash
+git clone https://github.com/codersdfs/search-cli.git
+cd ghfind
+
+# With Bun (recommended for TUI)
+bun install
+bun start        # TUI
+bun test         # 102 tests
+bun run build    # build dist/
+
+# Or with npm
+npm install
+npm start        # TUI (requires Node 20-22 for native FFI)
+npm test         # vitest (TUI render test needs Bun)
+npm run build    # build dist/
+```
+
+---
+
+## License
+
 MIT

package/bin/ghfind.js

@@ -1,14 +1,55 @@
 #!/usr/bin/env node
-/**
- * ghfind — npm bin entry point.
- * Requires Node.js >= 20.
- */
-import { createRequire } from "module";
-const require = createRequire(import.meta.url);
-try {
-  await import("../src/cli.ts");
-} catch (err) {
-  console.error("Failed to start ghfind. Node.js >= 20 required.");
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-}
+/**
+ * ghfind — npm bin entry point.
+ * Requires Node.js >= 20 or Bun.
+ *
+ * Uses the bundled Bun binary (vendor/bun.exe) to run the TypeScript source
+ * directly, so users don't need to install Bun separately. Falls back to
+ * the bundled dist/cli.js if present, or system Bun/Node.
+ */
+import { existsSync } from "fs";
+import { spawnSync } from "child_process";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { platform } from "os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_DIR = join(__dirname, "..");
+
+// Path to bundled Bun binary
+const BUN_BIN = join(PKG_DIR, "vendor", platform() === "win32" ? "bun.exe" : "bun");
+
+// Path to bundled dist
+const distCli = join(PKG_DIR, "dist", "cli.js");
+
+// Path to source
+const srcCli = join(PKG_DIR, "src", "cli.ts");
+
+// Strategy 1: Use bundled Bun to run source directly (always works, no Node FFI needed)
+if (existsSync(BUN_BIN) && existsSync(srcCli)) {
+  const result = spawnSync(BUN_BIN, ["run", srcCli, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: { ...process.env, GHFIND_BUNDLED: "1" },
+  });
+  process.exit(result.status ?? 0);
+}
+
+// Strategy 2: Use bundled dist/cli.js with Node (non-interactive only on Node 23+)
+if (existsSync(distCli)) {
+  try {
+    await import(distCli);
+  } catch (err) {
+    console.error("Failed to start ghfind. Node.js >= 20 or Bun required.");
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+} else {
+  // Strategy 3: Fallback to system Bun/Node running source
+  try {
+    await import("../src/cli.ts");
+  } catch (err) {
+    console.error("Failed to start ghfind. Node.js >= 20 or Bun required.");
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}

package/completions/ghfind.fish

@@ -1,19 +1,19 @@
-# ghfind fish completion
-# Source: source (ghfind --completion fish | psub)
-
-complete -c ghfind -l json -d "JSON output"
-complete -c ghfind -l csv -d "CSV output"
-complete -c ghfind -l markdown -d "Markdown table output"
-complete -c ghfind -l count -d "Only result count"
-complete -c ghfind -l limit -d "Max results" -r
-complete -c ghfind -l sort -d "Sort strategy" -r -f -a "best-match stars updated forks"
-complete -c ghfind -l token -d "GitHub token" -r
-complete -c ghfind -l trending -d "Trending mode"
-complete -c ghfind -l since -d "Trending period" -r -f -a "daily weekly monthly"
-complete -c ghfind -l pipe -d "Pipe target" -r -f -a "clone open"
-complete -c ghfind -l format -d "Output format" -r -f -a "urls names ssh-urls clone-commands ids"
-complete -c ghfind -l watch -d "Watch mode"
-complete -c ghfind -l interval -d "Watch interval seconds" -r
-complete -c ghfind -l version -d "Print version"
-complete -c ghfind -l help -d "Print help"
+# ghfind fish completion
+# Source: source (ghfind --completion fish | psub)
+
+complete -c ghfind -l json -d "JSON output"
+complete -c ghfind -l csv -d "CSV output"
+complete -c ghfind -l markdown -d "Markdown table output"
+complete -c ghfind -l count -d "Only result count"
+complete -c ghfind -l limit -d "Max results" -r
+complete -c ghfind -l sort -d "Sort strategy" -r -f -a "best-match stars updated forks"
+complete -c ghfind -l token -d "GitHub token" -r
+complete -c ghfind -l trending -d "Trending mode"
+complete -c ghfind -l since -d "Trending period" -r -f -a "daily weekly monthly"
+complete -c ghfind -l pipe -d "Pipe target" -r -f -a "clone open"
+complete -c ghfind -l format -d "Output format" -r -f -a "urls names ssh-urls clone-commands ids"
+complete -c ghfind -l watch -d "Watch mode"
+complete -c ghfind -l interval -d "Watch interval seconds" -r
+complete -c ghfind -l version -d "Print version"
+complete -c ghfind -l help -d "Print help"
 complete -c ghfind -l completion -d "Shell" -r -f -a "bash zsh fish"

package/completions/ghfind.zsh

@@ -1,27 +1,27 @@
-# ghfind zsh completion
-# Source: source <(ghfind --completion zsh)
-
-_ghfind() {
-  local -a opts
-  opts=(
-    '--json[JSON output]'
-    '--csv[CSV output]'
-    '--markdown[Markdown table output]'
-    '--count[Only result count]'
-    '--limit[Max results]:limit:'
-    '--sort[Sort strategy]:(best-match stars updated forks)'
-    '--token[GitHub token]:token:'
-    '--trending[Trending mode]'
-    '--since[Trending period]:(daily weekly monthly)'
-    '--pipe[Pipe target]:(clone open)'
-    '--format[Output format]:(urls names ssh-urls clone-commands ids)'
-    '--watch[Watch mode]'
-    '--interval[Watch interval seconds]:seconds:'
-    '--version[Print version]'
-    '--help[Print help]'
-    '--completion[Shell]:(bash zsh fish)'
-  )
-  _arguments "${opts[@]}" '*:query:'
-}
-
+# ghfind zsh completion
+# Source: source <(ghfind --completion zsh)
+
+_ghfind() {
+  local -a opts
+  opts=(
+    '--json[JSON output]'
+    '--csv[CSV output]'
+    '--markdown[Markdown table output]'
+    '--count[Only result count]'
+    '--limit[Max results]:limit:'
+    '--sort[Sort strategy]:(best-match stars updated forks)'
+    '--token[GitHub token]:token:'
+    '--trending[Trending mode]'
+    '--since[Trending period]:(daily weekly monthly)'
+    '--pipe[Pipe target]:(clone open)'
+    '--format[Output format]:(urls names ssh-urls clone-commands ids)'
+    '--watch[Watch mode]'
+    '--interval[Watch interval seconds]:seconds:'
+    '--version[Print version]'
+    '--help[Print help]'
+    '--completion[Shell]:(bash zsh fish)'
+  )
+  _arguments "${opts[@]}" '*:query:'
+}
+
 compdef _ghfind ghfind