✨ Guild Organizer ✨

Intelligent Discord Organization Powered by AI

---

🚀 Overview

Guild Organizer is a sophisticated CLI tool designed to help you regain control over your Discord server list. It leverages OpenRouter AI to analyze your guilds and suggest a perfectly categorized folder structure, then applies it directly to your account with surgical precision.

🌟 Key Features

• 🧠 AI-Powered Categorization: Automatically groups servers based on their names and purpose using advanced LLMs.
• 🛡️ Dry Run Mode: Preview the suggested organization before applying any changes to your Discord account.
• 🧹 One-Click Revert: Not a fan of the new setup? Use the reset command to instantly clear all folders and start fresh.
• ⚡ Built for Speed: Powered by Bun, ensuring lightning-fast execution and minimal overhead.
• 🎨 Beautiful CLI: Interactive and colorful logging that makes management a breeze.

---

🛠️ Tech Stack

• Runtime: Bun
• Library: discord.js-selfbot-v13
• AI Backend: OpenRouter API
• Languages: TypeScript, JavaScript

---

⚙️ Setup & Installation

1. Prerequisites

Ensure you have Bun installed on your system.

2. Clone & Install

bun install

3. Environment Configuration

Create a .env file in the root directory and add your credentials:

DISCORD_TOKEN="your_self_token"
OPENROUTER_API_KEY="sk-or-v1-..."
APPLY=false

Warning

Self-botting is against Discord's Terms of Service. Use this tool responsibly and at your own risk.

---

📖 Usage Guide

📂 Organize Guilds

Analyze and organize your servers into AI-suggested folders.

Dry Run (Preview):

bun run start

Apply Changes:

# Method 1: Modify .env (Set APPLY=true)
bun run start

# Method 2: Command line override
APPLY=true bun run start

🔄 Reset Organization

Instantly undo all AI-suggested organization and move all servers back into a single flat list.

APPLY=true bun run reset

Note

This command will remove all existing server folders from your account. It is useful if you want to start over or return to Discord's default layout.

---

🎨 Customization

You can fine-tune how the AI categorizes your servers by editing the prompt.txt file.

• Modify Categories: Add or remove specific categories you want the AI to prioritize.
• Set Style: Instruct the AI to use specific naming conventions (e.g., "Always use emojis in folder names").
• Exclusions: Tell the AI to ignore certain types of servers.

---

🧠 How It Works

1. Fetch: The tool connects to your Discord account and retrieves a list of all joined guilds.
2. Analyze: Guild names are sent to OpenRouter AI (Gemini/GPT models) to identify logical groupings (e.g., Gaming, Dev, Community, Crypto).
3. Draft: A folder structure is generated with specific guild mappings.
4. Sync: If APPLY is set to true, the client.settings.edit method is called to synchronize the new structure to your Discord profile.

---

Made by @ee3lol