Browser tools constrained to IDE viewport

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

The default browser tools operate on a webview constrained to the Cursor workspace. From my screenshot, you can see I’m trying to debug a desktop view, but the tool is only able to take mobile width screenshots because of my window size.

Steps to Reproduce

  • open editor view
  • open sidebar and AI pane
  • prompt “visually inspect ”
  • observe a narrow browser tab is opened
  • observe tool screenshot results from narrow browser

Expected Behavior

The screenshot should not be constrained to the IDE workspace size. There should be a sensible default, and the user should be able to prompt for different screen sizes. Even better if this happens headlessly.

Screenshots / Screen Recordings

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.1.42
VSCode Version: 1.105.1
Commit: 2e353c5f5b30150ff7b874dee5a87660693d9de0
Date: 2025-12-01T02:18:26.377Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 24.6.0

For AI issues: which model did you use?

Opus 4.5

Does this stop you from using Cursor

No - Cursor works, but with this issue

Hey, thanks for the report.

Right now, the built-in browser is indeed constrained by the IDE panel width, so screenshots come out narrow.

Workarounds:

  • Open the browser in a separate window or in Chrome for full-screen viewing to remove the width limit: Browser | Cursor Docs
  • Temporarily hide the explore/AI side panels and expand the browser pane

Setting a custom viewport from the prompt and headless screenshots aren’t documented at the moment - I’ll pass this as a feature request.

Let me know if either workaround helps.

Thanks Dean! I’ll use the workarounds for now.

It’s a great feature, looking forward to improvements. Ideally I could point the agent at my Tailwind config that defines breakpoints. Much of my time in Cursor is spent prompting the agent to verify changes so any improvements here are greatly appreciated!

This topic was automatically closed 22 days after the last reply. New replies are no longer allowed.