Skip to content

docs(cursor): add model picker and provider notes for local spawn#3431

Merged
la14-1 merged 1 commit into
cursor-proxy/dev-cli-dirfrom
cursor-proxy/local-docs
May 22, 2026
Merged

docs(cursor): add model picker and provider notes for local spawn#3431
la14-1 merged 1 commit into
cursor-proxy/dev-cli-dirfrom
cursor-proxy/local-docs

Conversation

@aulorbe
Copy link
Copy Markdown
Collaborator

@aulorbe aulorbe commented May 21, 2026

Summary

Add documentation for spawning Cursor CLI locally with the OpenRouter model picker:

  • Note that the Custom model setup option must be selected during spawn cursor local to get the OpenRouter model picker. Without it, Cursor uses its default model.
  • Note that only Cursor IDE-supported providers work when running locally.

Test plan

  • Verify the section renders correctly in the README

Add a section to sh/local/README.md noting that the "Custom model"
setup option must be selected to get the OpenRouter model picker when
spawning Cursor locally, and that only Cursor IDE-supported providers
work (linking to Cursor's supported providers docs).
@la14-1 la14-1 merged commit 5996c06 into cursor-proxy/dev-cli-dir May 22, 2026
2 of 3 checks passed
@la14-1 la14-1 deleted the cursor-proxy/local-docs branch May 22, 2026 00:37
la14-1 pushed a commit that referenced this pull request May 22, 2026
…s used (#3429)

* fix(cli): inject SPAWN_CLI_DIR in dev script so local source is always used

Without SPAWN_CLI_DIR, `bun run dev` downloads the spawn script from
the published CDN release, ignoring any local source changes. This is
especially confusing when developing on a branch with fixes that
haven't been published yet.

Set SPAWN_CLI_DIR to the repo root (via git rev-parse) in the dev
script so the local checkout is always used during development.

* docs(cursor): add model picker and provider notes for local spawn (#3431)

Add a section to sh/local/README.md noting that the "Custom model"
setup option must be selected to get the OpenRouter model picker when
spawning Cursor locally, and that only Cursor IDE-supported providers
work (linking to Cursor's supported providers docs).
la14-1 pushed a commit that referenced this pull request May 22, 2026
…3428)

* fix(cursor-proxy): fix double-wrapped Result hiding setup failures

The error handling in setupCursorProxy and startCursorProxy used
asyncTryCatchIf(isOperationalError, () => wrapSshCall(...)) which
double-wrapped the Result: wrapSshCall returns Err() on failure
(doesn't throw), so asyncTryCatchIf always saw a successful return
and wrapped it in Ok(Err(...)). This meant result.ok was always
true, causing misleading output like "Cursor proxy started" even
when every step failed.

Fix: call wrapSshCall directly and check its returned Result.
Also adds macOS DNS cache flush after /etc/hosts modification and
early-return on deploy/hosts failure with accurate warning messages.

* fix(cli): inject SPAWN_CLI_DIR in dev script so local source is always used (#3429)

* fix(cli): inject SPAWN_CLI_DIR in dev script so local source is always used

Without SPAWN_CLI_DIR, `bun run dev` downloads the spawn script from
the published CDN release, ignoring any local source changes. This is
especially confusing when developing on a branch with fixes that
haven't been published yet.

Set SPAWN_CLI_DIR to the repo root (via git rev-parse) in the dev
script so the local checkout is always used during development.

* docs(cursor): add model picker and provider notes for local spawn (#3431)

Add a section to sh/local/README.md noting that the "Custom model"
setup option must be selected to get the OpenRouter model picker when
spawning Cursor locally, and that only Cursor IDE-supported providers
work (linking to Cursor's supported providers docs).
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.

3 participants