Visualize Discord server permissions, role access, channel visibility, and permission drift in one clean map.
GuildScope is a focused admin utility for server owners who do not want to manually inspect dozens or hundreds of channel permission screens.
- Discord OAuth with
identify+guilds - Shows servers the signed-in user owns or can manage
- Server-side bot token for reading guild roles and channels
- No message-content access
- No member-list scan required for the role simulator
- Role combination simulator
- View Channel and Send Messages results per channel
- Category/channel permission-drift detection
- Red/black Shadorux interface
Create an application in the Discord Developer Portal, add a bot, and add this redirect URI for local development:
http://localhost:3000/api/auth/callback
Copy .env.example to .env.local and fill in:
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=
DISCORD_BOT_TOKEN=
DISCORD_REDIRECT_URI=http://localhost:3000/api/auth/callback
NEXT_PUBLIC_APP_URL=http://localhost:3000The bot invite generated by GuildScope requests zero server permissions. The MVP reads guild structure, roles, channels, and permission overwrites through Discord's API; it does not read messages.
npm install
npm run devThen visit http://localhost:3000 and connect Discord.
GuildScope calculates server permissions from @everyone plus selected roles, then applies channel overwrites in Discord's documented order: @everyone overwrite first, aggregated role denies, then aggregated role allows. Administrator bypass is handled as well.
The current simulator is intentionally role-based. Per-member permission overwrites are not included until a later member-specific simulator is added.
- Full role × channel matrix view
@everyoneaccess warnings- CSV/JSON report export
- Better category grouping
- Saved reports and historical comparisons
- Paid large-server/report features after validating demand
Next.js, React, TypeScript, Discord OAuth2, Discord REST API.
MIT