<PRs.md/>

Terms

Terms of Service

Effective 15 April 2026

These Terms of Service (“Terms”) govern your access to and use of PRs.md (the “Service”), operated by the PRs.md project. By accessing or using the Service you agree to be bound by these Terms. If you do not agree, do not use the Service.

1. Description of the Service

PRs.md is an open-source tool that helps developers demonstrate their understanding of their own pull requests. It fetches a GitHub pull request diff, generates quiz questions using a large language model (LLM) of your choosing, and issues a verifiable proof badge upon a passing score. The Service runs on the Vercel platform and stores data in a Neon Postgres database.

2. Eligibility

You must be at least 16 years old to use the Service. By using the Service you represent that you meet this requirement and that you have the legal capacity to enter into these Terms.

3. Account registration

Access to the Service requires authentication via GitHub OAuth. You are responsible for maintaining the security of your GitHub account. PRs.md requests the minimum OAuth scopes needed to identify you (read:user and user:email); we do not request access to your repositories or organisations.

You must not use the Service on behalf of a third party without that party's knowledge and consent.

4. API keys and bring-your-own-key (BYOK)

The Service operates on a bring-your-own-key model. To generate quiz questions you must supply a valid API key from a supported LLM provider (currently OpenAI, Anthropic, and Google Gemini). By saving a key you acknowledge that:

  • Keys are encrypted at rest using AES-256-GCM with a per-key initialisation vector and authentication tag. They are decrypted in memory only during active LLM calls and are never logged or transmitted to any party other than the corresponding provider.
  • You are solely responsible for any costs incurred with your LLM provider as a result of using the Service. PRs.md does not subsidise or reimburse these costs.
  • You must not share API keys that belong to another party, or use keys that you are not authorised to use.
  • You should revoke and rotate any key you believe has been compromised, both at the provider level and within the Service.

5. Pull request data

When you submit a GitHub pull request URL, PRs.md fetches the publicly accessible diff via the GitHub API. This diff is sent to your configured LLM provider to generate questions; it is not stored on our servers beyond the duration of the active request. We store the generated questions, your answers, and your score. We do not store raw diffs or source code.

You are responsible for ensuring that you have the right to share the contents of any pull request URL you submit with your chosen LLM provider, in accordance with that provider's terms of service and your own organisation's data policies.

6. Proof pages and badges

Proof pages generated by the Service (at /proof/[id]) are intentionally public. Anyone with the URL can view the questions, your answers, and your score. By completing a challenge you consent to this data being publicly accessible. Do not submit answers containing confidential information.

Proof badges may be embedded in GitHub pull request descriptions, README files, and other public locations. The badge SVG is served by the Service and references the corresponding proof page.

7. Acceptable use

You agree not to:

  • Attempt to circumvent the timed quiz, copy-paste restrictions, or grading mechanism by any automated or manual means, for the purpose of fraudulently obtaining a badge.
  • Submit pull request URLs for private repositories that you do not have authorisation to share with a third-party LLM provider.
  • Use the Service to process, store, or transmit content that is unlawful, harmful, defamatory, or that infringes the intellectual property rights of others.
  • Attempt to disrupt, degrade, or gain unauthorised access to the Service or its underlying infrastructure.
  • Use automated scripts or bots to create challenges or submit answers at scale.

8. Intellectual property

The PRs.md source code is released under the MIT Licence and is available on GitHub. These Terms do not grant you any rights in the PRs.md name, logo, or brand assets beyond what is reasonably necessary to describe your use of the Service.

You retain all rights to any content you submit (pull request URLs, written answers). By submitting answers you grant PRs.md a limited licence to store and display them on the corresponding public proof page.

9. Privacy

PRs.md collects the minimum data needed to operate the Service: your GitHub profile information (username, display name, email, avatar), API keys (encrypted), and challenge records (questions, answers, scores, timestamps). We do not sell this data or share it with third parties except as required to operate the Service (Neon for database hosting, Vercel for compute, and your chosen LLM provider for question generation and grading).

Usage events may be tracked with anonymised analytics (Vercel Analytics, Google Analytics) to understand how the Service is used. No personally identifiable information is included in these events.

10. Disclaimer of warranties

The Service is provided “as is” and “as available” without warranty of any kind, express or implied. We do not warrant that the Service will be uninterrupted, error-free, or free of harmful components, or that generated questions will be accurate, fair, or appropriate for any particular purpose. The grading mechanism is automated and imperfect; a passing score is not a guarantee of genuine code comprehension.

11. Limitation of liability

To the fullest extent permitted by applicable law, PRs.md and its contributors shall not be liable for any indirect, incidental, special, consequential, or punitive damages, including but not limited to loss of profits, data, or goodwill, arising out of or in connection with your use of the Service, even if advised of the possibility of such damages.

Our total liability to you for any claim arising under these Terms shall not exceed the greater of (a) the amount you paid to use the Service in the twelve months preceding the claim, or (b) USD $10.

12. Modifications to the Service and Terms

We reserve the right to modify or discontinue the Service at any time without notice. We may update these Terms from time to time. Material changes will be indicated by a new effective date at the top of this page. Continued use of the Service after changes are posted constitutes your acceptance of the revised Terms.

13. Termination

We may suspend or terminate your access to the Service at our discretion, without notice, for conduct that we believe violates these Terms or is harmful to other users, us, or third parties. You may stop using the Service at any time; to delete your account and associated data, contact us at the address below.

14. Governing law

These Terms are governed by and construed in accordance with the laws of the jurisdiction in which the operator is established, without regard to conflict of law principles. Any disputes shall be resolved in the courts of that jurisdiction.

15. Contact

Questions about these Terms can be directed to legal@prs.md.