Rework CLI commands to be composable via piping by Copilot · Pull Request #1522 · Tyrrrz/DiscordChatExporter

Copilot · 2026-04-03T14:36:20Z

… exportguild/exportall/exportdm Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/5f305835-64af-456e-b0b4-6163ece1e8cf Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

…ne in channels redirect block Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/5f305835-64af-456e-b0b4-6163ece1e8cf Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/5f305835-64af-456e-b0b4-6163ece1e8cf Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz · 2026-04-03T14:58:27Z

@copilot

Let's employ the following command structure:

list channels <guild-ids...> ... (allow multiple guild ids as input)
list channels dm
list guilds
export ...

Keep the option binding for --token but use parameter bindings for primary parameters like guild-id, channel-ids, etc.

…l parameters Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/27f23ff6-5b39-46d3-a7dc-387749ee63fa Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot · 2026-04-03T15:05:55Z

@copilot

Let's employ the following command structure:
...

Done in commit 0e3b455. The commands are now:

list channels <guild-ids...> — accepts one or more guild IDs as positional parameters; supports --include-vc and --include-threads options
list channels dm — lists direct message channels
list guilds — lists accessible servers
export <channel-ids...> — channel IDs are now positional parameters; falls back to reading from stdin when none are provided (enabling piping from list channels / list channels dm)

--token and other secondary configuration remain as --option bindings. Example pipe flow:

./DiscordChatExporter.Cli list channels 123456 789012 | ./DiscordChatExporter.Cli export

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

av-build-tel-api-v1.avaloniaui.net
- Triggering command: /usr/share/dotnet/dotnet dotnet exec --runtimeconfig /home/REDACTED/.nuget/packages/avalonia.buildservices/11.3.2/tools/netstandard2.0/runtimeconfig.json /home/REDACTED/.nuget/packages/avalonia.buildservices/11.3.2/tools/netstandard2.0/Avalonia.BuildServices.Collector.dll (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Tyrrrz · 2026-04-03T15:07:42Z

@copilot add a stub list command that errors with help text when executed. It should be used only to group related list commands in the help text.

Tyrrrz · 2026-04-03T15:08:38Z

@copilot in the docs, show an example of the pipeline that starts by setting the environment variable for the token. Linux/macOS can be one-liners.

Tyrrrz · 2026-04-03T15:10:15Z

@copilot
Add dce.sh file to the DCE.CLI project that acts as an alias/pass-through to DiscordChatExporter.Cli. Not sure if something equivalent can be done with cmd/bat but do that too if possible.

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/b148b0cc-7ec8-4fa1-bbd6-36dfd116ceec Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot · 2026-04-03T15:10:55Z

@copilot add a stub list command that errors with help text when executed. It should be used only to group related list commands in the help text.

Done in commit f3638ec. ListCommand.cs uses CommandException with showHelp: true, so running list directly shows the error message and then the scoped help listing the available subcommands:

A subcommand is required ('channels', 'channels dm', or 'guilds').

USAGE
  DiscordChatExporter.Cli list [options]
  DiscordChatExporter.Cli list [command] ...

DESCRIPTION
  Lists channels, DMs, or servers.

COMMANDS
  channels     Gets the list of channels in one or more servers.
  guilds       Gets the list of accessible servers.

The top-level --help also now shows list as a grouped entry with its subcommands.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

av-build-tel-api-v1.avaloniaui.net
- Triggering command: /usr/share/dotnet/dotnet dotnet exec --runtimeconfig /home/REDACTED/.nuget/packages/avalonia.buildservices/11.3.2/tools/netstandard2.0/runtimeconfig.json /home/REDACTED/.nuget/packages/avalonia.buildservices/11.3.2/tools/netstandard2.0/Avalonia.BuildServices.Collector.dll (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

…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>

Copilot · 2026-04-03T15:14:08Z

@copilot in the docs, show an example of the pipeline that starts by setting the environment variable for the token. Linux/macOS can be one-liners.

Done in commit 55c06ef. Pipeline sections now show Linux/macOS one-liners with DISCORD_TOKEN set inline, and Windows examples as two-step (set then pipe). For example:

Linux/macOS:

DISCORD_TOKEN="mfa.Ifrn" ./DiscordChatExporter.Cli list channels 21814 | ./DiscordChatExporter.Cli export

Windows:

set DISCORD_TOKEN=mfa.Ifrn
DiscordChatExporter.Cli list channels 21814 | DiscordChatExporter.Cli export

@copilot
Add dce.sh file to the DCE.CLI project that acts as an alias/pass-through to DiscordChatExporter.Cli. Not sure if something equivalent can be done with cmd/bat but do that too if po...

Done in commit 55c06ef. Added two scripts to the CLI project:

dce.sh — delegates to DiscordChatExporter.Cli via exec "$(dirname "$0")/DiscordChatExporter.Cli" "$@"
dce.bat — delegates to DiscordChatExporter.Cli.exe via "%~dp0DiscordChatExporter.Cli.exe" %*

Both are included in the .csproj with CopyToOutputDirectory and CopyToPublishDirectory set to PreserveNewest, so they'll appear alongside the binary in both debug builds and published output.

Tyrrrz · 2026-04-03T15:46:13Z

@copilot

For the ListCommand, error out with "Use of the nammed commands listed below".

Update CLI docs to use the new dce alias for all command executions.

…ce guard Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/e94c999b-5241-4e2e-9af1-01f6be95e72c Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

…flakeJsonConverter in CLI Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/58698f45-e22e-4bd4-aec4-31f801051467 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

.docs/Using-the-CLI.md

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/aa0b1344-6eb9-4853-9b48-afd06e94c970 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz · 2026-04-04T11:15:01Z

DiscordChatExporter.Cli/Commands/ExportChannelsCommand.cs

+        Name = "channel-ids",
        Description = "Channel ID(s). "
-            + "If provided with category ID(s), all channels inside those categories will be exported."
+            + "If provided with category ID(s), all channels inside those categories will be exported. "


Safe to remove this, since we have list unwrap? Along with any code responsible for this @copilot

Done in commit f8ab926. Removed the category description and unwrapping code from export — the command now simply resolves each channel ID and exports it. Added a new list unwrap command that reads a JSON channel array from stdin (produced by list channels / list channels dm) and replaces any category channels with their children:

./dce list channels 21814 | ./dce list unwrap | ./dce export

DiscordChatExporter.Cli/Commands/ExportChannelsCommand.cs

Tyrrrz · 2026-04-04T11:17:14Z

.docs/Using-the-CLI.md

+./dce list channels dm -t "mfa.Ifrn"
+```
+
+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:


Docs are outdated on this @copilot

Already addressed in commit f8ab926 — the outdated "prints only channel IDs (one per line)" text was updated to "outputs a JSON array of channel objects" for both list channels and list channels dm sections.

Tyrrrz · 2026-04-04T11:17:47Z

DiscordChatExporter.Cli/Commands/GetChannelsCommand.cs

-    [CommandOption("guild", 'g', Description = "Server ID.")]
-    public required Snowflake GuildId { get; set; }
+    [CommandParameter(0, Name = "server-ids", Description = "Server ID(s).")]
+    public required IReadOnlyList<Snowflake> GuildIds { get; set; }


Update internal naming too @copilot

Done in commit f6e7109. Renamed GuildIds to ServerIds and the loop variable from guildId to serverId throughout GetChannelsCommand.

…d [!IMPORTANT] callouts to pipeline doc sections Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/d2a03a38-0ed4-45c7-b8e7-615ffb35c971 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/d2a03a38-0ed4-45c7-b8e7-615ffb35c971 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

…rverIds in GetChannelsCommand Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/ab01ba49-ad07-42ba-b382-27f4d105a92b Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz · 2026-04-04T20:44:24Z

DiscordChatExporter.Cli/Commands/UnwrapChannelsCommand.cs

+
+[Command(
+    "list unwrap",
+    Description = "Resolves categories in a channel list to their child channels."


We should also resolve forum channels I think... @copilot

Done in commit ea0b47f. list unwrap now also expands forum channels (GuildForum) to their thread posts using Discord.GetChannelThreadsAsync. Updated the command description and docs to mention forums alongside categories.

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/674ba90d-1778-4427-b50a-30bc50195319 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Initial plan

716ea79

Copilot AI assigned Copilot and Tyrrrz Apr 3, 2026

Copilot started work on behalf of Tyrrrz April 3, 2026 14:36 View session

Copilot AI linked an issue Apr 3, 2026 that may be closed by this pull request

Rework the CLI commands to be more composable #1210

Open

Copilot AI and others added 3 commits April 3, 2026 14:42

Address code review: fix Snowflake.TryParse usage and remove blank li…

6750195

…ne in channels redirect block Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/5f305835-64af-456e-b0b4-6163ece1e8cf Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Clarify DISCORD_TOKEN env var tip in documentation

16ecb28

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/5f305835-64af-456e-b0b4-6163ece1e8cf Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Rework CLI commands for better composability~~ Rework CLI commands to be composable via piping Apr 3, 2026

Copilot finished work on behalf of Tyrrrz April 3, 2026 14:47

Copilot AI requested a review from Tyrrrz April 3, 2026 14:47

Tyrrrz added enhancement app/cli labels Apr 3, 2026

Copilot started work on behalf of Tyrrrz April 3, 2026 14:58 View session

Restructure commands: list channels/guilds subcommands with positiona…

0e3b455

…l parameters Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/27f23ff6-5b39-46d3-a7dc-387749ee63fa Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 3, 2026 15:06

Copilot started work on behalf of Tyrrrz April 3, 2026 15:07 View session

Add stub 'list' command that errors with help text when executed

f3638ec

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/b148b0cc-7ec8-4fa1-bbd6-36dfd116ceec Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 3, 2026 15:11

Copilot started work on behalf of Tyrrrz April 3, 2026 15:11 View session

Add dce.sh/dce.bat alias scripts and update docs with inline DISCORD_…

55c06ef

…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>

Copilot finished work on behalf of Tyrrrz April 3, 2026 15:15

Copilot started work on behalf of Tyrrrz April 4, 2026 09:12 View session

Add .ConfigureAwait(false) to ReadLinesAsync; remove IsNullOrWhiteSpa…

89407c1

…ce guard Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/e94c999b-5241-4e2e-9af1-01f6be95e72c Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 4, 2026 09:15

Copilot started work on behalf of Tyrrrz April 4, 2026 09:36 View session

list commands always output JSON; add CliJsonSerializerContext + Snow…

b0ee4ba

…flakeJsonConverter in CLI Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/58698f45-e22e-4bd4-aec4-31f801051467 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 4, 2026 09:51

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

.docs/Using-the-CLI.md Outdated Show resolved Hide resolved

Copilot started work on behalf of Tyrrrz April 4, 2026 11:11 View session

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

.docs/Using-the-CLI.md Show resolved Hide resolved

docs: use -short|--long convention for option names in prose text

948ceba

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/aa0b1344-6eb9-4853-9b48-afd06e94c970 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

Copilot finished work on behalf of Tyrrrz April 4, 2026 11:15

Copilot AI requested a review from Tyrrrz April 4, 2026 11:15

Copilot started work on behalf of Tyrrrz April 4, 2026 11:15 View session

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

DiscordChatExporter.Cli/Commands/ExportChannelsCommand.cs Outdated Show resolved Hide resolved

Update error message for missing channel IDs

7f08641

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

Copilot AI and others added 2 commits April 4, 2026 11:23

Fix: catch JsonException in list unwrap; improve export error message

1835af1

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/d2a03a38-0ed4-45c7-b8e7-615ffb35c971 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 4, 2026 11:29

Copilot AI requested a review from Tyrrrz April 4, 2026 11:29

Copilot started work on behalf of Tyrrrz April 4, 2026 11:29 View session

Fix export JSON detection to use numeric check; rename GuildIds to Se…

f6e7109

…rverIds in GetChannelsCommand Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/ab01ba49-ad07-42ba-b382-27f4d105a92b Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 4, 2026 11:36

Tyrrrz reviewed Apr 4, 2026

View reviewed changes

Copilot started work on behalf of Tyrrrz April 4, 2026 20:44 View session

Expand list unwrap to also resolve forum channels to thread posts

ea0b47f

Agent-Logs-Url: https://github.com/Tyrrrz/DiscordChatExporter/sessions/674ba90d-1778-4427-b50a-30bc50195319 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 4, 2026 20:50

Copilot AI requested a review from Tyrrrz April 4, 2026 20:50

Uh oh!

Conversation

Copilot AI commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Tyrrrz commented Apr 3, 2026

Uh oh!

Copilot AI commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Tyrrrz commented Apr 3, 2026

Uh oh!

Tyrrrz commented Apr 3, 2026

Uh oh!

Tyrrrz commented Apr 3, 2026

Uh oh!

Copilot AI commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Copilot AI commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Tyrrrz commented Apr 3, 2026

Uh oh!

Uh oh!

Uh oh!

Tyrrrz Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Tyrrrz Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Tyrrrz Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Tyrrrz Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Apr 3, 2026 •

edited

Loading

Copilot AI commented Apr 3, 2026 •

edited

Loading

Copilot AI commented Apr 3, 2026 •

edited

Loading

Copilot AI commented Apr 3, 2026 •

edited

Loading