TentacleBot - Agent Instructions

Quick Commands

dotnet restore && dotnet run          # Run the bot locally
docker compose up --build -d          # Run with Docker
docker compose logs -f                # View Docker logs

Setup

Set DISCORD_BOT_TOKEN env var (preferred) or edit appsettings.json
Copy .env.example to .env for Docker: cp .env.example .env
appsettings.json is gitignored — never commit it

Architecture

Program.cs — Entry point, DI setup, registers command modules from the assembly
Services/BotService.cs — Core bot lifecycle (login, ready handler, interaction routing)
Commands/GeneralCommands.cs — Slash commands (/general ping, /general hello, /botinfo)

Add new commands by creating a class in Commands/ that extends InteractionModuleBase<SocketInteractionContext>. Commands are auto-discovered via AddModulesAsync(typeof(Program).Assembly).

Gotchas

Two DiscordSocketClient instances are created in Program.cs — one for the bot client and one passed into InteractionService. They are separate instances sharing the same config.
Token priority: DISCORD_BOT_TOKEN env var is checked first, then appsettings.json → Discord:BotToken.

No tests, no lint config

This project has no test framework, no linting, and no CI. dotnet build is the only verification step.

1.4 KiB Raw Blame History