Contributing to PageAgent

March 28, 2026 · View on GitHub

♥️ We welcome contributions from everyone.

For local development workflows, setup, local LLM config, extension development, testing on other websites, and more details, see docs/developer-guide.md.

🤝 How to Contribute

Maintainer's Note

Opening Issues

  • Use the GitHub issue tracker to report bugs or request features
  • Search existing issues before creating new ones
  • Provide clear reproduction steps for bugs
  • Include browser version and environment details

Code Contributions

  1. Follow existing code style and patterns
  2. Update documentation as needed
  3. Add JSDoc for public APIs
  4. Build and lint everything
  5. Test in our demo website, and on other websites if applicable
  6. Include screenshots for UI changes

Vibe Coding with AI

  • Vibe coding is NOT allowed for the core lib or the extension!!!
  • Vibe coding is RECOMMENDED when maintaining the demo, the website, the UI and tests.
  • Make sure your AI references AGENTS.md and website/AGENTS.md for better quality.
  • Review anything AI wrote before make a commit. You are the author of anything you commit. NOT AI.

🚫 What We Don't Accept

  • Breaking changes and large PRs without prior discussion
  • Heavy dependencies to core libs
  • Dependencies or code with licenses incompatible with MIT
  • Bot or AI-generated pull requests without meaningful human involvement

By contributing to this project, you agree that your contributions will be licensed under the MIT License.

Thank you for helping make PageAgent better! 🎉