Pocketrb

Pocketrb

[](https://badge.fury.io/rb/pocketrb) [](https://github.com/mensfeld/pocketrb/actions/workflows/ci.yml) [](LICENSE.txt)

A pocket-sized Ruby AI agent framework with multi-LLM support and advanced capabilities.

Features

• Clean async architecture: MessageBus, proper tool_use API, async processing
• Multi-LLM support: Claude (API + Max/OAuth + Proxy), OpenRouter, OpenAI-compatible APIs, RubyLLM, Claude CLI
• Multi-channel: CLI, Telegram, WhatsApp (via bridge)
• Advanced features: Planning system, context compaction, runtime skills system
• Simple memory: JSON-based memory with keyword matching (no external dependencies)
• Media support: Vision (images) via Claude, document handling
• Browser automation: Headless Chromium with session management and advanced interactions
• Scheduling: Cron jobs for automated tasks
• Personas: Separate memory and identity from workspace for portable agent personalities
• Autonomous mode: Skip permission prompts for sandboxed/container environments

Installation

gem install pocketrb

Or add to your Gemfile:

gem 'pocketrb'

Quick Start

# Set your API key
export ANTHROPIC_API_KEY=your-key

# Initialize a workspace
pocketrb init

# Start chatting
pocketrb chat

Usage

CLI Chat

pocketrb chat [options]

Options:

• -m, --model MODEL - Model to use (default: claude-sonnet-4-20250514)
• -p, --provider PROVIDER - LLM provider (anthropic, openrouter, ruby_llm)
• -w, --workspace DIR - Workspace directory for file access
• -M, --memory-dir DIR - Memory/persona directory (default: same as workspace)
• -s, --system-prompt TEXT - Custom system prompt

Telegram Bot

export TELEGRAM_BOT_TOKEN=your-bot-token
pocketrb telegram