Set up Cursor Cloud dev environment

[qnbs]

Summary

Sets up and verifies the development environment for WorldScript Studio in the Cursor Cloud VM, and records the durable non-obvious startup caveats for future agents.

The only code/repo change is a new ## Cursor Cloud specific instructions section appended to AGENTS.md. No application code was modified.

Environment setup

• Runtime already present: Node v22.14.0, pnpm 11.5.2 (matches engines + .nvmrc).
• Update script (startup): pnpm install — the predev/prebuild hooks handle i18n bundle rebuild, SW/Tauri version sync, and DuckDB asset copy automatically, so no extra startup steps are needed.

Verification (all green in this VM)

Check	Command	Result
Lint	pnpm run lint	Checked 1662 files, no issues
Typecheck	pnpm run typecheck	Clean (tsgo, 4 checkers)
i18n parity	pnpm run i18n:check	19 locales × 2869 keys OK
Unit tests	pnpm run test:run	6625 passed / 536 files
Build	pnpm run build	Built + PWA service worker generated
Dev server	pnpm run dev	Serves at http://127.0.0.1:3000/WorldScript-Studio/

Hello-world task (core functionality)

Created a new project ("Hello World Saga") from a blank manuscript, typed a sentence into the manuscript editor, and confirmed real-time word-count stats (22 words) and offline auto-save ("All changes saved") plus dashboard persistence.

  

Summary by CodeRabbit

• Documentation
  • Added development environment guidance for the required application base path.
  • Documented available build and test commands, offline operation requirements, and the dedicated workflow for desktop verification.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
worldscript-studio	Ready	Preview	Aug 3, 2026 1:41pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 017189d3-e750-4aef-a6c5-f8ac9589731b

📥 Commits

Reviewing files that changed from the base of the PR and between 804793a and ab7bced.

📒 Files selected for processing (1)

• AGENTS.md

---

📝 Walkthrough

Walkthrough

Updated AGENTS.md with Cursor Cloud setup instructions, supported test and build commands, offline operation requirements, and CI-only Tauri/Rust verification guidance.

Changes

Cursor Cloud guidance

Layer / File(s)	Summary
Document Cursor Cloud workflow AGENTS.md	Documents the required /WorldScript-Studio/ development base path, available test and build commands, offline runtime assumptions, and CI-only Tauri/Rust validation.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the Cursor Cloud development environment setup added by the pull request.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/setup-dev-environment-3c1e

---

_{Comment @coderabbitai help to get the list of available commands.}

[codeant-ai]

🏁 CodeAnt Quality Gate Results

Commit: ab7bced7
Scan Time: 2026-08-03 14:06:21 UTC

✅ Overall Status: PASSED

Quality Gate Details

Quality Gate	Status	Details
Secrets	✅ PASSED	0 secrets found
Duplicate Code	✅ PASSED	0.0% duplicated
SAST	✅ PASSED	No security issues
Bugs	✅ PASSED	Rating S: No bugs
IAC	✅ PASSED	No IAC issues

View Full Results

[deepsource-io]

DeepSource Code Review

We reviewed changes in 804793a...ab7bced on this pull request. Below is the summary for the review, and you can see the individual issues we found as inline review comments.

See full review on DeepSource ↗

PR Report Card

Overall Grade

Security   Reliability   Complexity   Hygiene

Code Review Summary

Analyzer	Status	Updated (UTC)	Details
Docker		Aug 3, 2026 1:40p.m.	Review ↗
JavaScript		Aug 3, 2026 1:40p.m.	Review ↗
Python		Aug 3, 2026 1:40p.m.	Review ↗
Rust		Aug 3, 2026 1:40p.m.	Review ↗
Shell		Aug 3, 2026 1:40p.m.	Review ↗

---

Important

AI Review is run only on demand for your team. We're only showing results of static analysis review right now. To trigger AI Review, comment @deepsourcebot review on this thread.

[cursor]

@coderabbitai review

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!