Skip to content

NindroidA/cogworks-bot

Repository files navigation

Cogworks Bot

All-in-one Discord server management. Tickets, applications, XP, reaction roles, events, starboard, and more — with per-server data isolation.

Version Discord.js TypeScript Bun License Lines of Code

HomeDashboardDiscordCommandsAdmin Guide

Get Started

/bot-setup

Auto-detects your server's config, walks you through the rest, and creates channels matching your naming style.

Features

Tickets — Custom types, workflow tracking, SLA, smart routing, auto-close, email import, forum archive

Applications — Position-based forms, review pipeline, workflow statuses, forum archive

XP & Levels — Message/voice XP, rank cards, leaderboard, role rewards, channel multipliers

Reaction Roles — Emoji-to-role menus with normal, unique, and lock modes

Announcements — Rich embed templates with placeholders, preview, auto-publish

Memory — Forum-based tracker for bugs, features, suggestions with custom tags

Bait Channel — Anti-bot detection with scoring, keywords, join velocity, graduated actions

Events — Scheduled events, templates, automated reminders, RSVP tracking

Starboard — Auto-highlight top messages, configurable threshold, random command

Onboarding — Multi-step welcome flows, role assignment, completion tracking

Rules — Reaction-based acknowledgment with automatic role assignment

Insights — Activity snapshots, growth trends, channel heatmaps, digest reports

Plus: AutoMod integration, context menus, outage status, role management, MEE6 import, data export, health monitoring, web dashboard, and GDPR-compliant auto-cleanup.

Tech Stack

Component Technology
Language TypeScript 5.9
Runtime Bun (Node.js compatible)
Framework Discord.js v14
Database MySQL + TypeORM
Deployment Docker
Linting Biome
Testing Jest + ts-jest
Monitoring Structured logging + HTTP health endpoints

Codebase Health

Desloppify Codebase Health Scorecard

Docs

Commands Full command reference
Admin Guide Setup and configuration
Privacy Policy Data handling
Terms of Service Usage terms

License

PolyForm Noncommercial 1.0.0

Support

DiscordIssues/coffee in Discord

About

A modular Discord server management bot -- tickets, applications, reaction roles, announcements, anti-bot detection, and more! Built with TypeScript, Discord.js, and Bun.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages