← The ShowroomAgent infrastructure

Writeup only

Claude-in-Discord Agent

A private AI helper for a personal Discord server that remembers things in plain files.

Status
Working
Built with
Python, discord.py, headless Claude Code, cron
Last worked on
2026-10

What it is

This is a pattern for a personal AI helper that lives in a private Discord server. You message the bot as you would a friend. A small relay script passes the message to Claude running without a screen, which reads and updates a folder of Markdown files as its memory, then posts the reply back to Discord. Scheduled jobs send check-ins at set times. Three versions run today: a fitness and nutrition coach used daily, a business-partner bot, and an accountability coach that works through a ticket list.

How it works

  1. Send the bot a message in Discord, such as a workout, a meal photo or a question.
  2. The relay hands it to Claude along with that bot's instructions.
  3. Claude reads and updates its memory files and replies.
  4. The files are saved to version history after every exchange.
  5. Morning, evening and weekly check-ins arrive on a schedule.
  6. For the fitness coach, a small web dashboard shows and edits the same files.

What exists today

What isn't there yet

Under the hood