Allow external processes to open an empty chat in the Agents window scoped to a chosen workspace (parity with the regular IDE)

Feature request for product/service

Cursor IDE

Describe the request

cursor and cursor --new-window reliably open a workbench bound to a chosen folder or .code-workspace file. The Agents window has no equivalent — there’s no public way to open a new chat there scoped to a specific workspace.

I want a CLI flag or deep link that:

  • Targets the Agents window.
  • Opens a new empty chat with a chosen workspace already selected.
  • Optionally pre-fills a prompt and mode (plan / ask).

For example:

  • cursor agents new-chat --workspace /path/to/repo
  • cursor agents new-chat --workspace /path/to/repo --prompt “/my-slash-command” --mode plan
  • cursor://anysphere.cursor-deeplink/agents/new-chat?workspace=/path/to/repo
  • cursor://anysphere.cursor-deeplink/agents/new-chat?workspace=/path/to/repo&text=/my-slash-command&mode=plan

Why:
I’m building a tool that prepares a per-ticket worktree (clone, branch, .code-workspace, .cursor/rules) and wants to drop the user straight into the Agents window with that worktree selected. Today they have to open the Agents window, click +, and pick the workspace from the picker — which negates the automation.

What I tried:
cursor / cursor --new-window — opens a workbench, not the Agents window.
cursor://anysphere.cursor-deeplink/prompt?text=… — no workspace param; lands in the focused window.
agent --workspace — terminal CLI session, not the Agents window UI.
cursor --glass --new-window — --glass is dev-only and ignores the path.

Acceptance:

  • Works whether Cursor is already running or not.
  • Accepts a folder path or a .code-workspace file.
  • Optional prompt, mode, model.

Operating System (if it applies)

MacOS