docs: add root AGENTS.md with Cursor Cloud dev environment instructions - #181
Closed
SSC-STUDIO wants to merge 1 commit into
Closed
docs: add root AGENTS.md with Cursor Cloud dev environment instructions#181SSC-STUDIO wants to merge 1 commit into
SSC-STUDIO wants to merge 1 commit into
Conversation
Co-authored-by: Chen Runsen <SSC-STUDIO@users.noreply.github.com>
7 tasks
Owner
Author
|
Skipping: root AGENTS.md is gitignored and already holds the full project rules. The Cloud-only Linux notes are also outdated now that #185 ships a real Linux Host. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sets up the Cloud dev environment for Universal Device Toolkit on Linux and documents the durable, non-obvious caveats for future Cloud agents in a new root
AGENTS.md.The VM tooling itself (.NET 10 SDK, Node via nvm, Electron deps) is provisioned through the environment update script/snapshot — this PR only adds the durable operating guide. Root
AGENTS.mdis force-added because it matches the repo'sAGENTS.mdgitignore rule, following the same pattern already used for the trackedPlugins/AGENTS.md.What was set up / verified
~/.dotnet) — installed the cross-platform toolchain.udtCLI (the runnable Linux app) — builds and runsstatus,hardware,telemetry,power,profile,plugins,controls,support,doctor,jsonagainst real host telemetry.CrossPlatform.Tests: 175/175 passed (Debug + Release build clean).npm ci, dev server builds, and the Electron window launches (DISPLAY=:1).npm test: 192/195 passed.Pre-existing issues found at this commit (not caused by setup, not fixed here)
npm run typecheckand the renderer fail on missing source modulesstores/featuresStoreandhooks/useFeature(imported bydashboard-paritycomponents). This blocks the Dashboard from rendering undernpm run dev.Host/Rpc/Handlers/GameBoostHandlers.csreferencesGameBoost*/GameDetectiontypes absent from theUDTWindows=falseLibbuild).npm run lintreportsno-undeffor Node globals in test files; 3 Electron tests fail (React is not definedin two plugin renderer tests + one order-dependent notification test).Notes
Host/ official plugins remain Windows-only; only the cross-platform surface builds on Linux (matches.github/workflows/linux.yml).AGENTS.mddocuments the key Node-version gotcha: the base imagenode(/exec-daemon/nodev22.14) is too old for the Electronnode --testrunner, so interactive shells prefer the nvm-managed Node (v22.22) via~/.bashrc.