From e96133603bb72b8fb49f4df5d64a6dfb7bf010e8 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 28 May 2026 05:10:34 +0000 Subject: [PATCH] Add Cursor Cloud specific instructions to AGENTS.md Add development environment guidance for cloud agents including: - Demo server startup notes - Build-before-test requirements - Note about no external services needed - tsgo compiler note - Lint optimization tip Co-authored-by: Daniel Imms --- AGENTS.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 0d5d03588..5b07ce824 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -98,3 +98,15 @@ const cell = line?.getCell(0); ## Writing unit tests - Unit tests live alongside the source code file of the thing it's testing with a .test.ts suffix. + +## Cursor Cloud specific instructions + +**Demo server**: Start with `npm start` (port 3000). The demo server uses node-pty to spawn real shell sessions over WebSocket. Integration tests auto-start it via Playwright's `webServer` config, so you don't need to start it manually for `npm run test-integration`. + +**Build before testing**: Always run `npm run build && npm run esbuild` before `npm run test-unit`. Integration tests also need `npm run esbuild-demo-client` and `npm run esbuild-demo-server`. The update script handles this automatically on session start. + +**No external services**: This project has zero external dependencies (no databases, Docker, or APIs). Everything runs locally with Node.js. + +**TypeScript compiler**: The project uses `tsgo` (native TypeScript compiler preview) rather than standard `tsc`. It's installed via the `@typescript/native-preview` package. + +**Lint only changed files**: Prefer `npm run lint-changes` over `npm run lint` when iterating on code changes — it's significantly faster.