Improving first-run Accessibility permission diagnostics and recovery for the `personal-model` daemon on macOS, specifically clarifying the owning process and necessary user actions when capture fails due to permission issues.
Raw Developer Origin & Technical Request
GitHub Issue
Jul 10, 2026
## Problem
A daemon can be healthy while producing no useful captures when Accessibility permission was granted to the wrong launcher, changed after a launchd handoff, or has not taken effect yet. `persome doctor` provides checks, but first-run recovery should make the exact owning process and next action unmistakable.
## Scope
Improve owner-local diagnostics and recovery for terminal-launched and LaunchAgent-owned daemons. Do not add telemetry or automate System Settings clicks.
## Acceptance criteria
- Status distinguishes permission missing, no recent capture, paused capture, and an unhealthy watcher.
- Output identifies whether the terminal or LaunchAgent path currently owns capture.
- Recovery instructions explain when a restart is required and when it is not.
- The local status API exposes a stable machine-readable reason code.
- Unit tests cover each reason without requiring real macOS permission.
- At least one `macos` test documents the live manual verification path.
- README/operations/troubleshooting remain consistent with the implementation.
## Privacy boundary
Diagnostics must not print captured text, window titles, URLs, or provider keys.
Developer Debate & Comments
No active discussions extracted for this entry yet.
Adjacent Repository Pain Points
Other highly discussed features and pain points extracted from Intuition-Lab/personal-model.
Frequently Asked Questions
Market intelligence mapped to Improving first-run Accessibility permission diagnostics and recovery for the `personal-model` daemon on macOS, specifically clarifying the owning process and necessary user actions when capture fails due to permission issues..
What problem does Improving first-run Accessibility permission diagnostics and recovery for the `personal-model` daemon on macOS, specifically clarifying the owning process and necessary user actions when capture fails due to permission issues. solve?
What architecture is tied to Improving first-run Accessibility permission diagnostics and recovery for the `personal-model` daemon on macOS, specifically clarifying the owning process and necessary user actions when capture fails due to permission issues.?
Engagement Signals
Cross-Market Term Frequency
Quantifies the cross-market adoption of foundational terms like daemon and persome doctor by tracking occurrence frequency across active SaaS architectures and enterprise developer debates.
SaaS Metrics