WarsClaw

Personal AI agent that interacts with Claude Code CLI through Discord/Slack — group-isolated conversations, scheduled tasks, Docker-containerized execution.

Node.js 22+ TypeScript Claude Code CLI Docker Discord / Slack

View on GitHub

Architecture

Discord/Slack  ──►  Polling Loop  ──►  Group Queue  ──►  Docker Container  ──►  Claude Code CLI
                                           ▲                                          │
                                     Task Scheduler                      IPC (filesystem JSON)
                                           ▲                                          │
                                         SQLite  ◄────────  Response Router  ◄────────┘

Group Isolation

Each conversation group gets its own queue, context, and CLAUDE.md instructions. Full isolation between teams.

Scheduled Tasks

Cron, interval, and one-shot task scheduling with SQLite persistence. Automate recurring agent workflows.

Docker Sandboxing

Every agent execution runs inside a Docker container with resource limits, network control, and clean teardown.

Multi-Channel

First-class support for Discord and Slack with a pluggable channel registry. Add new platforms easily.

IPC Protocol

File-based IPC with JSON messages. The agent writes responses to ipc/messages/ for reliable async communication.

Skills System

Extensible skill loader that discovers and registers agent capabilities from the skills/ directory.