Thanks for helping! The full contributor guide - setup, architecture, conventions, and security rules - lives in AGENTS.md. The short version:
-
Set up with
uv sync(or Docker / pip - see README). -
Make your change. Keep
backend/app.pya thin API layer; keep SQLite the single source of truth; never load remote resources in the extension. -
Run the test suite and keep it green:
python tests/test_integration.py
-
Never commit API keys,
.env, or thedata/directory. -
Open a PR against
mainwith a short description of what and why.
Security issues: please report privately per SECURITY.md, not as public issues.