@shuyhere/bb-agent 0.0.3 → 0.0.5

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# 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.5] - 2026-04-06
+
+### 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.5]: https://github.com/shuyhere/bb-agent/releases/tag/v0.0.5

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuyhere/bb-agent",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "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,7 +8,8 @@ const path = require("path");
 const os = require("os");
 const https = require("https");
 
-const VERSION = "0.0.3";
+const packageJson = require("../package.json");
+const BINARY_RELEASE_TAG = `v${packageJson.version}`;
 const REPO = "shuyhere/bb-agent";
 const NATIVE_DIR = path.join(__dirname, "..", "native");
 const DOWNLOAD_TIMEOUT_MS = 15_000;
@@ -56,13 +57,13 @@ function downloadBinary(url, dest, timeoutMs) {
 
 async function tryDownloadPrebuilt(target) {
   const assetName = `bb-${target}`;
-  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${assetName}`;
+  const url = `https://github.com/${REPO}/releases/download/${BINARY_RELEASE_TAG}/${assetName}`;
 
   fs.mkdirSync(NATIVE_DIR, { recursive: true });
   const dest = path.join(NATIVE_DIR, "bb");
 
   try {
-    console.log(`Downloading BB-Agent v${VERSION} for ${target}...`);
+    console.log(`Downloading BB-Agent ${BINARY_RELEASE_TAG} for ${target}...`);
     await downloadBinary(url, dest, DOWNLOAD_TIMEOUT_MS);
     fs.chmodSync(dest, 0o755);