Skip to main content
We welcome contributions to PromptGuard’s open-source projects. This page explains where and how to contribute.

Open-source repositories

PromptGuard maintains several public repositories. These are the best places to contribute code, report bugs, or suggest improvements.
RepositoryLanguageWhat it is
promptguard-pythonPythonPython SDK (promptguard-sdk on PyPI)
promptguard-nodeTypeScriptNode.js SDK (promptguard-sdk on npm)
promptguard-cliRustCLI tool and MCP server
promptguard-vscodeTypeScriptVS Code extension
promptguard-cursorMarkdownCursor plugin (rules and skills)
Each repository has its own CONTRIBUTING.md with setup, testing, and PR guidelines specific to that project.

How to contribute

Report a bug or request a feature

Open an issue on the relevant repository above. Include:
  • What you expected vs what happened
  • Steps to reproduce
  • Your environment (OS, language version, SDK version)

Submit a pull request

  1. Fork the repository
  2. Create a feature branch from main
  3. Follow the CONTRIBUTING.md in that repository for setup and testing
  4. Submit a PR with a clear description of the change

Improve documentation

If you find an error or gap in these docs, open an issue on any of the repositories above or email docs@promptguard.co. We review all suggestions and update docs regularly.

Documentation structure

These docs follow the Diataxis framework:
TypePurposeExample
TutorialStep-by-step learning experienceTutorial
GuideHow to accomplish a specific taskNode.js Guide
ReferenceFactual description of an API or toolAPI Reference
ExplanationWhy something works the way it doesThreat Detection

Writing conventions

When suggesting documentation improvements, follow these conventions:
  • Use second person (“you”, not “we” or “the user”)
  • Use active voice (“Configure the SDK” not “The SDK can be configured”)
  • Lead with the action (“Run npm install” not “You should run npm install”)
  • Keep paragraphs short (3-4 sentences max)
  • Always specify code block language: ```python, ```javascript, ```bash
  • Include both Python and Node.js examples when showing SDK usage

Questions?