@@ -60,7 +60,7 @@ See [CONFIGURATION.md](CONFIGURATION.md) for detailed configuration options.
6060| ** Generate daily checklist** | ` echecklist ` |
6161| ** Catch up after break** | ` ecatchup ` |
6262| ** Embabel repo summaries** | ` esummary ` |
63- | ** Sync Discord messages** | ` ./discord-sync/sync-discord.sh --channel ID --after DATE` |
63+ | ** Sync Discord messages** | ` ediscord --channel ID --after DATE` |
6464
6565## 🚀 Quick Start (5 minutes)
6666
@@ -188,10 +188,10 @@ embabel-learning/
188188
189189### Discord Integration
190190
191- | Script/Tool | Description |
192- | ------------------------------ | -------------------------------------------------------------------- |
193- | ` discord-sync/sync-discord.sh ` | Export and summarize Discord messages with filtering options |
194- | | See [ discord-sync/README.md] ( discord-sync/README.md ) for full docs |
191+ | Script/Tool | Alias | Description |
192+ | ------------------------------ | --------- | --------- ----------------------------------------------------------- |
193+ | ` discord-sync/sync-discord.sh ` | ` ediscord ` | Export and summarize Discord messages with filtering options |
194+ | | | See [ discord-sync/README.md] ( discord-sync/README.md ) for full docs |
195195
196196** Features:**
197197- Date range filtering (` --after ` , ` --before ` )
@@ -203,9 +203,7 @@ embabel-learning/
203203** Quick Example:**
204204``` bash
205205# Export today's messages
206- ./discord-sync/sync-discord.sh \
207- --channel YOUR_CHANNEL_ID \
208- --after " 2026-01-25"
206+ ediscord --channel YOUR_CHANNEL_ID --after " 2026-01-25"
209207```
210208
211209### Navigation & Workspace
@@ -321,6 +319,71 @@ cd ~/github/jmjava/guide
321319git diff upstream/main
322320```
323321
322+ ### Syncing Discord Messages
323+
324+ Export and summarize Discord messages from channels you're a member of:
325+
326+ ``` bash
327+ # Basic: Export today's messages
328+ ediscord --channel YOUR_CHANNEL_ID --after " 2026-01-25"
329+
330+ # With date range
331+ ediscord --channel YOUR_CHANNEL_ID \
332+ --after " 2026-01-25T00:00:00" \
333+ --before " 2026-01-26T00:00:00"
334+
335+ # Filter by specific users
336+ ediscord --channel YOUR_CHANNEL_ID \
337+ --after " 2026-01-25" \
338+ --username " alice" \
339+ --username " bob"
340+
341+ # Filter by topics/keywords
342+ ediscord --channel YOUR_CHANNEL_ID \
343+ --after " 2026-01-25" \
344+ --topic " embabel" \
345+ --topic " agent"
346+
347+ # Combined filters (users AND topics)
348+ ediscord --channel YOUR_CHANNEL_ID \
349+ --after " 2026-01-25" \
350+ --username " alice" \
351+ --topic " embabel"
352+
353+ # Different output formats
354+ ediscord --channel YOUR_CHANNEL_ID \
355+ --after " 2026-01-25" \
356+ --format json # Default, enables summary generation
357+ ediscord --channel YOUR_CHANNEL_ID \
358+ --after " 2026-01-25" \
359+ --format txt # Plain text
360+ ediscord --channel YOUR_CHANNEL_ID \
361+ --after " 2026-01-25" \
362+ --format html # HTML format
363+
364+ # Get help
365+ ediscord --help
366+ ```
367+
368+ ** Finding Your Channel ID:**
369+ 1 . Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode)
370+ 2 . Right-click on the channel
371+ 3 . Select "Copy ID"
372+
373+ ** Output Files:**
374+ - Exports saved to: ` exports/discord/ `
375+ - JSON exports automatically generate summary markdown files with:
376+ - Statistics (message count, unique authors, date range)
377+ - Top contributors
378+ - Recent messages
379+ - Topic analysis
380+ - Media & links count
381+
382+ ** Configuration:**
383+ Set ` DISCORD_TOKEN ` in your ` .env ` file (see [ discord-sync/README.md] ( discord-sync/README.md ) for token setup instructions).
384+
385+ See [ discord-sync/README.md] ( discord-sync/README.md ) for complete documentation.
386+
324387## 🎓 Learning Resources
325388
326389### Documentation
@@ -377,21 +440,18 @@ For exporting and summarizing Discord messages:
377440
378441``` bash
379442# Export messages from a channel
380- ./discord-sync/sync-discord.sh \
381- --channel YOUR_CHANNEL_ID \
443+ ediscord --channel YOUR_CHANNEL_ID \
382444 --after " 2026-01-25" \
383445 --before " 2026-01-26"
384446
385447# Filter by username
386- ./discord-sync/sync-discord.sh \
387- --channel YOUR_CHANNEL_ID \
448+ ediscord --channel YOUR_CHANNEL_ID \
388449 --after " 2026-01-25" \
389450 --username " alice" \
390451 --username " bob"
391452
392453# Filter by topic
393- ./discord-sync/sync-discord.sh \
394- --channel YOUR_CHANNEL_ID \
454+ ediscord --channel YOUR_CHANNEL_ID \
395455 --after " 2026-01-25" \
396456 --topic " embabel" \
397457 --topic " agent"
0 commit comments