discord-cli-agent 0.1.0__tar.gz

discord_cli_agent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevRohit06
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

discord_cli_agent-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: discord-cli-agent
+Version: 0.1.0
+Summary: Discord CLI for AI agents
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord.py>=2.3
+Requires-Dist: click>=8.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Dynamic: license-file
+
+# discli
+
+A command-line interface for Discord, built for AI agents and humans. Manage servers, send messages, react, handle DMs, threads, and monitor events — all from the terminal.
+
+## Install
+
+```bash
+pip install discord-cli-agent
+```
+
+For development:
+
+```bash
+pip install -e .
+```
+
+Requires Python 3.10+.
+
+## Setup
+
+1. Create a bot at [Discord Developer Portal](https://discord.com/developers/applications)
+2. Enable **all privileged intents** (Presence, Server Members, Message Content)
+3. Add the bot to your server with appropriate permissions
+4. Configure your token:
+
+```bash
+# Option A: Save to config
+discli config set token YOUR_BOT_TOKEN
+
+# Option B: Environment variable
+export DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN
+
+# Option C: Pass directly
+discli --token YOUR_BOT_TOKEN server list
+```
+
+## Usage
+
+Every command supports `--json` for machine-readable output.
+
+### Messages
+
+```bash
+discli message send #general "Hello world!"
+discli message send #general "Check this out" --embed-title "News" --embed-desc "Big update"
+discli message list #general --limit 20
+discli message get #general 123456789
+discli message reply #general 123456789 "Thanks for your question!"
+discli message edit #general 123456789 "Updated text"
+discli message delete #general 123456789
+```
+
+### Direct Messages
+
+```bash
+discli dm send alice "Hey, need help?"
+discli dm send 123456789 "Sent by user ID"
+discli dm list alice --limit 10
+```
+
+### Reactions
+
+```bash
+discli reaction add #general 123456789 👍
+discli reaction remove #general 123456789 👍
+discli reaction list #general 123456789
+```
+
+### Channels
+
+```bash
+discli channel list --server "My Server"
+discli channel create "My Server" new-channel --type text
+discli channel create "My Server" voice-room --type voice
+discli channel info #general
+discli channel delete #old-channel
+```
+
+### Threads
+
+```bash
+discli thread create #general 123456789 "Support Ticket"
+discli thread list #general
+discli thread send 987654321 "Following up on your issue"
+```
+
+### Servers
+
+```bash
+discli server list
+discli server info "My Server"
+```
+
+### Roles
+
+```bash
+discli role list "My Server"
+discli role create "My Server" Moderator --color ff0000
+discli role assign "My Server" alice Moderator
+discli role remove "My Server" alice Moderator
+discli role delete "My Server" Moderator
+```
+
+### Members
+
+```bash
+discli member list "My Server" --limit 100
+discli member info "My Server" alice
+discli member kick "My Server" alice --reason "Spam"
+discli member ban "My Server" alice --reason "Repeated violations"
+discli member unban "My Server" alice
+```
+
+### Typing Indicator
+
+```bash
+discli typing #general                # 5 seconds (default)
+discli typing #general --duration 10  # 10 seconds
+```
+
+### Live Event Monitoring
+
+```bash
+# Listen to everything
+discli listen
+
+# Filter by server/channel
+discli listen --server "My Server" --channel #general
+
+# Filter by event type
+discli listen --events messages,reactions
+
+# Include bot messages (ignored by default)
+discli listen --include-bots
+
+# JSON output for piping to an agent
+discli listen --json --events messages
+```
+
+Supported event types: `messages`, `reactions`, `members`, `edits`, `deletes`
+
+## Resolving Identifiers
+
+All commands accept both **IDs** and **names**:
+
+| Type | By ID | By Name |
+|------|-------|---------|
+| Channel | `123456789` | `#general` |
+| Server | `123456789` | `My Server` |
+| Member | `123456789` | `alice` |
+| Role | `123456789` | `Moderator` |
+| Thread | `123456789` | `Support Ticket` |
+| User (DM) | `123456789` | `alice` |
+
+## JSON Output
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+$ discli message list #general --limit 1 --json
+[
+  {
+    "id": "123456789",
+    "author": "alice",
+    "content": "Hello!",
+    "timestamp": "2026-03-14T10:32:00+00:00"
+  }
+]
+
+$ discli listen --json
+{"event": "message", "server": "My Server", "channel": "general", "channel_id": "111", "author": "alice", "author_id": "222", "content": "hello", "message_id": "333", "mentions_bot": false, "attachments": [], ...}
+```
+
+## Building an AI Agent
+
+A basic agent loop using `discli`:
+
+```bash
+# 1. Listen for messages mentioning the bot
+discli listen --json --events messages | while read -r event; do
+  mentions_bot=$(echo "$event" | jq -r '.mentions_bot')
+  if [ "$mentions_bot" = "true" ]; then
+    channel_id=$(echo "$event" | jq -r '.channel_id')
+    message_id=$(echo "$event" | jq -r '.message_id')
+    content=$(echo "$event" | jq -r '.content')
+
+    # 2. Show typing while thinking
+    discli typing "$channel_id" --duration 3 &
+
+    # 3. Generate response (your AI here)
+    response="Got your message: $content"
+
+    # 4. Reply to the message
+    discli message reply "$channel_id" "$message_id" "$response"
+  fi
+done
+```
+
+## Configuration
+
+Config is stored at `~/.discli/config.json`.
+
+```bash
+discli config set token YOUR_TOKEN
+discli config show
+discli config show --json
+```
+
+Token resolution order: `--token` flag > `DISCORD_BOT_TOKEN` env var > config file.
+
+## License
+
+MIT

discord_cli_agent-0.1.0/README.md

@@ -0,0 +1,213 @@
+# discli
+
+A command-line interface for Discord, built for AI agents and humans. Manage servers, send messages, react, handle DMs, threads, and monitor events — all from the terminal.
+
+## Install
+
+```bash
+pip install discord-cli-agent
+```
+
+For development:
+
+```bash
+pip install -e .
+```
+
+Requires Python 3.10+.
+
+## Setup
+
+1. Create a bot at [Discord Developer Portal](https://discord.com/developers/applications)
+2. Enable **all privileged intents** (Presence, Server Members, Message Content)
+3. Add the bot to your server with appropriate permissions
+4. Configure your token:
+
+```bash
+# Option A: Save to config
+discli config set token YOUR_BOT_TOKEN
+
+# Option B: Environment variable
+export DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN
+
+# Option C: Pass directly
+discli --token YOUR_BOT_TOKEN server list
+```
+
+## Usage
+
+Every command supports `--json` for machine-readable output.
+
+### Messages
+
+```bash
+discli message send #general "Hello world!"
+discli message send #general "Check this out" --embed-title "News" --embed-desc "Big update"
+discli message list #general --limit 20
+discli message get #general 123456789
+discli message reply #general 123456789 "Thanks for your question!"
+discli message edit #general 123456789 "Updated text"
+discli message delete #general 123456789
+```
+
+### Direct Messages
+
+```bash
+discli dm send alice "Hey, need help?"
+discli dm send 123456789 "Sent by user ID"
+discli dm list alice --limit 10
+```
+
+### Reactions
+
+```bash
+discli reaction add #general 123456789 👍
+discli reaction remove #general 123456789 👍
+discli reaction list #general 123456789
+```
+
+### Channels
+
+```bash
+discli channel list --server "My Server"
+discli channel create "My Server" new-channel --type text
+discli channel create "My Server" voice-room --type voice
+discli channel info #general
+discli channel delete #old-channel
+```
+
+### Threads
+
+```bash
+discli thread create #general 123456789 "Support Ticket"
+discli thread list #general
+discli thread send 987654321 "Following up on your issue"
+```
+
+### Servers
+
+```bash
+discli server list
+discli server info "My Server"
+```
+
+### Roles
+
+```bash
+discli role list "My Server"
+discli role create "My Server" Moderator --color ff0000
+discli role assign "My Server" alice Moderator
+discli role remove "My Server" alice Moderator
+discli role delete "My Server" Moderator
+```
+
+### Members
+
+```bash
+discli member list "My Server" --limit 100
+discli member info "My Server" alice
+discli member kick "My Server" alice --reason "Spam"
+discli member ban "My Server" alice --reason "Repeated violations"
+discli member unban "My Server" alice
+```
+
+### Typing Indicator
+
+```bash
+discli typing #general                # 5 seconds (default)
+discli typing #general --duration 10  # 10 seconds
+```
+
+### Live Event Monitoring
+
+```bash
+# Listen to everything
+discli listen
+
+# Filter by server/channel
+discli listen --server "My Server" --channel #general
+
+# Filter by event type
+discli listen --events messages,reactions
+
+# Include bot messages (ignored by default)
+discli listen --include-bots
+
+# JSON output for piping to an agent
+discli listen --json --events messages
+```
+
+Supported event types: `messages`, `reactions`, `members`, `edits`, `deletes`
+
+## Resolving Identifiers
+
+All commands accept both **IDs** and **names**:
+
+| Type | By ID | By Name |
+|------|-------|---------|
+| Channel | `123456789` | `#general` |
+| Server | `123456789` | `My Server` |
+| Member | `123456789` | `alice` |
+| Role | `123456789` | `Moderator` |
+| Thread | `123456789` | `Support Ticket` |
+| User (DM) | `123456789` | `alice` |
+
+## JSON Output
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+$ discli message list #general --limit 1 --json
+[
+  {
+    "id": "123456789",
+    "author": "alice",
+    "content": "Hello!",
+    "timestamp": "2026-03-14T10:32:00+00:00"
+  }
+]
+
+$ discli listen --json
+{"event": "message", "server": "My Server", "channel": "general", "channel_id": "111", "author": "alice", "author_id": "222", "content": "hello", "message_id": "333", "mentions_bot": false, "attachments": [], ...}
+```
+
+## Building an AI Agent
+
+A basic agent loop using `discli`:
+
+```bash
+# 1. Listen for messages mentioning the bot
+discli listen --json --events messages | while read -r event; do
+  mentions_bot=$(echo "$event" | jq -r '.mentions_bot')
+  if [ "$mentions_bot" = "true" ]; then
+    channel_id=$(echo "$event" | jq -r '.channel_id')
+    message_id=$(echo "$event" | jq -r '.message_id')
+    content=$(echo "$event" | jq -r '.content')
+
+    # 2. Show typing while thinking
+    discli typing "$channel_id" --duration 3 &
+
+    # 3. Generate response (your AI here)
+    response="Got your message: $content"
+
+    # 4. Reply to the message
+    discli message reply "$channel_id" "$message_id" "$response"
+  fi
+done
+```
+
+## Configuration
+
+Config is stored at `~/.discli/config.json`.
+
+```bash
+discli config set token YOUR_TOKEN
+discli config show
+discli config show --json
+```
+
+Token resolution order: `--token` flag > `DISCORD_BOT_TOKEN` env var > config file.
+
+## License
+
+MIT

discord_cli_agent-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "discord-cli-agent"
+version = "0.1.0"
+description = "Discord CLI for AI agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "discord.py>=2.3",
+    "click>=8.1",
+]
+
+[project.scripts]
+discli = "discli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+]

discord_cli_agent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

discord_cli_agent-0.1.0/src/discli/__init__.py

@@ -0,0 +1 @@
+"""discli — Discord CLI for AI agents."""

discord_cli_agent-0.1.0/src/discli/cli.py

@@ -0,0 +1,41 @@
+import click
+
+from discli.config import load_config
+from discli.commands.channel import channel_group
+from discli.commands.config_cmd import config_group
+from discli.commands.dm import dm_group
+from discli.commands.listen import listen_cmd
+from discli.commands.member import member_group
+from discli.commands.message import message_group
+from discli.commands.reaction import reaction_group
+from discli.commands.role import role_group
+from discli.commands.server import server_group
+from discli.commands.thread import thread_group
+from discli.commands.typing_cmd import typing_cmd
+
+
+@click.group()
+@click.option("--token", envvar="DISCORD_BOT_TOKEN", default=None, help="Discord bot token.")
+@click.option("--json", "use_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def main(ctx, token, use_json):
+    """discli — Discord CLI for AI agents."""
+    ctx.ensure_object(dict)
+    if token is None:
+        config = load_config()
+        token = config.get("token")
+    ctx.obj["token"] = token
+    ctx.obj["use_json"] = use_json
+
+
+main.add_command(channel_group)
+main.add_command(config_group)
+main.add_command(dm_group)
+main.add_command(listen_cmd)
+main.add_command(member_group)
+main.add_command(message_group)
+main.add_command(reaction_group)
+main.add_command(role_group)
+main.add_command(server_group)
+main.add_command(thread_group)
+main.add_command(typing_cmd)

discord_cli_agent-0.1.0/src/discli/client.py

@@ -0,0 +1,51 @@
+import asyncio
+from typing import Any, Callable, Coroutine
+
+import click
+import discord
+
+
+def resolve_token(token: str | None, config: dict) -> str:
+    if token:
+        return token
+    config_token = config.get("token")
+    if config_token:
+        return config_token
+    raise click.ClickException(
+        "No token provided. Use --token, set DISCORD_BOT_TOKEN, or run: discli config set token YOUR_TOKEN"
+    )
+
+
+async def run_action(token: str, action: Callable[[discord.Client], Coroutine[Any, Any, Any]]) -> Any:
+    """Connect a bot client, run an action on_ready, return the result, disconnect."""
+    intents = discord.Intents.all()
+    client = discord.Client(intents=intents)
+    result = None
+    error = None
+
+    @client.event
+    async def on_ready():
+        nonlocal result, error
+        try:
+            result = await action(client)
+        except Exception as e:
+            error = e
+        finally:
+            await client.close()
+
+    await client.start(token)
+
+    if error:
+        raise error
+    return result
+
+
+def run_discord(ctx, action: Callable[[discord.Client], Coroutine[Any, Any, Any]]) -> Any:
+    """Synchronous entry point: resolve token, run action, return result."""
+    token = resolve_token(ctx.obj.get("token"), {})
+    try:
+        return asyncio.run(run_action(token, action))
+    except discord.LoginFailure:
+        raise click.ClickException("Invalid bot token.")
+    except discord.HTTPException as e:
+        raise click.ClickException(f"Discord API error: {e}")

discord_cli_agent-0.1.0/src/discli/commands/channel.py

@@ -0,0 +1,104 @@
+import click
+import discord
+
+from discli.client import run_discord
+from discli.utils import output, resolve_channel, resolve_guild
+
+
+@click.group("channel")
+def channel_group():
+    """List, create, delete, and inspect channels."""
+
+
+@channel_group.command("list")
+@click.option("--server", default=None, help="Server name or ID.")
+@click.pass_context
+def channel_list(ctx, server):
+    """List channels in a server."""
+
+    def action(client):
+        async def _action(client):
+            if server:
+                guilds = [resolve_guild(client, server)]
+            else:
+                guilds = client.guilds
+            channels = []
+            for g in guilds:
+                for ch in g.channels:
+                    if isinstance(ch, (discord.TextChannel, discord.VoiceChannel)):
+                        channels.append({
+                            "id": str(ch.id),
+                            "name": ch.name,
+                            "type": str(ch.type),
+                            "server": g.name,
+                        })
+            plain_lines = [f"#{c['name']} ({c['type']}) — {c['server']} (ID: {c['id']})" for c in channels]
+            output(ctx, channels, plain_text="\n".join(plain_lines) if plain_lines else "No channels found.")
+        return _action(client)
+
+    run_discord(ctx, action)
+
+
+@channel_group.command("create")
+@click.argument("server")
+@click.argument("name")
+@click.option("--type", "channel_type", type=click.Choice(["text", "voice", "category"]), default="text")
+@click.pass_context
+def channel_create(ctx, server, name, channel_type):
+    """Create a channel in a server."""
+
+    def action(client):
+        async def _action(client):
+            guild = resolve_guild(client, server)
+            if channel_type == "text":
+                ch = await guild.create_text_channel(name)
+            elif channel_type == "voice":
+                ch = await guild.create_voice_channel(name)
+            else:
+                ch = await guild.create_category(name)
+            data = {"id": str(ch.id), "name": ch.name, "type": str(ch.type)}
+            output(ctx, data, plain_text=f"Created #{ch.name} (ID: {ch.id})")
+        return _action(client)
+
+    run_discord(ctx, action)
+
+
+@channel_group.command("delete")
+@click.argument("channel")
+@click.pass_context
+def channel_delete(ctx, channel):
+    """Delete a channel."""
+
+    def action(client):
+        async def _action(client):
+            ch = resolve_channel(client, channel)
+            name = ch.name
+            await ch.delete()
+            output(ctx, {"id": str(ch.id), "deleted": True}, plain_text=f"Deleted #{name}")
+        return _action(client)
+
+    run_discord(ctx, action)
+
+
+@channel_group.command("info")
+@click.argument("channel")
+@click.pass_context
+def channel_info(ctx, channel):
+    """Show channel details."""
+
+    def action(client):
+        async def _action(client):
+            ch = resolve_channel(client, channel)
+            data = {
+                "id": str(ch.id),
+                "name": ch.name,
+                "type": str(ch.type),
+                "server": ch.guild.name,
+                "topic": getattr(ch, "topic", None),
+                "created_at": ch.created_at.isoformat(),
+            }
+            plain_lines = [f"{k}: {v}" for k, v in data.items() if v is not None]
+            output(ctx, data, plain_text="\n".join(plain_lines))
+        return _action(client)
+
+    run_discord(ctx, action)