Skip to content

Add AGENTS.md with Cursor Cloud environment setup instructions#2

Draft
donvito wants to merge 1 commit into
melvin/add-themes-0faffrom
melvin/cloud-env-setup-1eb7
Draft

Add AGENTS.md with Cursor Cloud environment setup instructions#2
donvito wants to merge 1 commit into
melvin/add-themes-0faffrom
melvin/cloud-env-setup-1eb7

Conversation

@donvito

@donvito donvito commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Summary

Sets up and verifies the development environment for the JSONL Viewer Electron app, and documents non-obvious Cloud-agent run/test caveats in a new AGENTS.md.

  • Adds AGENTS.md with a ## Cursor Cloud specific instructions section covering the headless display requirement (xvfb-run for tests, DISPLAY=:1 for GUI), the mandatory --no-sandbox flag, ignorable environmental stderr noise, and the standalone test commands.
  • Update script for future sessions: npm install.

Verification

  • node test-parse.js — parsing logic, all assertions pass.
  • xvfb-run -a node test-themes.js — headless smoke test loads sample.jsonl, passes.
  • xvfb-run -a ./node_modules/.bin/electron --no-sandbox --disable-gpu test-themes-functional.js — all theme/syntax-highlight tests pass.
  • Ran the real app on DISPLAY=:1 and exercised table view, row preview sidebar, view switch, and theme change.

jsonl_viewer_demo.mp4

Table view
Preview sidebar
Dracula theme

Open in Web Open in Cursor 

Co-authored-by: donvitocodes <donvitocodes@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants