From 597c4fb7bcee1339ed052f251aee9fc82b9f4e8d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Wed, 13 May 2026 05:29:09 +0000 Subject: [PATCH] Add AGENTS.md with Cloud Agent development instructions Co-authored-by: Melvin Vivas --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..0fd38f6 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,20 @@ +# AGENTS.md + +## Cursor Cloud specific instructions + +This is an Electron desktop app (Markdown Editor with AI). There are no backend services, databases, or Docker containers. The entire application is a single Electron process. + +### Running the app + +- Install dependencies: `npm install` +- Start the app: `DISPLAY=:1 npm start` (use display `:1` for the Desktop pane, or start Xvfb on `:99` for headless) +- Build for Linux: `npm run build:linux` +- See `README.md` for full build commands (mac/win/linux/all) + +### Key caveats + +- **Display server required**: Electron needs an X11 display. On Cloud Agent VMs, use `DISPLAY=:1` to render on the Desktop pane visible to the computerUse subagent. For headless-only validation, start Xvfb (`Xvfb :99 -screen 0 1280x1024x24 &`) and use `DISPLAY=:99`. +- **DBus errors are non-fatal**: The app logs many `dbus/bus.cc` and `dbus/object_proxy.cc` errors on headless Linux. These are cosmetic and do not affect functionality. +- **No test suite**: The project has no automated tests (`npm test` is not defined). Validation is manual via the GUI. +- **No linter configured**: There is no ESLint or other linter set up in the project. +- **AI features require configuration**: AI text transformations and chat require configuring an OpenAI-compatible API provider in Settings > Plugins. Core markdown editing works without any API keys.