Skip to content

docs: add Cursor Cloud setup instructions to AGENTS.md #26

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
jsolly wants to merge 1 commit into from
Closed

docs: add Cursor Cloud setup instructions to AGENTS.md #26

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,3 +41,12 @@ No auth — public UI only. Follow `rules/frontend-verification.md` (fleet smoke

- **Dev server:** `astro dev --background` (manage with `astro dev status` / `astro dev logs` / `astro dev stop`). Default local URL is the Astro dev host printed on start (typically <http://localhost:4321>).
- **Auth:** none — public pages only. No `DEFAULT_USER` / `DEFAULT_PASSWORD`.

## Cursor Cloud specific instructions

Pure static Astro + Svelte SPA (no backend/DB/auth); all state is client-side `localStorage`. Standard commands live in `README.md` (`npm run dev` / `check` / `build` / `preview`).

- **Node version:** the repo pins Node `24.x`, but the cloud VM's default `node` on `PATH` (`/exec-daemon/node`) is Node 22. Node 24 (via `nvm`) is prepended to `PATH` in `~/.bashrc` during setup, so new shells get Node 24 automatically. Commands work under either version, but prefer Node 24 to match the pin.
- **Dev server:** the `astro dev --background` helper referenced above is a local `dotagents` tool that is **not** present in cloud — use `npm run dev` (serves <http://localhost:4321>) and background it yourself (e.g. tmux).
- **Committing:** `npm ci`'s `prepare` script sets `core.hooksPath` to `.git-hooks`, and `.git-hooks/pre-commit` sources `~/code/dotagents/gate/gate-lib.sh`, which does not exist in cloud, so normal commits fail. Commit with `git commit --no-verify` in this environment.
- **Verify without committing:** run the gate steps directly — `npm run check` (types), `npm run build`, and `npm run check:actions` (actionlint+shellcheck; downloads the shellcheck binary on first run).