docs: add Cursor Cloud Linux dev environment notes to AGENTS.md

[arul28]

Adds practical notes to the "Cursor Cloud specific instructions" section of AGENTS.md based on environment setup and testing:

• test:unit script uses --project unit which vitest 0.34.6 doesn't support; documents the workaround
• The active X display in Cursor Cloud VM is :1, not :99
• Documents fast launch commands (--skip-runtime-build, --attach) for desktop and TUI

Evidence of working environment

Full demo: Codex GPT-5.5 chat with auto-create lane, then lane deletion
ade_full_demo_chat_lanes_delete.mp4

Codex GPT-5.5 response to test message:
Codex GPT-5.5 response

Lanes tab showing auto-created lane:
Lanes tab with auto-created lane

Lane successfully deleted:
Lane deleted successfully

_{To show artifacts inline, enable in settings.}

  

Greptile Summary

This PR adds four bullet points to the "Running the Electron desktop app on Linux" section of AGENTS.md, documenting practical Cursor Cloud VM gotchas: a broken test:unit script workaround, the correct DISPLAY=:1 value, and fast-launch flags for the desktop and TUI dev scripts.

• Documents that npm --prefix apps/desktop run test:unit is broken under vitest 0.34.6 and provides the correct workarounds (npx vitest run <file> or npm run test).
• Notes DISPLAY=:1 for Electron on the Cursor Cloud VM and documents --skip-runtime-build / --attach flags for dev:desktop and dev:code (both flags are confirmed valid in their respective scripts).

Confidence Score: 4/5

Documentation-only change; the new notes are accurate but one existing line directly contradicts the new test:unit warning.

The four new bullets are factually correct and the --skip-runtime-build/--attach flags exist in both dev scripts. However, line 84 still recommends npm --prefix apps/desktop run test:unit as the canonical targeted-test example, while line 114 (added in this PR) documents that the exact same command is broken. A developer following the overview section will hit the broken command without realising a workaround exists two sections later.

AGENTS.md — the existing line 84 example should be updated to match the workaround described in the new line 114.

Important Files Changed

Filename	Overview
AGENTS.md	Adds four Cursor Cloud Linux dev environment notes; introduces a direct contradiction with the existing test:unit recommendation in the Environment overview section

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Developer on Cursor Cloud Linux VM] --> B{What to run?}
    B --> C[Unit tests]
    B --> D[Desktop dev app]
    B --> E[TUI / ade-code]

    C --> C1["❌ npm run test:unit\n(--project unit unsupported\nin vitest 0.34.6)"]
    C --> C2["✅ npx vitest run <file>\n(inside apps/desktop)"]
    C --> C3["✅ npm run test\n(full suite)"]

    D --> D1{CLI already built?}
    D1 -- No --> D2["npm run dev:desktop\n(builds CLI first)"]
    D1 -- Yes --> D3["npm run dev:desktop --\n--skip-runtime-build\n(fast path)"]
    D2 --> D4["Set DISPLAY=:1\nbefore launching Electron"]
    D3 --> D4

    E --> E1{Runtime already running?}
    E1 -- No --> E2["npm run dev:code --\n--skip-runtime-build --auto\n(starts runtime)"]
    E1 -- Yes --> E3["npm run dev:code --\n--skip-runtime-build --attach\n--project-root p --workspace-root w"]

Loading

Comments Outside Diff (1)

1. AGENTS.md, line 84 (link)

   The example command is the same one documented as broken three lines below (line 114). Use the working alternative so the two notes are consistent.

   Prompt To Fix With AI

   This is a comment left during a code review.
   Path: AGENTS.md
   Line: 84
   
   Comment:
   The example command is the same one documented as broken three lines below (line 114). Use the working alternative so the two notes are consistent.
   
   
   
   How can I resolve this? If you propose a fix, please make it concise.

   

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
AGENTS.md:84
The example command is the same one documented as broken three lines below (line 114). Use the working alternative so the two notes are consistent.

```suggestion
- The desktop test suite (265 test files) is large; CI shards it. For local iteration, run targeted tests (e.g. `npx vitest run <specific-test-file>` inside `apps/desktop`) or `npm --prefix apps/desktop run test` for the full suite.
```

_{Reviews (1): Last reviewed commit: "docs: add Cursor Cloud Linux dev environ..." | Re-trigger Greptile}

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
ade	Ignored		May 14, 2026 8:22pm

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (1)

• AGENTS.md is excluded by !*.md

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e15680a4-5b2e-422c-9d10-221a4438230e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/env-setup-agents-md-ce7c

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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