Summary

pikiclaw is an open-source AI agent orchestrator designed to unify diverse AI agents, models, and tools into a single, controllable interface. It targets creators and developers seeking to leverage advanced AI capabilities without being confined to specific IDEs or closed ecosystems. The primary benefit is enabling users to drive a swarm of AI agents in parallel from any terminal, streamlining complex workflows and enhancing productivity by abstracting away the underlying code and infrastructure.

How It Works

pikiclaw employs a layered architecture comprising Terminal, Agent, Model, and Tool layers. The orchestrator itself is self-bootstrapped, meaning pikiclaw is used to build pikiclaw. It supports running multiple agent sessions concurrently across various terminals, including popular IM clients (Telegram, Slack, Discord) and a Web Dashboard. Users can plug in any agent (e.g., Claude, Codex, Gemini), model (e.g., GPT, DeepSeek, OpenRouter), and tool (Skills, MCP, CLI), with configurations managed through a secure vault and environment injection. This approach offers unparalleled flexibility and a unified control plane for complex AI-driven tasks.

Quick Start & Requirements

• Primary Install: Run npx pikiclaw@latest to launch the Web Dashboard or npx pikiclaw@latest --setup for an interactive terminal setup wizard.
• Prerequisites: Node.js 20+ and at least one official Agent CLI (claude, codex, gemini, hermes) installed and authenticated.
• Docker: Supported via ghcr.io/xiaotonng/pikiclaw:latest multi-arch image; see docs/DOCKER.md for detailed configuration.

Highlighted Details

• Self-Bootstrapping: The project is developed and operated using itself, demonstrating a high degree of internal consistency and confidence in its architecture.
• N-Agent Concurrency: Enables running numerous agents across multiple workspaces and terminals simultaneously, managed from a single interface.
• Computer-Use Capabilities: Integrates agents with browser automation (via Playwright) and macOS desktop control (via Peekaboo), allowing AI to interact with GUIs and applications.
• Extensive Integrations: Supports seven native IM channels, a wide array of frontier and domestic AI models, and a rich ecosystem of MCP servers and community skills.

Maintenance & Community

The project roadmap indicates ongoing development, with planned enhancements for more ACP agents, broader terminal support (including mobile), deeper model wrapping, and richer tool ecosystems. Specific community links (Discord, Slack) or notable contributors are not detailed in the provided README.

Licensing & Compatibility

Licensed under MIT, pikiclaw is open for use, modification, and integration. Its flexible architecture is designed for extensibility, allowing users to plug in custom layers without explicit restrictions mentioned for commercial use or closed-source linking.

Limitations & Caveats

The "Computer-Use (macOS Desktop)" feature is macOS-specific and requires explicit user permissions for Accessibility and Screen Recording. Users must also ensure their chosen Agent CLIs are installed and properly authenticated. Setting up and managing multiple agents, models, and tools may involve a learning curve and configuration effort.