discli vs Discord Libraries

discord.py and discord.js are the two dominant libraries for building Discord bots. They are powerful, battle-tested, and backed by large communities. discli takes a fundamentally different approach: instead of being a library you import, it is a standalone tool you run.

What they are

discord.py is an async Python library that wraps the Discord API. You write a Python program, define event handlers, and run it as a long-lived process. discord.js is the JavaScript equivalent built on Node.js. Both give you full, fine-grained control over every Discord API endpoint.

discli is a command-line tool and agent protocol. You interact with Discord through shell commands or a bidirectional JSONL stream. No library imports, no event loop management, no language lock-in.

Where discord.py/js excel

• Full API coverage — every endpoint, every object, every event
• Fine-grained control — custom caches, sharding strategies, voice connections
• Massive ecosystems — thousands of extensions, tutorials, and StackOverflow answers
• Production-proven — bots serving millions of users across tens of thousands of guilds

Where discli differs

• No boilerplate — send a message in one command, not 30 lines of setup
• Language-agnostic — any language that can spawn a subprocess or read JSONL works
• Security built-in — permission profiles, audit logs, and rate limiting out of the box
• Dual-mode — use it as a CLI for one-off tasks or as a persistent server for agents
• AI-native — the JSONL agent protocol was designed for LLM tool-use from day one

Comparison table

Code comparison

Here is the same task — a bot that listens for messages and replies — in both approaches.

import discord

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f"Logged in as {client.user}")

@client.event
async def on_message(message):
    if message.author == client.user:
        return
    if message.content.startswith("!hello"):
        await message.channel.send("Hello from discord.py!")

client.run("YOUR_BOT_TOKEN")

import subprocess, json

proc = subprocess.Popen(
    ["discli", "serve", "--events", "messages"],
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    text=True,
)

for line in proc.stdout:
    event = json.loads(line)
    if event.get("type") == "message_create":
        content = event["data"].get("content", "")
        if content.startswith("!hello"):
            action = {
                "action": "message_send",
                "channel": event["data"]["channel_id"],
                "content": "Hello from discli!",
            }
            proc.stdin.write(json.dumps(action) + "\n")
            proc.stdin.flush()

When to use discord.py or discord.js

Choose a library when you need:

• Rich embeds, buttons, select menus, and modals — full component builder APIs
• Voice and audio — connect to voice channels, play audio, record
• Complex stateful bots — conversation trees, multi-step wizards, persistent state machines
• Webhooks and OAuth2 flows — user-facing authentication and integrations
• Extreme scale — sharding across 10,000+ guilds with custom caching strategies

When to use discli

Choose discli when you need:

• AI agents that talk to Discord — the JSONL protocol was built for this
• Bash scripting and CI/CD — pipe Discord messages like any other Unix tool
• Security guardrails — permission profiles prevent agents from doing things they should not
• Fast prototyping — go from idea to working bot in minutes, not hours
• Language freedom — use whatever language your team already knows