docs: Add macOS screen recording permission requirement to record action docs

[promptless]

Open this suggestion in Promptless to view citations and reasoning process

Adds a note to the record action documentation explaining that macOS users need to grant Chrome screen recording permission in System Settings > Privacy & Security > Screen Recording for video recording to work. This addresses the improved error handling in PR #177 which provides clearer feedback when recording fails due to missing permissions.

Trigger Events

doc-detective/doc-detective PR #177: fix: recording on macOS

Promptless Research (1 GitHub PR)

• Reviewed doc-detective/doc-detective#177

Agent Response

I've reviewed PR #177 and created a documentation suggestion to address the macOS screen recording permission requirement.

Summary

PR #177 improves recording functionality on macOS by adding better error handling when screen recording fails. The key user-facing change is that when recording fails on macOS, Doc Detective now provides a clear error message explaining that Chrome needs screen recording permission.

Documentation Update

I created a suggestion that adds a note to the record action documentation explaining the macOS permission requirement:

Note: On macOS, Chrome needs screen recording permission. If recording fails, enable Chrome in System Settings (or System Preferences on older versions) > Privacy & Security > Screen Recording.

This note is placed alongside the existing Chrome-only note at the top of the action documentation, so users see all platform requirements upfront before diving into the examples.

The record-video.mdx tutorial already links to the record action page, so users following that tutorial will discover the macOS requirement when they click through to the reference documentation. This keeps the tutorial focused on the walkthrough while the action documentation serves as the canonical reference for platform requirements.

---

Tip: Request one-off documentation tasks in the Dashboard under New Task 🚀

[promptless]

Citation: Based on the error handling added in src/core/tests/startRecording.ts which now provides a clear error message when recording fails on macOS due to missing screen recording permissions.
View source

[github-actions]

🌿 Preview your docs: https://doc-detective-preview-84df0183-fe29-48d3-aa91-b33e9b9fcff4.docs.buildwithfern.com