docs: Document configurable GitHub PR comment trigger modes

[promptless]

Open this suggestion in Promptless to view citations and reasoning process

Documents the new configurable GitHub PR comment trigger modes feature on the "Interacting with Promptless PRs" page.

New "Comment trigger modes" section:

• Listen to all comments (default for new orgs): Promptless processes all human PR comments automatically. Users can opt out of specific comments by starting with aside or /aside.
• Require @Promptless mentions (default for existing orgs): Promptless only responds when explicitly tagged.
• Link to Settings → Org Settings where users can change this setting.

Updated feedback sections:

• Individual comments section now explains mode-dependent behavior
• PR reviews section updated to clarify when @Promptless tagging is needed

Trigger Events

Promptless/promptless PR #1984: Configurable GitHub PR comment trigger mode

Promptless Research (1 GitHub PR)

• Reviewed Promptless/promptless#1984

Agent Response

I've completed the documentation updates for the configurable GitHub PR comment trigger mode feature. Here's a summary:

Documentation Changes

1. February 2026 Changelog (Updated existing suggestion)

URL: https://app.gopromptless.ai/change-history/33a1d63b-e3e7-4254-be95-d47f164a766a

Added a new feature entry documenting the configurable GitHub PR comment trigger mode:

• Listen to all comments mode (default for new organizations) with aside//aside opt-out
• Require @Promptless mentions mode (default for existing organizations)
• Where to configure the setting

2. GitHub PR Comments Feature Page (New suggestion)

URL: https://app.gopromptless.ai/change-history/35fd04d7-c254-4b2c-a2b6-4725844eab7a

Updated the "Interacting with Promptless PRs" page (fern/docs/features/github-pr-comments.mdx) with:

• New "Comment trigger modes" section explaining the two modes and the aside//aside opt-out mechanism
• Updated "Individual comments" section to clarify mode-dependent behavior
• Updated "PR reviews" section to explain when @Promptless tagging is needed
• Info callout linking to Settings → Org Settings where users can change this setting

---

Both suggestions include citations pointing to PR #1984 with references to the key implementation files (routes.py, config.py, and OrgSettingsTab.tsx). Following client instructions, I kept the changelog and feature documentation in separate suggestions to make review easier.

---

Tip: Point @Promptless at some of your docs debt and have it clean them up in the background 🧹

[promptless]

Citation: Documents the new configurable GitHub PR comment trigger modes from PR #1984. Key implementation in server/backend/integrations/github/routes.py (implements get_pr_comment_mode(), is_aside_prefix(), and mode-based triggering), server/utils/config.py (defines GitHubPrCommentMode enum with mention_only and listen_all_with_aside values), and promptless-dashboard/src/app/settings/OrgSettingsTab.tsx (UI controls showing the two options and aside//aside opt-out behavior).
View source

[github-actions]

🌿 Preview your docs: https://promptless-preview-3f57dcc4-553e-4988-9cf3-35222a96a7ce.docs.buildwithfern.com