Skip to content

Add AGENTS.md with Cursor Cloud development environment instructions#4

Draft
ZMXJJ wants to merge 1 commit into
mainfrom
cursor/dev-environment-setup-b04d
Draft

Add AGENTS.md with Cursor Cloud development environment instructions#4
ZMXJJ wants to merge 1 commit into
mainfrom
cursor/dev-environment-setup-b04d

Conversation

@ZMXJJ
Copy link
Copy Markdown
Owner

@ZMXJJ ZMXJJ commented May 12, 2026

Summary

Adds AGENTS.md with development environment setup instructions for Cursor Cloud agents.

What's included

  • Documentation of the three-layer architecture (Tauri Rust shell / React frontend / Python FastAPI sidecar)
  • Service table with dev commands and ports
  • Important development gotchas:
    • Rust edition 2024 requires Rust 1.85+
    • Tauri requires .bundle-resources placeholder directories
    • Headless Linux limitations (no GUI for Tauri desktop shell)
    • TypeScript typecheck must be run from desktop/app/ directory
  • Instructions for lint, typecheck, and Rust compilation

Verification

All services verified working in the Cloud Agent environment:

voca_dev_environment_demo.mp4

Frontend (Vite dev server on port 1420):
Voca frontend running in dev mode

Python Sidecar (FastAPI on port 8765):
Sidecar health endpoint response

API Documentation (Swagger UI):
Swagger API documentation

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

- Document three-layer architecture (Tauri/React/Python sidecar)
- Include dev commands, ports, and important gotchas
- Note Rust edition 2024 requirement and headless Linux limitations
- Add instructions for lint, typecheck, and Rust compilation

Co-authored-by: Dennis Huang <huangsiyuan@modelbest.cn>
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