AgEnD

Run a fleet of AI coding agents from your phone.

AgEnD (Agent Engineering Daemon) turns your Telegram or Discord into a command center for AI coding agents. One bot, multiple CLI backends, unlimited projects — each running as an independent session with crash recovery and zero babysitting.

You → Telegram/Discord → AgEnD → Fleet of AI Agents → Results back to your phone

繁體中文 · Documentation · CLI Reference

Why AgEnD?

Feature Highlights

🚀 Fleet Management — One bot, N projects. Each Telegram Forum Topic is an isolated agent session.

🔄 Multi-Backend — Claude Code, Gemini CLI, Codex, OpenCode, Kiro CLI, Antigravity CLI. Switch or mix freely.

🤝 Agent Collaboration — Agents discover, wake, and message each other via MCP tools. A General Topic routes tasks to the right agent using natural language.

📱 Mobile Control — Approve tool use, restart sessions, and manage your fleet from Telegram inline buttons.

🛡️ Autonomous & Safe — Cost guards, hang detection, model failover, and crash recovery keep your fleet running without babysitting.

⏰ Persistent Schedules — Cron-based tasks backed by SQLite. Survives restarts.

🎤 Voice Messages — Talk to your agents with Groq Whisper transcription.

📄 HTML Chat Export — Export any agent session as a self-contained HTML file for sharing or archiving.

🪞 Mirror Topic — Cross-instance visibility. Watch another agent's work in real time from a separate topic.

🖥️ Web Dashboard — Live fleet monitoring in the browser with SSE updates and integrated chat UI.

🔌 Extensible — Discord adapter, webhook notifications, health endpoint, external session support via IPC.

👥 Teams & Task Board — Named groups for targeted broadcasting. Shared task board for multi-step work tracking across instances.

📋 Fleet Templates — Define reusable fleet configurations. Deploy multi-instance setups with one command, each with its own git worktree.

Quick Start

One-liner (macOS / Linux — installs Node.js via nvm + tmux + agend, then runs quickstart):

curl -fsSL https://songsid.github.io/AgEnD/install.sh | bash

Or install manually:

# Option A: One-line install (Linux / macOS / WSL)
curl -fsSL https://songsid.github.io/AgEnD/install.sh | bash

# Option B: Manual install
npm install -g @songsid/agend    # 1. Install
agend quickstart                # 2. Setup — bot token, backend, done
agend fleet start               # 3. Launch your fleet 🎉

Open Telegram, send a message to your bot, and start coding from your phone.

Discord? agend quickstart supports Discord too — install the plugin first: npm install -g @songsid/agend-plugin-discord. See Discord setup guide.

How It Works

graph LR
  You["You<br/>(Phone / PC)"] <-->|messages| Channel["Telegram / Discord<br/>/ Web UI"]
  Channel <-->|routing| Daemon["AgEnD Daemon"]

  subgraph Fleet
    Daemon --> General["General<br/>Dispatcher"]
    Daemon --> A["Instance A<br/>Claude Code<br/>Project X"]
    Daemon --> B["Instance B<br/>Gemini CLI<br/>Project Y"]
    A <-.->|MCP Tools| B
    General -.->|routes tasks| A
    General -.->|routes tasks| B
  end

1. You send a message to your Telegram/Discord bot
2. Messages sent to the General Topic are interpreted and routed to the right agent. Messages to a specific topic go directly to that instance.
3. Agent instances run in isolated tmux sessions, each with its own project and CLI backend
4. Agents collaborate peer-to-peer via MCP tools — delegating tasks, sharing context, reporting results
5. Results flow back to your chat. Permission requests arrive as inline buttons.

Supported Backends

Requirements

• Node.js >= 20
• tmux
• One of the supported AI coding CLIs (installed and authenticated)
• Telegram bot token (@BotFather) or Discord bot token
• Groq API key (optional, for voice)

⚠️ All CLI backends run with --dangerously-skip-permissions (or equivalent). See Security.

WSL (Windows Subsystem for Linux): Fully supported. The install script auto-detects WSL and avoids using Windows node.exe from PATH. If you encounter PATH issues, add to /etc/wsl.conf:

[interop]
appendWindowsPath=false

Then restart WSL (wsl --shutdown). Install with: curl -fsSL https://songsid.github.io/AgEnD/install.sh | bash

Documentation

• Features — detailed feature documentation
• CLI Reference — all commands and options
• Configuration — fleet.yaml complete reference
• Security — trust model and hardening

Discord ClassicBot

ClassicBot lets users start AI agents in any Discord text channel using slash commands — no forum topics required.

Setup

# 1. Install Discord plugin
npm install -g @songsid/agend-plugin-discord

# 2. Run quickstart (select Discord)
agend quickstart

# 3. Start the fleet
agend fleet start

The quickstart will set up both fleet.yaml and classicBot.yaml. Run agend quickstart again to add users or guilds to existing config.

Usage

Server Whitelist

Control which Discord servers can use ClassicBot via ~/.agend/classicBot.yaml:

defaults:
  backend: claude-code
  allowed_guilds:              # Only these servers can /start
    - "1496855124440780912"
    - "9876543210123456789"

• Empty or omitted allowed_guilds → all servers allowed (default)
• Primary guild (fleet.yaml group_id) → full access (topic mode + ClassicBot)
• Whitelisted guilds → ClassicBot only (/start, /chat, /stop)
• Hot reload — changes detected every 30 seconds, no restart needed

Per-Channel Backend

Override the backend for specific channels:

defaults:
  backend: claude-code
channels:
  "1234567890":               # Discord channel ID
    name: dev-help
    backend: gemini-cli       # Override for this channel

Backend fallback: channel → defaults.backend → fleet.yaml defaults → claude-code

Known Limitations

• macOS (launchd) and Linux (systemd) supported; Windows is not
• Official Telegram plugin in global enabledPlugins causes 409 polling conflicts
• OpenCode and Kiro CLI do not read MCP server instructions field — fleet context and workflow templates are not injected into these backends' system prompts. Awaiting upstream fix.

License

MIT