Answer: Your project needs migration if any of the listed signals is true, such as depending on `@cursor/july`, setting `architecture: "v1"` or `runtime: "grokbot"`, or if `agent-sdk deployment get ` doesn't print `architecture: v2`. You can also run `agent-sdk migrate`, which checks the source for these signals and prints `Nothing to migrate.` when it finds none, though it doesn't check scripts, CI jobs, or the hosted deployment. Status: Confirmed Entry: tool/cursor/troubleshooting/check-migration-needed Revision: 1 Digest: sha256:b0e02e221f8ee45e (changes whenever the content changes) Timeline: Created: 2026-11-13T03:08:35Z Last changed: 2026-11-13T03:08:35Z Last verified: 2026-11-20T12:33:07Z Next check: 2026-11-21T12:33:07Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of migration check command | agent-sdk migrate | [1] | 2026-11-20 no-migration message | Nothing to migrate. | [1] | 2026-11-20 architecture signal | architecture: "v1" | [1] | 2026-11-20 runtime signal | runtime: "grokbot" | [1] | 2026-11-20 package dependency signal | @cursor/july | [1] | 2026-11-20 deployment check | architecture: v2 | [1] | 2026-11-20 storage file signal | bot/storage.ts | [1] | 2026-11-20 migrate limitations | It doesn't check scripts, CI jobs, or the hosted deployment. | [1] | 2026-11-20 Sources: [1] Anysphere. "cursor.com/docs/agent-sdk/guides/migrate.md". https://cursor.com/docs/agent-sdk/guides/migrate.md Role: primary. Accessed: 2026-11-20T12:33:07Z Quote: "`agent-sdk migrate` checks the source for these signals and prints" (Supports: migration check command) Quote: "`Nothing to migrate.` when it finds none." (Supports: no-migration message) Quote: "The agent sets `architecture: "v1"` or `runtime: "grokbot"`." (Supports: architecture signal, runtime signal) Quote: "`package.json` depends on `@cursor/july`." (Supports: package dependency signal) Quote: "`agent-sdk deployment get ` doesn't print `architecture: v2`." (Supports: deployment check) Quote: "The project has `bot/storage.ts` or `agent/storage.ts`." (Supports: storage file signal) Quote: "It doesn't check scripts, CI jobs, or the hosted deployment." (Supports: migrate limitations) Snapshot SHA-256: abb0914fca6ed6eb91c64dbb328c7fedea56a9312e401ae595a5dfac55d21c10 (captured 2026-11-13T03:08:35Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:08:35Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:33:07Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:33:07Z Last attempt: 2026-11-20T12:33:07Z Notes and limitations: Extracted automatically from a single official source (section "Check whether your project needs migration"). Related: https://latestn.com/tool/cursor/troubleshooting/cli-auth-status How do I check my Cursor CLI authentication status? https://latestn.com/tool/cursor/troubleshooting/cli-not-authenticated-fix How do I fix 'Not authenticated' errors in Cursor CLI? https://latestn.com/tool/cursor/troubleshooting/clonekit-ci-troubleshooting How do I troubleshoot Cursor Origin CloneKit CI errors like 401 or 403? https://latestn.com/tool/cursor/troubleshooting/api-error-responses What are the common error responses from Cursor APIs? https://latestn.com/tool/cursor/troubleshooting/bitbucket-workspace-not-found Why can't Cursor find my Bitbucket workspace or list my Data Center repositories? https://latestn.com/tool/cursor/troubleshooting/bugbot-not-reviewing-azure-devops-prs Why doesn't Bugbot review my Azure DevOps pull requests in Cursor? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:08:35Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/cursor/troubleshooting/check-migration-needed/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/cursor/troubleshooting/check-migration-needed POST: https://latestn.com/dispute/tool/cursor/troubleshooting/check-migration-needed with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/cursor/troubleshooting/check-migration-needed?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I check whether my Cursor Agent SDK project needs migration to architecture v2? Revision 1, last verified 2026-11-20T12:33:07Z. https://latestn.com/tool/cursor/troubleshooting/check-migration-needed (accessed 2026-11-21T09:59:43Z). @misc{LatestN_tool_cursor_troubleshooting_check_migration_needed_r1, title = {How do I check whether my Cursor Agent SDK project needs migration to architecture v2?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/cursor/troubleshooting/check-migration-needed}}, note = {Revision 1; digest sha256:b0e02e221f8ee45e; last verified 2026-11-20T12:33:07Z; accessed 2026-11-21T09:59:43Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/cursor/troubleshooting/check-migration-needed