docs: plan Linux support implementation - #711
Conversation
Greptile SummaryThis PR adds a proposed, phased plan for delivering Linux support while keeping the initial release boundary explicit: Ubuntu 24.04 x86_64 with an X11 session. It preserves existing macOS and Windows behavior as a requirement, defers native Wayland support to separate compositor-specific qualification, and defines security, transport, input, lifecycle, packaging, and release evidence needed before Linux is enabled. The documentation check confirmed that all 19 repository-relative links resolve, the declared Confidence Score: 5/5Safe to merge: this change adds planning documentation only and does not alter shipped application behavior. The documentation contract check passed: all repository-relative references resolve at the current revision, and the stated baseline, version, and documentation-only scope match the repository state. Files Needing Attention: No files need corrective changes. Future implementation work should use docs/linux-support-plan.md as the release and validation checklist.
What T-Rex did
Reviews (1): Last reviewed commit: "docs: plan Linux support implementation ..." | Re-trigger Greptile |
Linux is represented in capabilities but lacks a native runtime and cursor-overlay backend. This adds an ordered implementation plan covering BlueZ peripheral interoperability, secure sessions, X11 input, desktop integration, packaging and updates, and a separate Wayland qualification milestone.
The plan defines support boundaries, source references, acceptance criteria, hardware and regression testing, and unresolved backend decisions. This PR delivers documentation only; implementation will use follow-up issues.
Closes #710.
Validation:
git diff --checkpassed and all 19 local documentation links resolve. Independent source review of headee8074b4370f113455503d525509bb20a22d92f6found no actionable substantive issues. All CI checks passed: frontend, dependency audit, Windows/macOS native tests and packaging, and CodeQL. Greptile review also passed. No Linux runtime or hardware validation was performed for this documentation-only change.