Using Cursor

Cursor is a powerful AI-first code editor that natively understands project rules and can interact directly with your codebase.

Setup

Cursor automatically detects .cursorrules files. In this starter, we map these rules directly to the comprehensive AGENTS.md file to maintain a single source of truth. Ensure your Cursor settings are configured to respect project-level AI rules.

Best Practices

• Composer / Ctrl+K: Use Cursor's generation tools to scaffold new features. When doing so, the agent will automatically read AGENTS.md and know to place shared UI in packages/ui and backend logic in packages/backend/convex.
• Referencing Skills: If you want Cursor to use a specific skill (e.g., "Add the Shadcn accordion component"), mention the skill by name. Cursor will read the SKILL.md file in .agents/skills and follow the step-by-step instructions.
• Convex Generation: Cursor is excellent at generating Convex backend code. Because it reads the generated packages/backend/convex/_generated/ai/guidelines.md file, it is highly unlikely to hallucinate outdated Convex APIs.

Troubleshooting

If Cursor seems to ignore the rules (e.g., using npm instead of bun), explicitly mention @AGENTS.md in your prompt to force it to re-read the repository rules before generating the command.