@shuyhere/bb-agent 0.0.8 → 0.0.9

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.9] - 2026-04-07
+
+### Added
+
+- `@folder/` expansion now sends a directory tree summary to the model instead of treating folders like text files
+- large `@file` expansions now send a structural outline first for long files instead of dumping the entire file immediately
+- non-UTF-8 and binary `@file` references now send metadata instead of a misleading UTF-8 read error
+
+### Fixed
+
+- fullscreen paste in iTerm2/SSH no longer corrupts the input area after paste
+- pasted file and image paths are normalized more reliably, including quoted paths and `file://` URLs
+- fullscreen prompt submission now expands `@file` references consistently
+- running tool timers continue updating after `TurnEnd` while tools are still executing
+- sub-second tool durations now display as `ms` instead of `0.0s`
+- startup Skills/Prompts/Extensions note now only appears at startup or explicit `/reload`
+- remote SSH clipboard copy no longer leaks Wayland/XDG clipboard helper warnings into the TUI
+
+### Changed
+
+- fullscreen `Ctrl+V` now falls back to clipboard text when no clipboard image is available
+- `@` autocomplete now inserts quoted file references when paths contain spaces
+
 ## [0.0.8] - 2026-04-06
 
 ### Fixed
@@ -23,4 +46,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - latest published package includes the post-0.0.7 startup, auth, model-default, and update-notice improvements
 
+[0.0.9]: https://github.com/shuyhere/bb-agent/releases/tag/v0.0.9
 [0.0.8]: https://github.com/shuyhere/bb-agent/releases/tag/v0.0.8

package/README.md

@@ -1,9 +1,44 @@
 # BB-Agent
 
+![BB-Agent title figure](assets/title-figure.png)
+
+BB means Bridge Baby in Death Stranding. I named this project that way because while building it, I was also enjoying Death Stranding and loved the idea of connecting everyone together.
+
 A Rust-native AI coding agent for the terminal — featuring a fullscreen TUI, multi-provider support, tool use, session persistence, branching, extensions, and skills.
 
 ## Install
 
+### Terminal & Font Compatibility
+
+BB-Agent uses Unicode glyphs and ANSI color in the fullscreen TUI. For the best visual experience, use a modern terminal and a Unicode-capable monospace font such as:
+
+- JetBrains Mono
+- SF Mono / Menlo
+- Fira Code
+- Cascadia Mono
+- Nerd Font variants of the above
+
+If some symbols look broken, missing, or too narrow in your terminal:
+
+1. switch to a Unicode-capable monospace font
+2. make sure your terminal uses UTF-8
+3. enable BB-Agent compatibility mode
+
+Compatibility mode uses safer ASCII-style fallback glyphs for spinner/status/tool markers:
+
+```bash
+BB_TUI_COMPAT=1 bb
+```
+
+Or set this in `~/.bb-agent/settings.json`:
+
+```json
+{
+  "compatibility_mode": true
+}
+```
+
+
 ### From source (all platforms — macOS, Linux, Windows)
 
 Requires [Rust](https://rustup.rs). Install Rust first if you don't have it:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuyhere/bb-agent",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "BB-Agent — a Rust-native AI coding agent for the terminal",
   "license": "MIT",
   "repository": {