bibble

Bibble is an AI-powered tool-calling agent and terminal assistant that can autonomously manage multi-step workflows, call built-in and external tools, and provide a rich, real-time interactive terminal experience. It supports multiple providers (OpenAI, Anthropic, Google Gemini) and offers a built-in tool suite for file operations, code analysis, web search, time and weather data, terminal automation, and even fun features like ASCII art. When connected as an MCP server, Bibble can extend its capabilities by invoking external MCP-compatible tools, enabling you to augment your workspace with custom plugins and workflows. To use Bibble, install it, start the Bibble CLI, and begin a chat session or run a configuration command to wire up MCP tools. Bibble can stream responses in real time, maintain persistent memory across tool calls, and adapt tool usage based on workspace detection and conversation history, making it a powerful assistant for development tasks, debugging, code analysis, and research workflows.

Once running, you can initiate a chat session (bibble or bibble chat), configure providers and memory, manage MCP server integrations, and use Bibble’s built-in commands to tailor its behavior. The MCP integration point lets Bibble connect to external MCP servers to discover and use their tools within Bibble’s workflow orchestration, enabling seamless cross-tool automation in your terminal environment.

Prerequisites:

• Node.js v20 or higher
• npm v7 or higher

Install from npm:

# Install the official package globally
npm install -g @pinkpixel/bibble

Install from source:

1. Clone the repository
2. Install dependencies

npm install

3. Build the project (if applicable)

npm run build

4. Install globally from the source directory

npm install -g .

Run Bibble after installation:

bibble

If you installed with npm, you can also run via npx:

npx @pinkpixel/bibble

Tips and notes:

• Ensure Node.js v20+ and npm v7+ are installed before proceeding.
• The MCP integration lets Bibble load and use external toolsets; configure your MCP servers via bibble config (e.g., bibble config mcp-servers) to enable tool discovery.
• If you encounter issues with tool discovery, verify network access and MCP server availability. Check environment variables for API keys and provider settings as needed (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY).
• Bibble supports real-time streaming; enable or observe progress indicators and status badges in the terminal to monitor long-running workflows.
• When using npx or global installs, ensure the correct PATH is set so the bibble command is accessible from your shell.
• For advanced usage, explore Bibble’s config commands (bibble config) to customize providers, memory, web search, time zones, and user guidelines.