Skip to content

Commit 28efa85

Browse files
Development environment setup (#168)
Update `AGENTS.md` with notes on headful image build time and `/process/exec` API schema. These additions clarify non-obvious gotchas encountered during development environment setup, specifically regarding the extended build time for the headful image and the expected schema for the `/process/exec` API endpoint. --- <p><a href="https://cursor.com/agents/bc-e841fee2-2b06-4e49-a95d-e72587e8de73"><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-e841fee2-2b06-4e49-a95d-e72587e8de73"><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;</p> <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Low risk documentation-only change; no runtime code or behavior is modified. > > **Overview** > Updates `AGENTS.md` with two additional development gotchas: how to build the headful Chromium image (including expected long build time and interactive vs detached run behavior), and a clarification of the `/process/exec` request/response schema (`command` as a string, args in `args`, and base64-encoded `stdout_b64`/`stderr_b64`). > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 7a1ba41. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup> <!-- /CURSOR_SUMMARY --> Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Mason Williams <masnwilliams@users.noreply.github.com>
1 parent 5bf9d70 commit 28efa85

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,3 +42,7 @@ The Cloud VM runs inside a Firecracker microVM. Docker requires:
4242
8. **E2e tests** use `testcontainers-go` and require Docker + pre-built images. Set `E2E_CHROMIUM_HEADFUL_IMAGE` and `E2E_CHROMIUM_HEADLESS_IMAGE` env vars to point to the correct image tags.
4343

4444
9. **Go version**: The project requires Go 1.25.0 (per `server/go.mod`). The system Go may be older — ensure `/usr/local/go/bin` is on PATH.
45+
46+
10. **Build headful image**: `cd /workspace && DOCKER_BUILDKIT=1 docker build -f images/chromium-headful/Dockerfile -t kernel-headful-test .` — this takes significantly longer than headless (~10 min) due to Xorg dependencies, Mutter, and the WebRTC client build. The headful `run-docker.sh` runs interactively (`-it`); for background use, run with `-d` instead.
47+
48+
11. **`/process/exec` API schema**: The `command` field is a single string (the binary name), not an array. Arguments go in the separate `args` array field. Response `stdout_b64` / `stderr_b64` are base64-encoded.

0 commit comments

Comments
 (0)