Skip to content

realloon/Mona

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LLM Discord Gateway

A minimal Discord agent gateway built with Bun + OpenAI SDK.

Quick Start

bun install
cp mona.config.example.ts mona.config.ts
bun run start

What It Does

  • Replies in Discord channels and DMs
  • Supports slash commands: /clear, /skills
  • Includes built-in local tools: builtin__run, builtin__read, builtin__write, builtin__patch, builtin__search, builtin__load_skill

Discord Setup

  • Invite the bot to your server
  • Enable MESSAGE CONTENT INTENT
  • Grant channel read/write permissions
  • Ensure .mona/memory/MEMORY.md exists

Behavior

  • If discord.requireMention=true, the bot only responds when mentioned
  • If discord.requireMention=false, it responds to regular channel messages
  • In DMs, it responds directly
  • /clear resets conversation context for the current channel

Notes

  • mona.config.ts follows convention-over-configuration: most fields have defaults and can be omitted
  • openai.apiKey and discord.botToken must be provided in mona.config.ts
  • High-risk shell commands require explicit Discord approval by the requester
  • If you see 400 status code (no body), check openai.baseURL and model compatibility

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Contributors