WIP: chore: add Cursor Cloud dev environment instructions #1

Closed
hermes-os wants to merge 1 commit from Josh/cloud-dev-environment-setup-cb37 into main
hermes-os commented 2026-07-17 03:51:21 +00:00 (Migrated from github.com)

Summary

Sets up the Cursor Cloud development environment for Project N.O.M.A.D. and documents durable startup instructions for future cloud agents in a new AGENTS.md.

This PR only adds AGENTS.md — no application code is modified. System dependencies (Docker, MySQL, Redis) and npm deps were installed/verified during the setup session; the recurring update script is just npm ci --prefix admin.

What was set up

  • Installed the admin app npm dependencies (Node 22).
  • Installed Docker (engine 29 with fuse-overlayfs + containerd snapshotter disabled) — the app's core function is orchestrating tool containers via /var/run/docker.sock.
  • Ran MySQL 8 (nomad_mysql) and Redis 7 (nomad_redis) as Docker containers on 3306/6379.
  • Created admin/.env (with the required URL var missing from .env.example, and a generated APP_KEY), ran migrations + seed.
  • Started the dev server (npm run dev, :8080) and queue workers (npm run work:all).

Verification / testing

  • npm run typecheck — clean
  • npm run build — clean
  • ⚠️ npm run lint — runs, but reports pre-existing prettier/prettier formatting errors on main (not introduced here)
  • node ace test — runs (no test specs exist → "NO TESTS EXECUTED")
  • GET /api/health → 200
  • End-to-end hello-world through the UI: installed the Data Tools app (CyberChef) via the Command Center Apps page (exercising the core Docker orchestration), opened it on :8100, and Base64-encoded "Hello NOMAD" → SGVsbG8gTk9NQUQ=.

nomad_install_data_tools_and_cyberchef_demo.mp4

Command Center dashboard
Data Tools installed and running
CyberChef Base64 result

Open in Web Open in Cursor 
<!-- CURSOR_AGENT_PR_BODY_BEGIN --> ## Summary Sets up the Cursor Cloud development environment for Project N.O.M.A.D. and documents durable startup instructions for future cloud agents in a new `AGENTS.md`. This PR only adds `AGENTS.md` — no application code is modified. System dependencies (Docker, MySQL, Redis) and npm deps were installed/verified during the setup session; the recurring update script is just `npm ci --prefix admin`. ## What was set up - Installed the admin app npm dependencies (Node 22). - Installed Docker (engine 29 with `fuse-overlayfs` + containerd snapshotter disabled) — the app's core function is orchestrating tool containers via `/var/run/docker.sock`. - Ran MySQL 8 (`nomad_mysql`) and Redis 7 (`nomad_redis`) as Docker containers on 3306/6379. - Created `admin/.env` (with the required `URL` var missing from `.env.example`, and a generated `APP_KEY`), ran migrations + seed. - Started the dev server (`npm run dev`, :8080) and queue workers (`npm run work:all`). ## Verification / testing - ✅ `npm run typecheck` — clean - ✅ `npm run build` — clean - ⚠️ `npm run lint` — runs, but reports pre-existing `prettier/prettier` formatting errors on `main` (not introduced here) - ✅ `node ace test` — runs (no test specs exist → "NO TESTS EXECUTED") - ✅ `GET /api/health` → 200 - ✅ End-to-end hello-world through the UI: installed the **Data Tools** app (CyberChef) via the Command Center Apps page (exercising the core Docker orchestration), opened it on :8100, and Base64-encoded "Hello NOMAD" → `SGVsbG8gTk9NQUQ=`. <a href="https://cursor.com/agents/bc-3d7547dd-535d-4855-9ab7-c0f45e1dcb37/artifacts?path=%2Fopt%2Fcursor%2Fartifacts%2Fnomad_install_data_tools_and_cyberchef_demo.mp4"><img src="https://cursor.com/artifacts/c/art-381de91c-b31f-4300-a8c8-b909296dd148" alt="nomad_install_data_tools_and_cyberchef_demo.mp4" /></a> ![Command Center dashboard](https://cursor.com/artifacts/c/art-8ffedb42-0cef-4b93-9ef3-b88147280800) ![Data Tools installed and running](https://cursor.com/artifacts/c/art-42c86ce4-e614-40fc-81bc-559f308e4584) ![CyberChef Base64 result](https://cursor.com/artifacts/c/art-da50b474-1e0d-4094-8bfb-68b132fa2d97) <!-- CURSOR_AGENT_PR_BODY_END --> <div><a href="https://cursor.com/agents/bc-3d7547dd-535d-4855-9ab7-c0f45e1dcb37"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a href="https://cursor.com/background-agent?bcId=bc-3d7547dd-535d-4855-9ab7-c0f45e1dcb37"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div>
hermes force-pushed Josh/cloud-dev-environment-setup-cb37 from 3d47511975 to 9eeca80885 2026-08-05 16:01:53 +00:00 Compare
Owner

Closing as stale during the one-time triage of pull requests that predate the handoff system: this WIP cloud dev environment branch has seen no activity and is superseded by the current repository setup. Reopen if it is still wanted.

Closing as stale during the one-time triage of pull requests that predate the handoff system: this WIP cloud dev environment branch has seen no activity and is superseded by the current repository setup. Reopen if it is still wanted.
hermes closed this pull request 2026-08-08 20:59:28 +00:00
Owner

Closing as superseded: the Cursor Cloud guidance here is stale (the missing URL in .env.example and the absent test specs were both fixed by the merged PRs 2 and 3; the suite now passes 16 tests).

Closing as superseded: the Cursor Cloud guidance here is stale (the missing URL in .env.example and the absent test specs were both fixed by the merged PRs 2 and 3; the suite now passes 16 tests).
Owner

Closing as superseded: the AGENTS.md guidance here is stale — the missing URL entry in .env.example and the absent test specs it describes were both fixed by the merged PRs #2 and #3, and the suite now passes 16 tests. The branch is also unmergeable at 9eeca80. Nothing here is still wanted.

Closing as superseded: the AGENTS.md guidance here is stale — the missing URL entry in .env.example and the absent test specs it describes were both fixed by the merged PRs #2 and #3, and the suite now passes 16 tests. The branch is also unmergeable at 9eeca80. Nothing here is still wanted.

Pull request closed

Sign in to join this conversation.
No description provided.