@shuyhere/bb-agent 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to BB-Agent will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.6] - 2026-04-06
+
+### Fixed
+
+- npm launcher no longer recurses into itself when the native binary is missing
+- npm postinstall now better detects whether the current package already has a usable native binary
+- clearer npm fallback messaging when matching GitHub release assets are not yet available
+
+### Added
+
+- **Fullscreen TUI** with streaming output, markdown rendering, and syntax highlighting
+- **Multi-provider support**: Anthropic (Claude), OpenAI, Google (Gemini), Groq, xAI, OpenRouter, and custom OpenAI-compatible endpoints
+- **Built-in tools**: `read`, `write`, `edit`, `bash`, `find`, `grep`, `ls`, `web_search`, `web_fetch`, `browser_fetch`
+- **Session persistence** with SQLite-backed storage, branching, forking, and tree navigation
+- **Extensions** via JS/TS plugin system for custom tools, commands, and event hooks
+- **Skills** — markdown-based instruction files that auto-load contextual knowledge
+- **System prompt templates** — save named prompts in `~/.bb-agent/system-prompts/` and use with `bb -t <name>`
+- **OAuth login** for Anthropic and OpenAI (browser-based PKCE flow)
+- **`@` file mention** autocomplete in the input area
+- **`/` slash commands** for session management, model switching, and more
+- **Layered configuration** — global `~/.bb-agent/settings.json` merged with project `.bb-agent/settings.json`
+- **`AGENTS.md`** support (like Claude's `CLAUDE.md`) for persistent system prompt additions
+- **Custom models and providers** via settings.json
+- **Auto-retry** with exponential backoff and server-hinted delays
+- **Session compaction** to keep context within model limits
+- **Package management** — install skills/extensions from npm, git, or local paths
+- **Print mode** (`bb -p`) for non-interactive scripted usage
+- **Session resume** (`bb -c` to continue, `bb -r` to pick)
+
+[0.0.6]: https://github.com/shuyhere/bb-agent/releases/tag/v0.0.6

package/README.md

@@ -23,18 +23,35 @@ cargo install --path crates/cli
 
 This compiles the `bb` binary and installs it to `~/.cargo/bin/bb` (which Rust adds to your PATH).
 
-### npm (Linux x86_64 — prebuilt binary)
+### npm (Linux/macOS x86_64 + arm64 — downloads matching prebuilt binary when available)
 
 ```bash
 npm install -g @shuyhere/bb-agent
 ```
 
-> **macOS / other platforms:** npm install will print instructions to build from source.
-> Prebuilt binaries for macOS coming soon. After install, run `bb` to start.
+> If no matching prebuilt binary is available for your platform, npm install will print source-build instructions instead. After install, run `bb` to start.
 
 ## Getting Started
 
-### 1. Login to a provider
+### 1. Start the TUI
+
+```bash
+bb
+```
+
+That's the recommended way to get started.
+
+### 2. Log in with `/login`
+
+Inside the TUI, run:
+
+```text
+/login
+```
+
+This opens the provider picker and auth flow directly in the fullscreen UI.
+
+If you prefer, you can also log in from a normal terminal:
 
 ```bash
 bb login              # Interactive provider selection
@@ -45,12 +62,6 @@ bb login google       # Login to Google (API key)
 
 Or set environment variables: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`, etc.
 
-### 2. Start the TUI
-
-```bash
-bb
-```
-
 That's it! Run `bb` to launch the fullscreen interactive terminal UI. Type your prompt and press Enter.
 
 ### More ways to use `bb`
@@ -75,7 +86,7 @@ bb --list-models                      # List all available models
 - **Extensions** — JS/TS plugin system for custom tools, commands, and hooks
 - **Skills** — markdown-based instruction files that auto-load contextual knowledge
 - **System prompt templates** — save and switch between named prompt configurations
-- **OAuth login** — browser-based login for Anthropic and OpenAI
+- **OAuth login** — browser/device login for Anthropic, OpenAI, and GitHub Copilot
 
 ## System Prompt Templates
 

package/bin/bb

@@ -5,6 +5,19 @@
 var execFileSync = require("child_process").execFileSync;
 var path = require("path");
 var fs = require("fs");
+var packageJson = require("../package.json");
+
+var wrapperRealPath = null;
+try { wrapperRealPath = fs.realpathSync(__filename); } catch (e) {}
+
+function isSelfBinary(candidate) {
+  try {
+    if (!wrapperRealPath) return false;
+    return fs.realpathSync(candidate) === wrapperRealPath;
+  } catch (e) {
+    return false;
+  }
+}
 
 function findBinary() {
   var nativeBin = path.join(__dirname, "..", "native", "bb");
@@ -16,7 +29,11 @@ function findBinary() {
   for (var i = 0; i < dirs.length; i++) {
     if (path.resolve(dirs[i]) === path.resolve(__dirname)) continue;
     var full = path.join(dirs[i], "bb");
-    try { fs.accessSync(full, fs.constants.X_OK); return full; } catch (e) {}
+    try {
+      fs.accessSync(full, fs.constants.X_OK);
+      if (isSelfBinary(full)) continue;
+      return full;
+    } catch (e) {}
   }
 
   return null;
@@ -26,23 +43,27 @@ var binary = findBinary();
 
 if (!binary) {
   console.error("");
-  console.error("BB-Agent binary not found.");
+  console.error("BB-Agent native binary not found.");
+  console.error("");
+  console.error("This npm package is a small launcher and expects a matching native binary.");
+  console.error("That binary may not have been downloaded yet for version " + packageJson.version + ".");
   console.error("");
-  console.error("Install Rust (if needed):");
-  console.error("  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh");
-  console.error("  source ~/.cargo/env");
+  console.error("Try reinstalling after the GitHub release assets are available:");
+  console.error("  npm uninstall -g @shuyhere/bb-agent");
+  console.error("  npm install -g @shuyhere/bb-agent@" + packageJson.version);
   console.error("");
-  console.error("Then build BB-Agent:");
+  console.error("Or build from source:");
   console.error("  git clone https://github.com/shuyhere/bb-agent.git");
   console.error("  cd bb-agent && cargo install --path crates/cli");
   console.error("");
-  console.error("Then run:  bb");
-  console.error("");
   process.exit(1);
 }
 
 try {
-  execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  execFileSync(binary, process.argv.slice(2), {
+    stdio: "inherit",
+    env: Object.assign({}, process.env, { BB_NPM_WRAPPER_ACTIVE: "1" })
+  });
 } catch (err) {
   process.exit(err.status || 1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuyhere/bb-agent",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "BB-Agent — a Rust-native AI coding agent for the terminal",
   "license": "MIT",
   "repository": {
@@ -28,6 +28,7 @@
     "bin/",
     "scripts/",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {

package/scripts/postinstall.js

@@ -8,9 +8,11 @@ const path = require("path");
 const os = require("os");
 const https = require("https");
 
-// Binary release tag — update this when you push a new GitHub release with binaries.
-const BINARY_RELEASE_TAG = "v0.0.1";
+const packageJson = require("../package.json");
+const BINARY_RELEASE_TAG = `v${packageJson.version}`;
 const REPO = "shuyhere/bb-agent";
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const WRAPPER_SCRIPT = path.join(PACKAGE_ROOT, "bin", "bb");
 const NATIVE_DIR = path.join(__dirname, "..", "native");
 const DOWNLOAD_TIMEOUT_MS = 15_000;
 
@@ -85,12 +87,21 @@ async function tryDownloadPrebuilt(target) {
   }
 }
 
+function isCurrentPackageWrapper(candidate) {
+  try {
+    return fs.realpathSync(candidate) === fs.realpathSync(WRAPPER_SCRIPT);
+  } catch {
+    return false;
+  }
+}
+
 function findInPath(name) {
   const dirs = (process.env.PATH || "").split(path.delimiter);
   for (const dir of dirs) {
     const full = path.join(dir, name);
     try {
       fs.accessSync(full, fs.constants.X_OK);
+      if (isCurrentPackageWrapper(full)) continue;
       return full;
     } catch {}
   }
@@ -130,6 +141,8 @@ async function main() {
   // (cargo build takes 5+ minutes and would appear to hang)
   const platform = `${os.platform()}-${os.arch()}`;
   console.log("");
+  console.log(`BB-Agent ${packageJson.version}: matching prebuilt binary not available yet for ${platform}.`);
+  console.log("");
   console.log("╔══════════════════════════════════════════════════════════════╗");
   console.log("║  BB-Agent: no prebuilt binary for " + platform.padEnd(19) + "       ║");
   console.log("║                                                              ║");