From 55c06ef40e292b82a31b80003f1976c5974f0f98 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 15:13:58 +0000
Subject: [PATCH] Add dce.sh/dce.bat alias scripts and update docs with inline
DISCORD_TOKEN pipeline examples
Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/98d87128-db13-4085-84c3-6290d3faffca
Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>
---
.docs/Using-the-CLI.md | 36 +++++++++++++------
.../DiscordChatExporter.Cli.csproj | 13 +++++++
DiscordChatExporter.Cli/dce.bat | 2 ++
DiscordChatExporter.Cli/dce.sh | 2 ++
4 files changed, 43 insertions(+), 10 deletions(-)
create mode 100644 DiscordChatExporter.Cli/dce.bat
create mode 100644 DiscordChatExporter.Cli/dce.sh
diff --git a/.docs/Using-the-CLI.md b/.docs/Using-the-CLI.md
index a3d626d7..ed1e8683 100644
--- a/.docs/Using-the-CLI.md
+++ b/.docs/Using-the-CLI.md
@@ -222,18 +222,25 @@ Documentation on message filter syntax can be found [here](https://github.com/Ty
### Export channels from a specific server
-To export all channels in a specific server, use `list channels` to list channels and pipe the result to `export`:
+To export all channels in a specific server, use `list channels` to list channels and pipe the result to `export`.
+
+**Linux/macOS** (one-liner, token set inline):
```console
-./DiscordChatExporter.Cli list channels -t "mfa.Ifrn" 21814 | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 | ./DiscordChatExporter.Cli export
```
-> **Tip**: To avoid repeating `--token` (or `-t`) twice, set the `DISCORD_TOKEN` environment variable: `export DISCORD_TOKEN="mfa.Ifrn"` (Linux/macOS) or `set DISCORD_TOKEN=mfa.Ifrn` (Windows). Then you can omit `-t` from both commands.
+**Windows**:
+
+```console
+set DISCORD_TOKEN=mfa.Ifrn
+DiscordChatExporter.Cli list channels 21814 | DiscordChatExporter.Cli export
+```
You can also list channels for multiple guilds at once:
```console
-./DiscordChatExporter.Cli list channels -t "mfa.Ifrn" 21814 35930 | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 35930 | ./DiscordChatExporter.Cli export
```
#### Including threads
@@ -241,7 +248,7 @@ You can also list channels for multiple guilds at once:
By default, threads are not included. You can change this behavior by passing `--include-threads` to the `list channels` command. It has possible values of `none`, `active`, or `all`, indicating which threads should be included. To include both active and archived threads, use `--include-threads all`.
```console
-./DiscordChatExporter.Cli list channels -t "mfa.Ifrn" 21814 --include-threads all | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 --include-threads all | ./DiscordChatExporter.Cli export
```
#### Including voice channels
@@ -249,15 +256,24 @@ By default, threads are not included. You can change this behavior by passing `-
By default, voice channels are included. You can change this behavior by passing `--include-vc false` to the `list channels` command.
```console
-./DiscordChatExporter.Cli list channels -t "mfa.Ifrn" 21814 --include-vc false | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 --include-vc false | ./DiscordChatExporter.Cli export
```
-### Export all channels
+### Export all DMs
To export all DMs:
+**Linux/macOS**:
+
```console
-./DiscordChatExporter.Cli list channels dm -t "mfa.Ifrn" | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels dm | ./DiscordChatExporter.Cli export
+```
+
+**Windows**:
+
+```console
+set DISCORD_TOKEN=mfa.Ifrn
+DiscordChatExporter.Cli list channels dm | DiscordChatExporter.Cli export
```
### List channels in a server
@@ -271,7 +287,7 @@ To list the channels available in a specific server, use the `list channels` com
When the output is redirected or piped, the `list channels` command prints only channel IDs (one per line). This allows you to pipe the output directly to the `export` command:
```console
-./DiscordChatExporter.Cli list channels -t "mfa.Ifrn" 21814 | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 | ./DiscordChatExporter.Cli export
```
### List direct message channels
@@ -285,7 +301,7 @@ To list all DM channels accessible to the current account, use the `list channel
When the output is redirected or piped, the `list channels dm` command prints only channel IDs (one per line). This allows you to pipe the output directly to the `export` command:
```console
-./DiscordChatExporter.Cli list channels dm -t "mfa.Ifrn" | ./DiscordChatExporter.Cli export -t "mfa.Ifrn"
+DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels dm | ./DiscordChatExporter.Cli export
```
### List servers
diff --git a/DiscordChatExporter.Cli/DiscordChatExporter.Cli.csproj b/DiscordChatExporter.Cli/DiscordChatExporter.Cli.csproj
index 9e4b02c8..f6650ab9 100644
--- a/DiscordChatExporter.Cli/DiscordChatExporter.Cli.csproj
+++ b/DiscordChatExporter.Cli/DiscordChatExporter.Cli.csproj
@@ -17,4 +17,17 @@
+
+
+
+
+
diff --git a/DiscordChatExporter.Cli/dce.bat b/DiscordChatExporter.Cli/dce.bat
new file mode 100644
index 00000000..0db4aa97
--- /dev/null
+++ b/DiscordChatExporter.Cli/dce.bat
@@ -0,0 +1,2 @@
+@echo off
+"%~dp0DiscordChatExporter.Cli.exe" %*
diff --git a/DiscordChatExporter.Cli/dce.sh b/DiscordChatExporter.Cli/dce.sh
new file mode 100644
index 00000000..4665f18e
--- /dev/null
+++ b/DiscordChatExporter.Cli/dce.sh
@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+exec "$(dirname "$0")/DiscordChatExporter.Cli" "$@"