Skip to content

v1.3.10 - Cross-Terminal Compatibility & Reliability Update 🚀

Choose a tag to compare

View all tags
@sizzlebop sizzlebop released this 28 Aug 21:02
· 46 commits to main since this release
v1.3.10
3a46c90

🚀 Major Reliability Update - Cross-Terminal Compatibility

This release resolves critical terminal compatibility issues and introduces robust fallback systems that ensure Bibble works consistently across all major terminals.

🎯 Key Fix: Universal Terminal Support

Problem Solved: Bibble previously only worked reliably in Warp terminal, failing with "Connection closed" errors in Windows Terminal, Hyper, and other terminals.

Solution: Multi-tier fallback system with comprehensive environment detection ensures MCP servers start successfully regardless of terminal environment.

✨ New Features

🔧 Environment Resolver System

  • Universal executable detection: Cross-platform Node.js, npm, and npx path resolution
  • Smart fallbacks: Automatic detection via which, where, and Get-Command
  • Comprehensive coverage: Supports Program Files, Homebrew, NVM, Volta, asdf, and more
  • Performance optimized: Cached resolution for fast startup

🛡️ Multi-Tier Fallback System

  • Primary Strategy: Resolved executable paths with environment enhancement
  • Direct Command Fallback: Original command execution without path resolution
  • Corepack Fallback: Node.js-based package execution for npm compatibility
  • Bundled npm Fallback: Direct Node.js execution for simplified npx functionality

🩺 Enhanced Diagnostic Command

  • bibble diagnose: Comprehensive environment troubleshooting
  • bibble diagnose --verbose: Detailed system analysis with PATH inspection
  • Platform detection: OS, shell, and terminal identification
  • Real-time testing: Live npx execution verification

🔄 Graceful Degradation

  • Non-blocking failures: Continue operation even if some MCP servers fail
  • Connection summaries: Clear reporting of successful vs failed connections
  • Fallback notifications: Informative messages when fallback strategies succeed

🛠️ Improvements

🔧 Environment Path Resolution

  • Windows compatibility: Fixed .cmd file execution issues
  • Enhanced PATH handling: Robust environment variable management
  • Actionable error messages: Clear troubleshooting suggestions with references to diagnostic tools

⚡ MCP Server Reliability

  • Multi-strategy connections: Prevent single-point failures
  • Better error handling: User-friendly messages with specific solutions
  • Diagnostic integration: Built-in troubleshooting guidance

🖥️ Terminal Compatibility Matrix

  • ✅ Warp Terminal - Fully supported
  • ✅ Windows Terminal - Now fully supported
  • ✅ Hyper - Now fully supported
  • ✅ Command Prompt - Now fully supported
  • ✅ PowerShell - Now fully supported
  • ✅ Git Bash - Now fully supported
  • ✅ Most Unix terminals - Fully supported

📚 Enhanced Documentation

  • Comprehensive troubleshooting guide in README.md
  • Environment diagnostics documentation
  • Common issues and solutions
  • Bug reporting guidelines
  • Version compatibility information

🔧 Technical Details

  • Architecture: New modular environment resolution system
  • Cross-Platform: Tested on Windows, macOS, and Linux
  • Performance: Cached executable resolution for optimal startup
  • Reliability: Multi-tier fallback ensures maximum connectivity

📈 Impact

  • Before: Terminal-specific compatibility issues, "Connection closed" errors
  • After: Universal compatibility across all major terminals and environments

🚀 Getting Started

# Install the latest version
npm install -g @pinkpixel/bibble@latest

# Run diagnostics if you experience issues
bibble diagnose --verbose

# Start chatting!
bibble

This update makes Bibble accessible to all users regardless of their terminal preference! 🎉

Full Changelog: CHANGELOG.md

Assets 2
Loading