Getting Started with Cursor 1.2: A Comprehensive Guide
Cursor 1.2 represents a significant upgrade to the AI-powered coding IDE, introducing powerful new features like Agent Planning, improved context handling, and faster Tab completion. This guide will walk you through everything you need to know to get started with Cursor 1.2 and take advantage of its latest capabilities.
What's New in Cursor 1.2
Before diving into the setup and usage, let's explore the key improvements in this version:
- Agent To-dos: Agents now plan ahead with structured to-do lists for long-horizon tasks
- Queued messages: Queue follow-up messages for Agent while it's working on current tasks
- Memories (GA): The Memories feature is now generally available with improved quality
- PR indexing & search: Search and understand PRs just like you do with files
- Improved embeddings: More accurate codebase search with a new embedding model
- Faster Tab: Tab completions are ~100ms faster with 30% reduced time to first token (TTFT)
- Merge conflict resolution: Let Agent resolve merge conflicts directly in chat
Installation and Setup
System Requirements
- Operating Systems: Windows 10/11, macOS 10.15+, or Linux (Debian/Ubuntu)
- Memory: 8GB RAM minimum, 16GB recommended
- Storage: At least 1GB of free disk space
- Internet Connection: Required for AI features
Installation Steps
- Visit cursor.sh and download the appropriate version for your operating system
- Run the installer and follow the on-screen instructions
- Launch Cursor after installation completes
- Sign in with your account or create a new one
- If upgrading from a previous version, Cursor will automatically update to 1.2
Core Features and How to Use Them
Agent To-dos
Cursor 1.2's Agent To-dos feature helps break down complex tasks into manageable steps:
- Open a project in Cursor
- Press
Cmd/Ctrl+Shift+A
to open the chat panel - Describe a complex task like "Refactor our authentication system to use JWT tokens"
- The Agent will create a structured to-do list with dependencies
- Each item can be tracked as Agent works through them
- To view to-dos in Slack, ensure Slack integration is set up in Dashboard → Integrations
Queued Messages
With queued messages, you can plan ahead while Agent is working:
- While Agent is executing a task, type your next instruction
- Send the message, and it will be queued for processing
- Access the queue by clicking the "Queue" icon in the chat interface
- Reorder queued tasks by dragging them in the queue panel
- Start execution by clicking "Run Queue"
Using Memories
The Memories feature helps Cursor remember project-specific information:
- Enable Memories in Settings → Rules if not already enabled
- Cursor will automatically generate memories based on your interactions
- View and manage memories in Settings → Memories
- To create a memory manually, use the format: "Remember that [important information]"
- Reference memories by mentioning related concepts in your prompts
PR Indexing and Search
To leverage the new PR indexing capabilities:
- Connect your GitHub repository in Settings → Integrations → GitHub
- Allow Cursor to index your PRs (this happens automatically)
- Search PRs using natural language in the search bar with
@pr
prefix - Example:
@pr authentication refactoring
- Click on a PR to view its summary, comments, and associated code changes
Merge Conflict Resolution
When encountering merge conflicts:
- Open the file with conflicts in the editor
- Click the "Resolve in Chat" button that appears
- Agent will analyze the conflicts and suggest resolutions
- Review the suggested changes and apply them if appropriate
- Commit the resolved changes
Advanced Features
Background Agent Improvements
Cursor 1.2 enhances the Background Agent functionality:
- Access Background Agent by clicking the cloud icon in chat or pressing
Cmd/Ctrl+E
- Background Agents now follow your team's PR templates automatically
- Changes to agent branches are auto-pulled in
- Conflicts are surfaced as actionable follow-ups
- Commit directly from the sidebar with the new "Commit changes" button
- Use deeplinks from Slack or web to open the associated repo
Improved Embeddings for Semantic Search
The new embedding model provides more accurate search results:
- Use
@codebase
followed by your query to search the codebase - For more specific searches, try
@file
,@folders
, or@symbol
- Results are now more contextually relevant and precise
- Search across multiple repositories in multi-root workspaces
Troubleshooting Common Issues
Memory Leaks
If you encounter performance degradation over time:
- Update to the latest patch version (at least 1.2.1)
- Restart Cursor to clear memory
- Check Task Manager/Activity Monitor for excessive memory usage
- Disable and re-enable extensions if issues persist
Chat Rendering Issues
For problems with chat display:
- Use
Cmd/Ctrl+Shift+P
to open the command palette - Type "Developer: Reload Window" and press Enter
- If issues persist, try "Clear Chat History" from the chat menu
Token Auth Issues
If experiencing authentication problems:
- Sign out and sign back in
- Check your internet connection
- Ensure your account has proper permissions
- Contact support if issues persist
Best Practices for Cursor 1.2
- Organize Projects: Use multi-root workspaces for related repositories
- Leverage Agent Planning: Start with high-level tasks and let Agent break them down
- Use Memory Effectively: Explicitly tell Cursor to remember important project conventions
- Optimize Prompts: Be specific in your requests to get better results
- Learn Keyboard Shortcuts: Master key combinations to speed up your workflow
Conclusion
Cursor 1.2 represents a significant step forward in AI-assisted development. With improved planning capabilities, faster performance, and enhanced context understanding, it offers a more productive coding experience. By following this guide, you should be well-equipped to leverage the full potential of Cursor 1.2 in your development workflow.
Remember to check for updates regularly, as the Cursor team frequently releases patches with additional improvements and bug fixes.
Happy coding with Cursor 1.2!