feat: add file attachment support to all send commands

Add --file option (repeatable) to message send, message reply, dm send,
and thread send. Uses discord.File under the hood.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: DevRohit06

README.md

@@ -116,10 +116,12 @@ Every command supports `--json` for machine-readable output.
 ```bash
 discli message send #general "Hello world!"
 discli message send #general "Check this out" --embed-title "News" --embed-desc "Big update"
+discli message send #general "Here's the report" --file report.pdf
+discli message send #general "Screenshots" --file bug.png --file logs.txt
 discli message list #general --limit 20
 discli message list #general --after 2026-03-01 --before 2026-03-14
 discli message get #general 123456789
-discli message reply #general 123456789 "Thanks for your question!"
+discli message reply #general 123456789 "Here you go" --file fix.patch
 discli message edit #general 123456789 "Updated text"
 discli message delete #general 123456789
 ```
@@ -140,6 +142,7 @@ discli message history #general --hours 24 --limit 500
 
 ```bash
 discli dm send alice "Hey, need help?"
+discli dm send alice "Check this file" --file notes.pdf
 discli dm send 123456789 "Sent by user ID"
 discli dm list alice --limit 10
 ```
@@ -168,6 +171,7 @@ discli channel delete #old-channel
 discli thread create #general 123456789 "Support Ticket"
 discli thread list #general
 discli thread send 987654321 "Following up on your issue"
+discli thread send 987654321 "Attached the logs" --file debug.log
 ```
 
 ### Servers

agents/discord-agent.md

@@ -8,7 +8,10 @@ You are a Discord agent with access to the `discli` CLI tool. Use the Bash tool
 ```bash
 discli message send <channel> "text"
 discli message send <channel> "text" --embed-title "Title" --embed-desc "Description"
+discli message send <channel> "text" --file path/to/file.png
+discli message send <channel> "text" --file file1.png --file file2.pdf
 discli message reply <channel> <message_id> "text"
+discli message reply <channel> <message_id> "text" --file path/to/file.png
 discli message get <channel> <message_id>
 discli message list <channel> --limit 10 [--before YYYY-MM-DD] [--after YYYY-MM-DD]
 discli message edit <channel> <message_id> "new text"
@@ -28,6 +31,7 @@ discli reaction list <channel> <message_id>
 ### Direct Messages
 ```bash
 discli dm send <user> "text"
+discli dm send <user> "text" --file path/to/file.png
 discli dm list <user> --limit 10
 ```
 
@@ -44,6 +48,7 @@ discli channel info <channel>
 discli thread create <channel> <message_id> "thread name"
 discli thread list <channel>
 discli thread send <thread_id> "text"
+discli thread send <thread_id> "text" --file path/to/file.png
 ```
 
 ### Servers

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "discord-cli-agent"
-version = "0.3.0"
+version = "0.4.0"
 description = "Discord CLI for AI agents"
 readme = "README.md"
 license = "MIT"

src/discli/commands/dm.py

@@ -28,21 +28,29 @@ def dm_group():
 @dm_group.command("send")
 @click.argument("user")
 @click.argument("text")
+@click.option("--file", "files", multiple=True, type=click.Path(exists=True), help="File to attach (repeatable).")
 @click.pass_context
-def dm_send(ctx, user, text):
+def dm_send(ctx, user, text, files):
     """Send a direct message to a user."""
+    import discord
 
     def action(client):
         async def _action(client):
             u = resolve_user(client, user)
             dm_channel = await u.create_dm()
-            msg = await dm_channel.send(content=text)
+            attachments = [discord.File(f) for f in files]
+            kwargs = {"content": text}
+            if attachments:
+                kwargs["files"] = attachments
+            msg = await dm_channel.send(**kwargs)
             data = {
                 "id": str(msg.id),
                 "to": str(u),
                 "to_id": str(u.id),
                 "content": msg.content,
             }
+            if msg.attachments:
+                data["attachments"] = [{"filename": a.filename, "url": a.url, "size": a.size} for a in msg.attachments]
             output(ctx, data, plain_text=f"Sent DM to {u} (ID: {u.id}): {text[:50]}")
         return _action(client)
 

src/discli/commands/message.py

@@ -15,8 +15,9 @@ def message_group():
 @click.argument("text")
 @click.option("--embed-title", default=None, help="Embed title.")
 @click.option("--embed-desc", default=None, help="Embed description.")
+@click.option("--file", "files", multiple=True, type=click.Path(exists=True), help="File to attach (repeatable).")
 @click.pass_context
-def message_send(ctx, channel, text, embed_title, embed_desc):
+def message_send(ctx, channel, text, embed_title, embed_desc, files):
     """Send a message to a channel."""
 
     def action(client):
@@ -25,8 +26,14 @@ async def _action(client):
             embed = None
             if embed_title or embed_desc:
                 embed = discord.Embed(title=embed_title, description=embed_desc)
-            msg = await ch.send(content=text, embed=embed)
+            attachments = [discord.File(f) for f in files]
+            kwargs = {"content": text, "embed": embed}
+            if attachments:
+                kwargs["files"] = attachments
+            msg = await ch.send(**kwargs)
             data = {"id": str(msg.id), "channel": ch.name, "content": msg.content}
+            if msg.attachments:
+                data["attachments"] = [{"filename": a.filename, "url": a.url, "size": a.size} for a in msg.attachments]
             output(ctx, data, plain_text=f"Sent message {msg.id} to #{ch.name}")
         return _action(client)
 
@@ -207,16 +214,23 @@ async def _action(client):
 @click.argument("channel")
 @click.argument("message_id")
 @click.argument("text")
+@click.option("--file", "files", multiple=True, type=click.Path(exists=True), help="File to attach (repeatable).")
 @click.pass_context
-def message_reply(ctx, channel, message_id, text):
+def message_reply(ctx, channel, message_id, text, files):
     """Reply to a specific message."""
 
     def action(client):
         async def _action(client):
             ch = resolve_channel(client, channel)
             original = await ch.fetch_message(int(message_id))
-            msg = await original.reply(content=text)
+            attachments = [discord.File(f) for f in files]
+            kwargs = {"content": text}
+            if attachments:
+                kwargs["files"] = attachments
+            msg = await original.reply(**kwargs)
             data = {"id": str(msg.id), "channel": ch.name, "content": msg.content, "reply_to": message_id}
+            if msg.attachments:
+                data["attachments"] = [{"filename": a.filename, "url": a.url, "size": a.size} for a in msg.attachments]
             output(ctx, data, plain_text=f"Replied to {message_id} in #{ch.name}")
         return _action(client)
 

src/discli/commands/thread.py

@@ -84,20 +84,27 @@ async def _action(client):
 @thread_group.command("send")
 @click.argument("thread")
 @click.argument("text")
+@click.option("--file", "files", multiple=True, type=click.Path(exists=True), help="File to attach (repeatable).")
 @click.pass_context
-def thread_send(ctx, thread, text):
+def thread_send(ctx, thread, text, files):
     """Send a message to a thread."""
 
     def action(client):
         async def _action(client):
             t = resolve_thread(client, thread)
-            msg = await t.send(content=text)
+            attachments = [discord.File(f) for f in files]
+            kwargs = {"content": text}
+            if attachments:
+                kwargs["files"] = attachments
+            msg = await t.send(**kwargs)
             data = {
                 "id": str(msg.id),
                 "thread": t.name,
                 "thread_id": str(t.id),
                 "content": msg.content,
             }
+            if msg.attachments:
+                data["attachments"] = [{"filename": a.filename, "url": a.url, "size": a.size} for a in msg.attachments]
             output(ctx, data, plain_text=f"Sent message {msg.id} to thread '{t.name}'")
         return _action(client)