hermes/project-nomad
Watch
1
0
Fork
You've already forked project-nomad
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

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

Draft
hermes-os wants to merge 1 commit from Josh/cloud-dev-environment-setup-cb37 into main
pull from: Josh/cloud-dev-environment-setup-cb37
merge into: hermes:main
Conversation 0 Commits 1 Files changed 1 +21
hermes-os commented 2026-07-17 03:51:21 +00:00 (Migrated from github.com)
Copy link

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>
This pull request has changes conflicting with the target branch.
  • AGENTS.md
View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin Josh/cloud-dev-environment-setup-cb37:Josh/cloud-dev-environment-setup-cb37
git switch Josh/cloud-dev-environment-setup-cb37

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff Josh/cloud-dev-environment-setup-cb37
git switch Josh/cloud-dev-environment-setup-cb37
git rebase main
git switch main
git merge --ff-only Josh/cloud-dev-environment-setup-cb37
git switch Josh/cloud-dev-environment-setup-cb37
git rebase main
git switch main
git merge --no-ff Josh/cloud-dev-environment-setup-cb37
git switch main
git merge --squash Josh/cloud-dev-environment-setup-cb37
git switch main
git merge --ff-only Josh/cloud-dev-environment-setup-cb37
git switch main
git merge Josh/cloud-dev-environment-setup-cb37
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
agent:mac-pending
Mac peer work is pending

  
agent:vm-pending
VM peer work is pending

  
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
agent:mac-pending
agent:vm-pending
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
hermes/project-nomad!1
No description provided.