Skip to content

Commit bf1dabb

Browse files
committed
Resolve merge conflicts: use ediscord alias and detailed usage from master
- Accept master version with ediscord alias - Keep detailed usage examples section - Resolve all merge conflicts
2 parents ec3dcf4 + b72de95 commit bf1dabb

2 files changed

Lines changed: 76 additions & 14 deletions

File tree

README.md

Lines changed: 74 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -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
321319
git 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"

scripts/setup-aliases.sh

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@ alias epush='$SCRIPT_DIR/safe-push.sh'
8383
alias ereset='$SCRIPT_DIR/reset-to-upstream.sh'
8484
alias elearn='cd $LEARNING_DIR'
8585
alias eworkspace='$SCRIPT_DIR/open-workspace.sh'
86+
alias ediscord='$LEARNING_DIR/discord-sync/sync-discord.sh'
8687
${REPO_ALIASES}
8788
# Git shortcuts
8889
alias gst='git status'
@@ -124,6 +125,7 @@ echo " epush - Safe push with GitGuardian & pre-commit checks"
124125
echo " ereset - Reset fork to match upstream (discards local changes)"
125126
echo " elearn - cd to learning workspace"
126127
echo " eworkspace - Open multi-repo workspace in Cursor"
128+
echo " ediscord - Sync and summarize Discord messages (use --help for options)"
127129
if [ -n "$MONITOR_REPOS" ]; then
128130
echo " Repo aliases:"
129131
for repo in $MONITOR_REPOS; do

0 commit comments

Comments
 (0)