Claw-Empire provides a local-first AI agent office simulator, enabling users to orchestrate a diverse array of CLI, OAuth, and API-connected AI agents as a virtual company. It targets developers and power users seeking a unified, private, and visually intuitive platform to manage AI collaboration, offering a unique "CEO desk" perspective for overseeing autonomous agent operations. The primary benefit is centralized control and transparent visualization of complex AI workflows without relying on external cloud services.

How It Works

Claw-Empire transforms AI coding assistants into virtual employees within a simulated company, visualized through a pixel-art office interface. Agents collaborate across departments, attend meetings, and deliver tasks, all managed locally via an SQLite database. The system supports agents connected through CLI tools, OAuth providers (like GitHub/Google), and direct API keys to external LLMs. Core to its design is agent isolation within git worktrees for safe parallel development and a local-first architecture ensuring data privacy.

Quick Start & Requirements

• Primary Install: Clone the repository and run the platform-specific install script:
  • macOS/Linux: git clone https://github.com/GreenSheep01201/claw-empire.git && cd claw-empire && bash install.sh
  • Windows (PowerShell): git clone https://github.com/GreenSheep01201/claw-empire.git; cd claw-empire; powershell -ExecutionPolicy Bypass -File .\install.ps1
• Run Command: pnpm dev:local
• Prerequisites: Node.js (>= 22), pnpm (latest), Git.
• Docs: AI Install Guide, Release Notes, API Docs.

Highlighted Details

• Local-first AI agent orchestration with a pixel-art office simulator.
• Supports a wide range of AI providers via CLI, OAuth, and direct API keys.
• Multiple workflow "pack profiles" tailor agent collaboration for different tasks (e.g., development, reporting, creative writing).
• Integrated messenger support (Telegram, Discord, Slack, etc.) for CEO directives.
• Secure, local storage of OAuth and messenger tokens using AES-256-GCM encryption.
• Agents operate in isolated git worktrees, merging only upon CEO approval.

Maintenance & Community

The project shows signs of active development with recent release notes (v2.0.1). Contributions are welcomed via pull requests to the dev branch, following guidelines in CONTRIBUTING.md. Specific community channels like Discord or Slack are not explicitly mentioned in the README.

Licensing & Compatibility

The project is licensed under the Apache 2.0 license, permitting free personal and commercial use.

Limitations & Caveats

While designed for robustness, the auto-update feature details troubleshooting steps for potential git_pull_failed errors or diverged local branches, indicating that manual intervention may sometimes be required to maintain the repository. The AUTO_UPDATE_RESTART_COMMAND has strict security limitations, disallowing shell metacharacters and direct shell launchers.