Skip to content

Interfaces

GHOST communicates through interfaces. Discord is the primary interface for the PoC.

  1. Create a Discord bot at discord.com/developers

  2. Enable Message Content Intent in bot settings

  3. Add the bot to your server with message read/write permissions

  4. Set environment variable: DISCORD_TOKEN=your-bot-token

  5. Configure your user ID in config.toml and DM the bot

    ~/.config/ghost/config.toml
    [discord]
    allowed_user_id = "123456789012345678"
  • Each Discord thread maps to a GHOST session
  • Messages in a thread form a continuous conversation
  • Your GHOST responds with full markdown formatting
  • Tables are rendered as images for readability on mobile
  • /REBOOT — Reset the current session (clear context, start fresh)