Repository navigation
Description
Blocked by: Capture (deferred in v1; DESIGN.md decision 25). Related: #148, #186, #196 / #249, #237. Sibling of macOS TCC, not a port of it.
Why
macOS sensing consent is two TCC rows: Accessibility (Dock bounds) and Screen Recording (titles, and Capture when it ships). Linux is not that.
X11 window geometry, WM_CLASS, frontmost, idle, and DPMS are consent-free (#186, platform/x11/sensing.rs). There is no Dock SPI that needs an Accessibility grant. consent::live() is Null: never granted, never prompts. #249 omits the macOS TCC section on Linux on purpose. Do not fake those checkboxes.
The first real Linux grant is xdg-desktop-portal ScreenCast (and Screenshot if that is what Capture uses), when either:
- Ambient / On-Demand Capture ships (DESIGN.md §11, deferred in v1), or
- Wayland needs a portal to see other clients' contents or titles. Wayland already degrades spatial geometry (DESIGN.md §3); do not invent an X11-style Accessibility row to paper over that.
Until then, keep Null. Naming the process the portal will list is #237, not this ticket.
What to do
When Capture (or Wayland titles) is in scope:
- A Linux
Probethat talks to xdg-desktop-portal.granted/promptmap onto the portal session, not TCC APIs. Do not addCapabilityId::Accessibilityon Linux. - Settings consumes
form::describe()the same as today. Linux rows are the portal capabilities that actually exist (ScreenCast / Screenshot), with copy that names the portal, not "Privacy & Security". - First run still grants nothing. The prompt fires only when the user flips a row on (decision 9 /
#148). Unchecking stops using the grant; it does not have to revoke the portal session if the desktop has no revoke API — document that, same as macOS "off does not revoke TCC". #237supplies the process name the portal UI will show. This ticket does not re-solve naming.
Out of scope
- Porting macOS Accessibility / Screen Recording labels onto Linux.
- Building Capture itself (pixels, Local Gate, cadence).
- Wayland absolute positioning / overlay (spatial degrade stays DESIGN §3).
- Windows. GTK settings window (
#196/#249). Secret store (#221).
Acceptance
- X11 v1 sensing stays consent-free. No Accessibility row appears on Linux.
- When Capture (or Wayland titles) ships, flipping the Linux settings row prompts xdg-desktop-portal and a grant is required before pixels/titles flow. First run still grants nothing.
-
consent::Nullremains the Linux probe until that grant exists. No fakegranted() -> true. - Hint copy does not say macOS, Accessibility, or Privacy & Security.
Tests
Probe is a trait. Unit-test a fake portal the way macOS tests inject Fake. Do not require a live portal in cargo test.
Metadata
Metadata
Assignees
Labels
Projects
- StatusShow more project fieldsDone
Activity
omesser commentedon Sep 8, 2026
#538 takes the half of this that can be settled without a Linux desktop, and leaves the issue open.
Done there. The Linux settings pane no longer declares the two TCC rows at all. They used to be declared in
form::describe()on every platform and matched back out by an id blacklist in the GTK renderer, so the shared form described a consent model Linux does not have and one renderer's memory of two string constants was all that kept the checkboxes off screen.Nullis unchanged, with a comment saying it is the answer rather than a stub, and a test pins that it grants nothing and prompts for nothing. ADR-0005, ADR-0020, DESIGN.md §9/§11 anddocs/SPEC.mdnow name xdg-desktop-portal as Linux's first grant instead of calling it "the equivalent" of Screen Recording.Not done, and not attempted. The portal
Probeitself. It is conditional on Capture, which is deferred in v1, and there is no way to exercise D-Bus portal code on the machine this was written on or in CI — which is also what "do not require a live portal incargo test" already implies. Writing it now means shipping a session negotiation nobody has run.So three of the four acceptance boxes are ticked; the second one waits for Capture, and this stays open until then.
One thing left on the floor:
SettingsView.consentstill carries both TCC rows on Linux, becauseconsent::CAPABILITIESis not gated. Nothing renders them — the macOS window is the only consumer — so it is inert, but the view model is still TCC-shaped. Worth folding into whichever change brings Linux a real row.— Cursor agent (Coder), on @omesser's behalf.
fix(settings): Stop offering consent rows Linux cannot grant
omesser commentedon Sep 8, 2026
Partial land via #538 (merge
162f6de): Settings no longer offers consent rows Linux cannot grant. Leaving this issue open for remaining Linux sensing/consent work called out in that PR.— Cursor agent (Coder), on @omesser's behalf.
omesser commentedon Sep 17, 2026
Leftover from #538 is done in #829. On Linux,
consent::rows()returns an empty vec, soSettingsView.consentis no longer the Accessibility + Screen Recording catalog. macOS and Windows rows are unchanged.consent::Nullstill grants nothing.Still waiting. xdg-desktop-portal
Probe/ ScreenCast / Screenshot. That stays blocked on Capture (DESIGN.md decision 25). This issue stays open for that. Do not close it from this leftover.— Cursor agent (Coder), on @omesser's behalf.
omesser commentedon Sep 18, 2026
On main via #829 (merge
795f9f4): Linuxconsent::rows()is empty, soSettingsView.consentno longer carries Accessibility / Screen Recording.consent::Nullunchanged.Still open for xdg-desktop-portal Probe / ScreenCast / Screenshot (blocked on Capture, DESIGN.md decision 25).
— Cursor agent (Coder), on @omesser's behalf.
omesser commentedon Sep 18, 2026
Landed on main. #829 merged (
795f9f4). The #538 view-model leftover is done: Linuxconsent::rows()is empty, soSettingsView.consentis no longer TCC-shaped.consent::Nullunchanged.Still waiting. xdg-desktop-portal Probe / ScreenCast / Screenshot — blocked on Capture (DESIGN.md decision 25). This issue stays open for that.
— Cursor agent (Coder), on @omesser's behalf.
Implement Linux portal consent for ScreenCast and Screenshot
omesser commentedon Sep 22, 2026
Capture drop landed as research on main via #878 (
docs/research/capture-drop-and-harness-cu-path.md).Architect decision (2026-09-22): DROP pixel Capture (Ambient and On-Demand); KEEP Free sensing. Agent computer use is outside ai-buddy (harness-native or MCP; cua-driver primary).
What that means for this issue
Leaving open while #874 is open. Do not close from #878 alone.
— Cursor agent (Coder), on @omesser's behalf.
omesser commentedon Sep 22, 2026
Correction on the follow-up links above: use Architect's tickets from the same merge hygiene pass — #881 (ADR-0005), #883 (scrub copy), #882 (cua-driver user docs). The parallel #880 / #884 / #885 were closed as duplicates.
— Cursor agent (Coder), on @omesser's behalf.
omesser commentedon Sep 22, 2026
Shipped on main via #874 (merge
4f579f5).Linux sensing consent is xdg-desktop-portal ScreenCast for Wayland window titles (not TCC, not Capture):
LinuxPortalProbe viaashpd(create session → select sources → start; no frames kept)Screen Cast) behindCapabilityId::WindowTitles/use_window_titlesFollow-up consumer for titles behind
usable(WindowTitles): #886.— Cursor agent (Coder), on @omesser's behalf.