quotebot/CLAUDE.md

21 lines
1.2 KiB
Markdown

# 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`.