Skip to content

Add display filtering to Snapshot for multi-monitor setups#94

Merged
Jeomon merged 2 commits intoCursorTouch:mainfrom
xqdd:feat/snapshot-display-filter
Mar 9, 2026
Merged

Add display filtering to Snapshot for multi-monitor setups#94
Jeomon merged 2 commits intoCursorTouch:mainfrom
xqdd:feat/snapshot-display-filter

Conversation

@xqdd
Copy link
Contributor

@xqdd xqdd commented Mar 9, 2026

Summary

This PR adds an optional display parameter to Snapshot so callers can limit the returned snapshot to specific monitors, such as display=[0] or display=[0,1].

Changes

  • filter Snapshot screenshot output to the selected display region
  • filter focused and opened windows to the selected display region
  • filter interactive and scrollable elements to the selected display region
  • add metadata describing the selected displays and screenshot region
  • keep the default behavior unchanged when display is omitted

Why this approach

This is a small and low-risk change focused on Snapshot, where multi-monitor ambiguity is most visible to the LLM.

A more complete solution would be to add display support to all tools, but that would require broader coordinate translation changes, introduce more maintenance overhead, and increase complexity for a case that may affect a smaller portion of users.

Benefits

  • improves LLM awareness in multi-monitor scenarios by returning a more coherent view
  • improves screenshot clarity when only one display is needed, since Snapshot output is capped at 1080p and full dual-monitor captures can become blurry

Closes #77

@Jeomon Jeomon merged commit 545022c into CursorTouch:main Mar 9, 2026
@Jeomon
Copy link
Member

Jeomon commented Mar 9, 2026

Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Support specify screen when there are multiple screens

2 participants