meowbot 🐱🤖

A simple and elegant terminal interface for connecting to your AI agent.

Installation

Global Installation (Recommended)

npm install -g meowbot

This will automatically download the appropriate pre-compiled binary for your platform.

From Source

git clone https://github.com/meow-community/meowbot.git
cd meowbot
bun install
bun run build:binary

Usage

Interactive Mode

meowbot

This starts an interactive terminal session where you can chat with your agent.

Single Message

meowbot -m "What's the weather like?"

With Custom Agent URL

meowbot --url https://your-agent-api.com/chat

With API Key

meowbot --key YOUR_API_KEY

Configuration

You can set environment variables to configure default settings:

export MEOW_AGENT_URL=https://your-agent-api.com/chat
export MEOW_API_KEY=your-api-key
export MEOW_TIMEOUT=30000

Commands

In interactive mode, you can use these commands:

• help - Show available commands
• clear - Clear the screen
• exit or quit - Exit the application

Building from Source

Build for Current Platform

bun run build:binary

Build for All Platforms

bun run scripts/build-binary.js --all

This will create binaries for:

• Linux (x64, ARM64)
• macOS (Intel, Apple Silicon)
• Windows (x64)

Development

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build TypeScript
bun run build

# Build binary
bun run build:binary

Architecture

Meowbot uses a 3-tier architecture:

1. Terminal CLI → 2. Local Agent Orchestrator → 3. Cerebras LLM API

See ARCHITECTURE.md for detailed setup and configuration.

Quick Start with Local Agent

1. Install meowbot globally:

npm install -g meowbot

2. Start the local agent orchestrator:

cd examples
npm install
export MEOW_LLM_API_URL=https://evosec.dev/v1/chat/completions
export MEOW_LLM_API_KEY=your-api-key
npm start

3. Connect meowbot to your local agent:

meowbot

API Endpoints

The local agent orchestrator provides:

• GET /api/agent/health - Health check
• POST /api/agent/chat - Chat with agent
• POST /api/agent/stream - Streaming responses
• POST /api/agent/clear - Clear session

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and feature requests, please visit GitHub Issues.