Colony

Deploy autonomous LLM agents that work continuously, react to events, and check in with you before taking irreversible actions.

Get started

GitHub

🐜

Ant-based agents

Each ant is a fully autonomous agent session — Claude or Gemini — configured with a plain YAML file and a plain-English instruction set.

🔒

Human-in-the-loop confirmations

Dangerous actions pause and post a Discord confirmation request. React ✅ to proceed or ❌ to skip. Timeout defaults to deny.

⚡

Event-driven or scheduled

Wake ants on GitHub issues, Discord commands, or cron schedules. Ants with no triggers run continuously, sleeping between sessions.

🔄

Resilient supervisor

Each ant runs in its own supervisor loop. Crashes are classified — rate limits wait for reset, billing/auth errors pause and alert you, transient failures use exponential backoff. A crash in one ant never affects others.

🐳

Docker-first deployment

One container per colony. Mount your config directory as a volume, pass secrets via env file, and get 24/7 autonomous operation.

🔌

Multi-engine support

Run ants on Claude (Agent SDK) or Gemini (Google Gen AI SDK). Set engine per ant — mix and match in the same colony.