chore: Cloud Agent environment following CONTRIBUTING

[vihar]

Description

Cloud Agent setup for Plane follows the local flow in CONTRIBUTING.md. The image is only the toolchain a Cloud Agent needs (Node 22.22.0 from .node-version, pnpm 11.10.0, Docker with fuse-overlayfs and iptables-legacy). It does not install Plane or boot the app.

• bash .cursor/install.sh is a safe ./setup.sh: copy missing .env files from the examples, add SECRET_KEY only when apps/api/.env does not already have one, and pnpm install --frozen-lockfile. It also pulls and builds the images docker-compose-local.yml needs. Existing env files are left alone, and a second SECRET_KEY is never appended.
• bash .cursor/start.sh runs docker compose -f docker-compose-local.yml up -d and waits until the API is healthy on :8000.
• Frontends stay independent. The frontend terminal runs pnpm dev (web :3000, admin :3001, space :3002, live :3100). The backend terminal follows compose logs for the API, worker, and beat.

When stack.sh lands in the repo, install and start should call that script instead of these compose and pnpm steps. This PR does not add stack.sh.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• Feature (non-breaking change which adds functionality)
• Improvement (change that would cause existing functionality to not work as expected)
• Code refactoring
• Performance improvements
• Documentation update

Screenshots and Media (if applicable)

Test Scenarios

Verified on this Cloud Agent VM after the CONTRIBUTING alignment:

• bash .cursor/install.sh exited 0. Node v22.22.0, pnpm 11.10.0, pnpm install --frozen-lockfile was already up to date, infrastructure images pulled, and the local API image build was cached. Existing .env files were unchanged (same hash before and after) and apps/api/.env still has a single SECRET_KEY line.
• bash .cursor/start.sh ran docker compose -f docker-compose-local.yml up -d and reported ready http://127.0.0.1:8000/api/instances/ (200).
• bash .cursor/run-frontend.sh ran pnpm dev. http://127.0.0.1:3000/ returned HTTP 200. http://127.0.0.1:3001/god-mode/ returned HTTP 200. The admin root returns HTTP 302 and following that redirect returns HTTP 200. Live logged Express server has started at port 3100.

References

Sriram approved aligning this environment with CONTRIBUTING.md on the same branch. Saved Cloud Agent environment: 82b010f6-c02b-11f1-bb68-864e54d14197.

  

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ vihar
❌ cursoragent
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}