FURLOW

Declarative Discord Bot Framework

Build powerful Discord bots with YAML. No code required.

commands:
  - name: ping
    description: Check bot latency
    actions:
      - reply:
          content: "Pong! ${client.ws.ping}ms"

Features

• 85 Actions: messages, moderation, voice, channels, and more
• 71 Expression Functions: date, math, string, array manipulation
• 50 Transforms: pipe-based data transformations
• 59 Events across Discord gateway, voice transitions, component interactions, and high-level FURLOW events (automod, scheduler, pipes)
• Scoped State: global, guild, channel, user, and member scopes
• Flows: reusable action sequences with parameters
• External Integrations: HTTP, WebSocket, MQTT, TCP/UDP, webhooks

Quick Start

# Install the CLI
npm install -g @furlow/cli

# Create a bot
furlow init my-bot
cd my-bot

# Add your Discord credentials to .env
echo "DISCORD_TOKEN=your_token_here" > .env
echo "DISCORD_CLIENT_ID=your_client_id_here" >> .env

# Start
furlow start

Example

version: "0.1"

identity:
  name: "My Bot"

presence:
  status: online
  activity:
    type: playing
    text: "with FURLOW"

commands:
  - name: hello
    description: Greet someone
    options:
      - name: user
        type: user
        description: Who to greet
    actions:
      - reply:
          content: "Hello, ${options.user.display_name || options.user.username}!"

  - name: roll
    description: Roll a dice
    options:
      - name: sides
        type: integer
        description: Number of sides
        min_value: 2
        max_value: 100
    actions:
      - reply:
          content: "🎲 You rolled **${random(1, options.sides || 6)}**"

events:
  - event: member_join
    actions:
      - send_message:
          channel: "${env.WELCOME_CHANNEL}"
          content: "Welcome ${member.displayName}!"

CLI Commands

Command	Description
furlow init [name]	Create a new bot project
furlow start [path]	Run the bot
furlow dev [path]	Development mode with hot reload
furlow validate <path>	Validate YAML specification
furlow add <builtin>	Add builtin module
furlow build [path]	Bundle for deployment
furlow export <path>	Export Discord command JSON

Documentation

Guide	Description
Installation	Setup and requirements
Quick Start	Your first bot
Configuration	YAML specification
Actions Reference	All 85 actions
Expressions Reference	Functions and transforms
Events Reference	Event types
CLI Reference	Command-line interface
Pipes Reference	External integrations
Examples	Complete bot examples

Packages

Package	Description
furlow	CLI tool
@furlow/core	Runtime engine
@furlow/discord	Discord.js adapter
@furlow/schema	TypeScript types
@furlow/storage	Database adapters
@furlow/builtins	Pre-built modules
@furlow/pipes	HTTP, WebSocket, MQTT, TCP/UDP, webhooks, database, file
@furlow/testing	Test utilities

Production deployment

A short checklist for shipping a bot to production. Each item lines up with a runtime guarantee — skipping one usually shows up later as silent data loss, an unscheduled feature, or a publicly forgeable session.

Required environment

# Discord
DISCORD_TOKEN=...
DISCORD_CLIENT

... [View full README on GitHub](https://github.com/virgilvox/discord-furlow#readme)