quotebot/CLAUDE.md

Project: quotebot

A simple quotes IRC bot for Libera.Chat (irc.libera.chat), default channel #r.trees. Standard-library Python 3 only — no third-party dependencies. Quotes are stored in a local SQLite DB and managed with in-channel ! commands.

Working agreement

• This is a git repo with origin on Forgejo at https://git.rdx4.com/megaproxy/quotebot.git (private). HTTPS auth uses the token in ~/.git-credentials — pushes are non-interactive.
• Commit after each logical change with a one-line imperative message; git push after each commit (or at minimum before ending the session).
• Read memory.md at session start. Update it before ending the session.
• Never commit secrets — see .gitignore and the rules in ~/claude/CLAUDE.md.

Project-specific notes

• Runtime: Python 3 stdlib only. Run with python3 bot.py. No venv, no pip.
• Config: environment variables (see config.example.env). Defaults target Libera + #r.trees. Real secrets (IRC_NICKSERV_PASS) stay in config.env, which is gitignored — never commit it.
• Data: quotes.db (SQLite) is created on first run and gitignored.
• No tests yet. Syntax check with python3 -m py_compile bot.py.