Cursor Internals Skill

What problem does it solve?

This Skill provides deep, reverse-engineered knowledge of Cursor IDE's internal architecture, authentication, API structure, and database schema. It eliminates the need for extensive personal investigation, allowing users to quickly integrate with Cursor's backend, understand its AI model access, and build powerful custom tools that bypass the IDE's limitations.

Core Features & Use Cases

• Authentication Mastery: Understand Auth0 OAuth, JWT tokens, and use provided scripts to capture and manage your Cursor API token securely.
• API Protocol Deep Dive: Differentiate between JSON (simple queries) and Protobuf (complex, streaming) endpoints, and access a catalog of discovered API functions.
• Database Schema & Querying: Explore the cursorDiskKV and ItemTable SQLite schema, including JSON structures for chats and messages, and learn how to query them directly.
• AI Model Access: Discover the 40+ AI models available through Cursor's API, including Claude, GPT-5, Gemini, and Grok, and learn how to interact with them programmatically.
• Use Case: To build a custom CLI tool that lists all available AI models in Cursor and then fetches the details of a specific chat, use this skill to get the correct API endpoints, required headers, and Python/Dart code examples for direct API interaction.

Quick Start

Explain how Cursor's authentication works and how I can capture my CURSOR_AUTH_TOKEN and CURSOR_USER_ID using the provided tools/capture_cursor_auth.sh script. Then, show me how to use these credentials to list all available AI models via a curl command.