{"id":28316163,"url":"https://github.com/pinkpixel-dev/bibble","last_synced_at":"2026-03-12T07:02:26.413Z","repository":{"id":296783207,"uuid":"988040586","full_name":"pinkpixel-dev/bibble","owner":"pinkpixel-dev","description":"A powerful command-line chatbot built in TypeScript that brings AI conversations directly to your terminal. Features multi-provider LLM support (OpenAI, Anthropic, Google), real-time streaming responses, persistent chat history, and comprehensive MCP (Model Context Protocol) client functionality for seamless tool integration.","archived":false,"fork":false,"pushed_at":"2025-09-17T04:12:30.000Z","size":5374,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-17T04:24:35.324Z","etag":null,"topics":["anthropic","chatbot","claude","cli","gpt","llm","mcp","mcp-client","model-context-protocol","model-context-protocol-client","openai","terminal","typescript"],"latest_commit_sha":null,"homepage":"https://pinkpixel.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pinkpixel-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP_2025.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-22T01:05:00.000Z","updated_at":"2025-09-17T04:11:23.000Z","dependencies_parsed_at":"2025-09-06T05:25:16.373Z","dependency_job_id":"5f48e23c-37b2-446e-a0e9-5fd7d073b6c0","html_url":"https://github.com/pinkpixel-dev/bibble","commit_stats":null,"previous_names":["pinkpixel-dev/bibble"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/pinkpixel-dev/bibble","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fbibble","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fbibble/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fbibble/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fbibble/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pinkpixel-dev","download_url":"https://codeload.github.com/pinkpixel-dev/bibble/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fbibble/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30417686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T06:40:58.731Z","status":"ssl_error","status_checked_at":"2026-03-12T06:40:40.296Z","response_time":114,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","chatbot","claude","cli","gpt","llm","mcp","mcp-client","model-context-protocol","model-context-protocol-client","openai","terminal","typescript"],"created_at":"2025-05-25T01:13:55.859Z","updated_at":"2026-03-12T07:02:26.407Z","avatar_url":"https://github.com/pinkpixel-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://res.cloudinary.com/di7ctlowx/image/upload/v1747791202/bibble-logo_ykiwbq.png\" alt=\"Bibble Logo\" width=\"350\"/\u003e\n\u003c/p\u003e\n\n# Bibble - AI-Powered Tool-Calling Agent \u0026 Terminal Assistant\n\n\u003e **🏆 GitHub \"For the Love of Code\" Hackathon Entry**\n\n[![npm version](https://img.shields.io/npm/v/@pinkpixel/bibble.svg)](https://www.npmjs.com/package/@pinkpixel/bibble)\n[![License: Apache 2.0](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/license/apache-2-0)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io/)\n[![OpenAI](https://img.shields.io/badge/OpenAI-GPT-green.svg)](https://openai.com/)\n[![Anthropic](https://img.shields.io/badge/Anthropic-Claude-orange.svg)](https://www.anthropic.com/)\n[![Google](https://img.shields.io/badge/Google-Gemini-blue.svg)](https://ai.google.dev/)\n[![CLI Tool](https://img.shields.io/badge/CLI-Tool-yellow.svg)](https://github.com/pinkpixel-dev/bibble)\n[![Streaming](https://img.shields.io/badge/Real--time-Streaming-red.svg)](https://github.com/pinkpixel-dev/bibble)\n[![Made with ❤️](https://img.shields.io/badge/Made%20with-❤️-pink.svg)](https://pinkpixel.dev)\n\nBibble is far more than a simple chatbot - it's a sophisticated AI-powered tool-calling agent that transforms your terminal into an intelligent workspace. Built in TypeScript, Bibble can execute multi-step workflows, call tools autonomously until tasks are complete, and seamlessly integrate with your development environment through intelligent workspace detection.\n\nWith support for OpenAI, Anthropic, Google Gemini, and OpenAI-compatible API endpoints, Bibble combines real-time response streaming, persistent chat memory, and extensive tool integration to create a truly powerful terminal assistant.\n\n## 🚀 Core Capabilities\n\n### 🤖 Intelligent Tool-Calling Agent\n- **Multi-Step Workflow Execution** - Bibble autonomously chains tool calls until complex tasks are completed\n- **Intelligent Task Planning** - Breaks down requests into actionable steps and executes them systematically\n- **Contextual Decision Making** - Uses conversation history and workspace context to make smart tool choices\n- **Persistent Task Memory** - Maintains context across tool calls for coherent multi-step operations\n\n### 🛠️ Comprehensive Built-In Tool Suite\n\n#### 📁 **File System \u0026 Development Tools**\n- **File Operations** - Read, write, create, delete, and manage files and directories\n- **Code Analysis** - Examine codebases, analyze structure, and understand project layouts\n- **Workspace Intelligence** - Automatic detection of project types, languages, and configurations\n- **Git Integration** - Repository analysis and commit message enhancement\n\n#### 🌐 **Web Search \u0026 Research Tools**\n- **Multi-Engine Web Search** - DuckDuckGo, Bing, Google, and Brave integration with intelligent fallbacks\n- **AI-Powered Query Enhancement** - Smart query optimization for better search results\n- **Advanced Research Assistant** - Orchestrated workflows combining search and content extraction\n- **Content Extraction** - Intelligent web scraping with rate limiting and parsing\n\n#### 🌤️ **Information \u0026 Data Tools**\n- **Weather \u0026 Climate Data** - Real-time weather information by location\n- **Date \u0026 Time Services** - Timezone-aware datetime operations and scheduling\n- **Hacker News Integration** - Fetch and analyze trending tech stories\n- **News \u0026 Current Events** - Stay updated with latest developments\n\n#### 💻 **System \u0026 Command Line Tools**\n- **Process Management** - Execute system commands and manage processes\n- **Environment Analysis** - System diagnostics and environment detection\n- **Terminal Operations** - Advanced terminal interactions and automation\n\n#### 🎭 **Fun \u0026 Personality Features**\n- **🐱 Cat Image Generator** - Fetch random cat images with terminal display using custom @pinkpixel/pixelpop package\n- **🎪 Roast Generator** - Ask Bibble to playfully roast you for entertainment\n- **📝 Git Poetry** - Transform boring commit messages into beautiful poetry\n- **🎨 ASCII Art \u0026 Animations** - Beautiful terminal graphics and animations\n\n### 🔌 **MCP Server Integration**\n- **Universal Tool Extension** - Connect to any MCP-compatible server to add custom tools\n- **User-Configurable** - Easy setup and management of external tool integrations\n- **Seamless Integration** - External tools work alongside built-in capabilities\n- **Community Ecosystem** - Leverage the growing MCP tool ecosystem\n\n### 🎨 **Premium Terminal Experience**\n- **Pink Pixel Theme** - Gorgeous branded interface with gradient effects\n- **Interactive Tool Displays** - Status badges, syntax highlighting, and progress indicators\n- **Image \u0026 GIF Rendering** - Display images and animated GIFs directly in terminal using custom @pinkpixel/pixelpop package\n- **Smart Tables \u0026 Lists** - Beautiful data presentation with color coding\n- **Real-time Streaming** - Live response streaming with visual feedback\n\n### ⚙️ **Advanced Configuration**\n- **Multi-Provider Support** - OpenAI, Anthropic, Google Gemini, and OpenAI-compatible endpoints\n- **Flexible Model Selection** - Switch between models and providers seamlessly\n- **Persistent Memory** - Chat history storage and retrieval\n- **Custom System Prompts** - Personalize AI behavior and guidelines\n\n## 🎬 Demo\n\nSee Bibble's tool-calling agent capabilities in action:\n\n  [**BIBBLE DEMO**](https://youtu.be/06RB3ytBRms?si=yFx_RlwvEDEKzEzI)\n\n### 🐱 Cat Images with Terminal Display\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./demos/cat-image.gif\" alt=\"Cat Images Tool Demo\" width=\"500\"/\u003e\n\u003c/p\u003e\n\n*Powered by @pinkpixel/pixelpop - a custom terminal image rendering package built with Bibble in mind*\n\n## Installation\n\n### Prerequisites\n\n- Node.js v20 or higher\n- npm v7 or higher\n\n### Install from npm\n\n```bash\n# Install the official package\nnpm install -g @pinkpixel/bibble\n```\n\n### Install from source\n\n1. Clone the repository\n2. Install dependencies\n   ```bash\n   npm install\n   ```\n3. Build the project\n   ```bash\n   npm run build\n   ```\n4. Install globally\n   ```bash\n   npm install -g .\n   ```\n\n## Usage\n\nAfter installation, you can run Bibble using the command `bibble`. If you installed the package with the `@pinkpixel` scope, you can also use `npx @pinkpixel/bibble`.\n\n### Start a chat\n\n```bash\nbibble\n```\n\nor\n\n```bash\nbibble chat\n```\n\nWith npx:\n\n```bash\nnpx @pinkpixel/bibble\n```\n\n### Configure settings\n\n```bash\nbibble config\n```\n\n### Manage chat history\n\n```bash\nbibble history\n```\n\n## Commands\n\n### Chat commands\n\n- `bibble chat` - Start a chat session\n- `bibble chat --model gpt-4` - Start a chat with a specific model\n- `bibble chat --continue` - Continue the most recent chat\n- `bibble chat --history \u003cid\u003e` - Load a specific chat history\n\n### Config commands\n\n- `bibble config list` - List all configuration settings\n- `bibble config set \u003ckey\u003e \u003cvalue\u003e` - Set a configuration value\n- `bibble config get \u003ckey\u003e` - Get a configuration value\n- `bibble config reset` - Reset configuration to defaults\n- `bibble config api-key` - Set up API key for a provider\n- `bibble config mcp-servers` - Manage MCP server configurations\n- `bibble config web-search` - Configure preferred search engine and API keys\n- `bibble config timezone` - Configure default timezone for datetime tools\n- `bibble config user-guidelines` - Configure user guidelines\n\n### History commands\n\n- `bibble history list` - List chat history\n- `bibble history show \u003cid\u003e` - Show a specific chat history\n- `bibble history delete \u003cid\u003e` - Delete a chat history\n- `bibble history clear` - Clear all chat history\n- `bibble history export \u003cid\u003e \u003cfilename\u003e` - Export chat history to a JSON file\n- `bibble history import \u003cfilename\u003e` - Import chat history from a JSON file\n\n### System commands\n\n- `bibble setup` - Run the setup wizard\n- `bibble system-prompt` - View the system prompt with tools list\n- `bibble diagnose` - Diagnose environment and terminal compatibility\n- `bibble diagnose --verbose` - Show detailed diagnostic information\n\n## In-chat commands\n\nThe following commands are available during a chat session:\n\n- `/help` - Display help information\n- `/exit` or `/quit` - Exit the chat\n- `/clear` - Clear the screen\n- `/save` - Save the current chat to history\n- `/reset` - Reset the current conversation\n- `/multiline` or `/paste` - Enter multi-line input mode for pasting documentation, code, etc.\n- ``` - Start code block mode (type ``` and continue with your code)\n\n## Enhanced Tool Display System\n\nBibble v1.4.0 introduces a completely overhauled tool display system featuring:\n\n- **Dynamic Status Badges**: Visual indicators showing tool execution status (running, completed, error)\n- **Boxed Parameter/Output Sections**: Clearly delineated tool input/output for better readability\n- **Syntax Highlighted JSON**: Beautiful formatting for JSON parameters and results\n- **Clickable URLs**: Terminal hyperlinks for any URLs found in tool outputs\n- **Clipboard Support**: Copy tool results directly to clipboard with interactive buttons\n- **Keyboard Shortcuts**: Intuitive keyboard navigation for tool output exploration\n\nThese enhancements make working with MCP tools more intuitive and visually appealing. The new display system can be toggled using environment variables if compatibility issues arise.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./demos/weather-datetime.gif\" alt=\"Weather and DateTime Tools Demo\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n## 🌐 Built-In Tool Ecosystem\n\n**Bibble is a complete tool-calling agent** with an extensive suite of built-in capabilities that work together to handle complex, multi-step tasks autonomously.\n\n### 🔍 Web Search Features\n\n- **Multi-Engine Support**: Integrated DuckDuckGo (primary), Bing, Google, and Brave search with intelligent fallbacks\n- **AI-Powered Query Enhancement**: Smart query optimization for better search results\n- **Advanced Content Extraction**: Intelligent web scraping with rate limiting and content parsing\n- **Research Session Management**: Event-driven research workflows with progress tracking\n- **Cross-Platform Compatible**: Optimized for Windows environments with proper path handling\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./demos/web-search.gif\" alt=\"Web Search Demo\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n### 🛠️ Complete Built-In Tool Catalog\n\n#### 🌐 **Web \u0026 Research Tools**\n- **`web_search`** - Multi-engine search with intelligent fallbacks (DuckDuckGo, Bing, Google, Brave)\n- **`quick_web_search`** - Fast information retrieval for immediate answers\n- **`research_status`** - Monitor and manage ongoing research operations\n- **`web_scrape`** - Extract content from web pages with smart parsing\n\n#### 📁 **File System Tools**\n- **`read_file`** - Read and analyze file contents\n- **`write_file`** - Create and modify files\n- **`list_directory`** - Explore directory structures\n- **`create_directory`** - Create new directories\n- **`delete_file`** - Remove files safely\n- **`file_search`** - Search for files by name or pattern\n\n#### 💻 **System \u0026 Command Tools**\n- **`execute_command`** - Run system commands and scripts\n- **`get_environment`** - Analyze system environment\n- **`process_management`** - Manage running processes\n- **`system_info`** - Get detailed system information\n\n#### 🌤️ **Information Services**\n- **`get_weather`** - Real-time weather data by location\n- **`get_datetime`** - Timezone-aware date and time operations\n- **`hacker_news`** - Fetch trending tech stories\n- **`news_search`** - Search current news and events\n\n#### 🎭 **Fun \u0026 Personality Tools**\n- **`cat_images`** - Fetch random cat images with terminal display\n- **`roast_user`** - Generate playful roasts for entertainment\n- **`git_poetry`** - Transform commit messages into poetry\n- **`ascii_art`** - Generate ASCII art and banners\n\nThe prior comprehensive research tool family has been retired; Bibble now routes every deep-dive request through these core tools, letting the enhanced research agent sequence searches, follow-ups, and content extraction as a single workflow.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./demos/research.gif\" alt=\"Research Assistant Demo\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n### Configure Web Search Engines\n\nConfigure your preferred search engine and API keys:\n\n```bash\nbibble config web-search\n```\n\nThis wizard allows you to:\n- **Choose preferred engine**: DuckDuckGo (no API key), Bing, Google Custom Search, or Brave\n- **Set API keys**: Configure keys for Bing, Google, or Brave search APIs\n- **Automatic fallbacks**: If your preferred engine fails, Bibble automatically tries other available engines\n\n### How to Use Web Search\n\nOnce you start Bibble, the web search tools are automatically available. Simply ask questions that require web search, and Bibble will intelligently use the appropriate search tools:\n\n```\n\u003e What are the latest developments in AI?\n🔍 Bibble will automatically search the web using the built-in tools...\n```\n\nOr explicitly request web search:\n```\n\u003e Can you search for information about TypeScript 5.0 features?\n🌐 Bibble will use the `web_search` tool to find current information...\n```\n\n### 🖼️ Terminal Image Rendering with @pinkpixel/pixelpop\n\nBibble features advanced terminal image and GIF rendering capabilities powered by **@pinkpixel/pixelpop**, a custom package built specifically for this project:\n\n- **Direct Terminal Display** - Images and animated GIFs render directly in your terminal\n- **Cross-Platform Support** - Works across different terminal emulators\n- **Optimized Performance** - Efficient rendering with minimal resource usage\n- **Custom Built** - Designed from the ground up for Bibble's needs\n- **Open Source** - Available on npm and GitHub for the community\n\n*@pinkpixel/pixelpop is also available as a standalone package for other developers to use in their terminal applications.*\n\n### Environment Variables\n\n- `BIBBLE_DISABLE_ENHANCED_TOOLS`: Set to `true` to disable enhanced tool displays\n- `BIBBLE_TOOL_DISPLAY_MODE`: Set to `basic`, `compact`, or `full` (default)\n- `BIBBLE_ENABLE_IMAGES`: Set to `false` to disable terminal image rendering\n\n## Configuration\n\nBibble stores its configuration in a `.bibble` directory in your home directory. The configuration includes:\n\n- API keys\n- Default model settings\n- UI preferences\n- MCP server configurations\n- User guidelines (additional instructions for the AI)\n\n### 🎛️ Model Configuration Wizard\n\nBibble v1.6.1 introduces a user-friendly configuration wizard to easily set up your AI provider and model settings:\n\n```bash\nbibble config configure\n```\n\nThe wizard guides you through:\n- **Provider Selection**: Choose from OpenAI, Anthropic, Google, or OpenAI Compatible\n- **Model Selection**: Pick from predefined models or enter custom model IDs\n- **Parameter Configuration**: Set temperature, max tokens, reasoning effort, and more\n  - **OpenAI Compatible**: Define custom parameters (name and value pairs) to ensure compatibility with your specific endpoint\n- **Automatic Saving**: All settings are saved automatically with confirmation\n\n### Other Configuration Commands\n\n```bash\n# Set up API keys\nbibble config api-key\n\n# Set default provider\nbibble config default-provider\n\n# View all settings\nbibble config list\n\n# Set specific values\nbibble config set \u003ckey\u003e \u003cvalue\u003e\n\n# Reset to defaults\nbibble config reset\n```\n\n## MCP Integration\n\nBibble functions as an MCP client, allowing it to connect to MCP-compatible servers and use their tools. MCP (Model Context Protocol) is a protocol for connecting language models to external tools and services.\n\nTo configure MCP servers, use:\n\n```bash\nbibble config mcp-servers\n```\n\n## Troubleshooting\n\n### Environment Diagnostics\n\nBibble includes built-in diagnostic tools to help troubleshoot common issues:\n\n```bash\n# Basic diagnostic information\nbibble diagnose\n\n# Detailed system analysis\nbibble diagnose --verbose\n```\n\nThe diagnostic command will check:\n- Platform and terminal information\n- Node.js, npm, and npx executable paths and versions\n- Environment variables and PATH configuration\n- MCP server connectivity issues\n\n### Common Issues\n\n#### MCP Server Connection Failures\n\n**Problem**: You see \"Connection closed\" errors when starting Bibble, especially in terminals other than Warp.\n\n**Solution**:\n1. Run `bibble diagnose` to check your environment\n2. Ensure Node.js and npm are properly installed and accessible\n3. Check that your PATH includes Node.js and npm directories\n4. Try running from a different terminal (Command Prompt, PowerShell, or Git Bash on Windows)\n\n**Symptoms**:\n```\nFailed to connect to MCP server \"server-name\": Connection closed\n```\n\n**Advanced Troubleshooting**:\n- Run `bibble diagnose --verbose` for detailed information\n- Try running `node --version` and `npx --version` in your terminal\n- If using Windows, try running your terminal as Administrator\n- Check if antivirus software is blocking Node.js processes\n\n#### Terminal Compatibility\n\n**Problem**: Bibble works in one terminal but not others.\n\n**Solution**: Bibble v1.3.9+ includes multi-tier fallback systems for cross-terminal compatibility:\n- **Primary Strategy**: Uses resolved executable paths\n- **Fallback Strategies**: Direct commands, corepack, and bundled npm approaches\n- **Graceful Degradation**: Continues working even if some servers fail\n\n**Supported Terminals**:\n- ✅ Warp Terminal\n- ✅ Windows Terminal\n- ✅ Hyper\n- ✅ Command Prompt\n- ✅ PowerShell\n- ✅ Git Bash\n- ✅ Most Unix terminals\n\n#### System Prompt Visibility\n\n**Problem**: Tools not appearing in the system prompt or model not recognizing available tools.\n\n**Solution**:\n1. Ensure you're using Bibble v1.4.0+ which fixes the tool visibility issue\n2. Check that all MCP servers are properly connected with `bibble diagnose`\n3. View the full system prompt with `bibble system-prompt` to confirm tools are listed\n4. If tools are missing, try restarting Bibble or reconnecting to MCP servers\n\n#### Node.js Installation Issues\n\n**Problem**: Bibble can't find Node.js, npm, or npx.\n\n**Solutions**:\n1. **Install Node.js**: Download from [nodejs.org](https://nodejs.org/)\n2. **Check Installation**:\n   ```bash\n   node --version\n   npm --version\n   npx --version\n   ```\n3. **Path Issues**: Add Node.js to your PATH environment variable\n4. **NVM Users**: Make sure your Node.js version is activated\n5. **Windows Users**: Try reinstalling Node.js with \"Add to PATH\" option checked\n\n#### API Key Issues\n\n**Problem**: API key errors or authentication failures.\n\n**Solutions**:\n1. Run the setup wizard: `bibble setup`\n2. Manually set API keys: `bibble config api-key`\n3. Check your API key is valid and has sufficient credits\n4. Verify the correct API endpoint is configured\n\n#### Performance Issues\n\n**Problem**: Slow startup or response times.\n\n**Solutions**:\n1. Check your internet connection\n2. Try a different model or provider\n3. Reduce the number of enabled MCP servers\n4. Clear chat history if it's very large: `bibble history clear`\n\n### Getting Help\n\nIf you're still experiencing issues:\n\n1. **Run Diagnostics**: `bibble diagnose --verbose`\n2. **Check Logs**: Look for error messages in the terminal output\n3. **Update Bibble**: `npm install -g @pinkpixel/bibble@latest`\n4. **Check GitHub Issues**: Visit the [GitHub repository](https://github.com/pinkpixel-dev/bibble/issues)\n5. **Report Bugs**: Create a new issue with:\n   - Your operating system and terminal\n   - Output from `bibble diagnose --verbose`\n   - Steps to reproduce the issue\n   - Error messages or unexpected behavior\n\n### Version Compatibility\n0\n- **Node.js \u003e=20**: Required for all Bibble versions\n\n### Build the project\n\n```bash\nnpm run build\n```\n\n### Development mode with watch\n\n```bash\nnpm run dev\n```\n\n### Publishing to npm\n\nThe package is published to npm under the `@pinkpixel` scope:\n\n```bash\n# Login to npm\nnpm login\n\n# Build the project\nnpm run build\n\n# Publish the package\nnpm publish --access public\n```\n\nTo install the latest version:\n\n```bash\nnpm install -g @pinkpixel/bibble@latest\n```\n\n## License\n\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinkpixel-dev%2Fbibble","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinkpixel-dev%2Fbibble","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinkpixel-dev%2Fbibble/lists"}