AI Agents in Your Terminal

A powerful CLI tool with multi-brain architecture for intelligent AI conversations and research.

npm install -g wonderland-cli

Then run `wonderland -setup4u` for a quicker setup

What is Wonderland CLI?

Wonderland CLI is a sophisticated command-line interface that brings AI agents to your terminal. It features a unique multi-brain architecture where a Main Agent acts as a controller while a specialized Brain Agent handles research and complex queries. The system intelligently decides when to use simple responses versus deep research, making it perfect for developers and researchers.

Key Features

Multi-brain architecture with Main Agent and Brain Agent collaboration
Real-time streaming responses with typing animations
Intelligent decision making for simple vs complex queries
Web search capabilities for up-to-date information
Comprehensive chat history and session logging
Plugin system for custom tools and extensions
Multiple AI model support through Ollama
Interactive chat mode and API server mode
Session export to markdown, JSON, or PDF

Features in Depth:

Dynamic agent assignment: Add, edit, or retire brain agents on demand
Specialties: Assign brains to coding, research, math, or custom tasks
Live dashboard: Visualize agent status and activity in real time
Interrupt & reassign: Instantly move tasks between agents
Advanced analytics: Track usage, performance, and agent stats
Personality system: Switch between friendly, strict, creative, or custom agent personalities
Prompt templates: Save and reuse your favorite prompts
Dangerous reset: Factory reset all settings, logs, and plugins

Quick Start

Ask a question

wonderland ask "What is machine learning?"

Start interactive chat

wonderland chat

Run as API server

wonderland serve --port 8080

View analytics

wonderland analytics

Command Reference:

wonderland setup — Interactive setup for agents and models
wonderland dashboard — Live status of all agents
wonderland replay -l — Replay the latest session
wonderland export --format pdf — Export session as PDF
wonderland plugin list — List all installed plugins
wonderland persona set creative — Switch agent personality
wonderland -danger -settings -reset — Factory reset (dangerous!)

How It Works

When you ask a question, the Main Agent evaluates its complexity. Simple questions get direct answers, while complex queries trigger the Brain Agent to perform research using web search and other tools. The agents communicate through a sophisticated tool system, ensuring you always get the most relevant and accurate information.

Requirements

Wonderland CLI requires Node.js and works with Ollama for local AI models. It supports various personalities (friendly, strict, creative, or custom) and can be extended with plugins for additional functionality.

Community & Docs

Get Help & Contribute:

GitHub Repository — Star, fork, or open issues
Full Manual (HOWTOUSE.md) — In-depth guide and tutorials
Command Reference (COMMAND.md) — All commands and usage
Legal Documents — Terms, privacy, and more
NPM Package — Install and update

Join the Wonderland community and help shape the future of AI agents in your terminal!