CursorJ

An IntelliJ plugin that brings Cursor's AI agent into JetBrains IDEs via the Agent Client Protocol (ACP).

Features

• Full Agentic Coding: File editing, terminal commands, and codebase understanding powered by Cursor's AI agent
• Active File Context: Optionally attach the currently open file as context
• Selection Context: Add selected text to chat via Ctrl+Shift+J or Add to CursorJ Chat at the bottom of the editor context menu (with a divider)
• Drag-and-Drop: Drop files onto the chat panel to add them as context
• Multiple Chat Sessions: Open multiple concurrent chat tabs, each with independent sessions
• Edit & Resend: Edit any earlier message you sent and resend it to branch the conversation from that point (later replies are discarded and the prior context is replayed into a fresh session)
• Native IntelliJ UI: Consistent look and feel with syntax-highlighted code blocks and diff rendering
• Enhanced Markdown Rendering: Improved support for tables, nested blockquotes, task lists, strikethrough, autolinks, emoji aliases, and indented code blocks
• Project Indexing: Local-first retrieval for lexical search, symbol lookup, references, and optional semantic reranking
• Permission Control: Approve or reject agent tool calls with native IntelliJ dialogs; choose "Ask Every Time" or "Run Everything"
• Rules: Global user rules (injected into every prompt) and project rules (.cursor/rules/)
• Cursor Skills: Discovers SKILL.md under .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/ (and ~/ equivalents); manage scaffolds in Settings > Tools > CursorJ; type / in chat for an inline command/skill completion list (merged with ACP slash commands) and @ for skill file references; the popup keeps focus in the input so you can keep typing to filter, and @ inserts a path reference so the agent receives ResourceLinkContent for the skill file
• Model Picker: A compact Cursor-style picker in the prompt bar (Claude Opus 4.7 300K Extra High ▾) with a Model submenu (Auto first, MAX Mode, type-to-filter model list) and the current model's parameters as sections (Effort / Reasoning, Options such as Thinking and Fast, Context); values stay in sync with the Cursor CLI's /model picker (changes are CLI-wide; the 1M context option implies Max Mode)
• Mode Switching: Switch between Agent, Plan, Ask, and Debug modes (Plan mode includes Build and View Plan, plus native multiple-choice cards for agent questions; Debug mode simulates Cursor's Debug workflow with runtime-evidence capture)
• Undo All (Rollback Last Turn): Revert files to the state before the most recent agent turn using Local History
• Chat History: Searchable chat history grouped by time; restore previous chats; clear history
• Status Bar: Connection and indexing status (Connected, Processing, Indexing, Index ready, etc.)
• Token usage (optional): When the agent reports usage over ACP, show per-assistant-message token breakdown and a session context/cost bar in chat (toggle in Settings > Tools > CursorJ).
• Background tasks: When the Cursor agent runs subagents (cursor/task), tasks appear in a collapsible list in the chat tool window (running vs completed, duration, tooltips).

Prerequisites

• A JetBrains IDE (IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, Rider, etc.) version 2025.1+
• Cursor CLI installed (agent binary available in PATH)
• A paid Cursor plan

Installation

From Source

./gradlew buildPlugin

The plugin zip will be at build/distributions/cursorj-<version>.zip. Install it in your IDE via Settings > Plugins > Install Plugin from Disk.

Authentication

Before using CursorJ, authenticate with Cursor:

agent login

Usage

1. Open the CursorJ tool window from the right sidebar
2. Type a prompt and press Enter
3. The agent will read your project, edit files, and run commands

Keyboard Shortcuts

Shortcut	Action
Alt+C	Focus CursorJ tool window
Ctrl+Shift+J	Send selection to CursorJ
Enter	Send prompt
Shift+Enter	New line in input
Esc	Cancel an in-progress edit

Model picker

The prompt bar shows one compact trigger next to the mode dropdown, like Cursor's own picker: Claude Opus 4.7 300K Extra High ▾ (the muted suffix follows Cursor's short-name convention: context, effort, then Fast and No Thinking when set). Click it, or press Space on it, to open the picker: a Model submenu (Auto first, MAX Mode when the model has no context option, then a type-to-filter list of models) followed by the current model's parameters as sections in Cursor's order: Effort / Reasoning, Options (Thinking, Fast), then Context. Picking a value sends it to the agent with session/set_config_option and closes the menu; switches keep it open. Two actions are unbound by default and can be given shortcuts in Settings > Keymap: Open CursorJ Model Picker (CursorJ.OpenModelPicker) and Cycle CursorJ Effort Level (CursorJ.CycleEffort).

Edit & Resend

Click Edit on an earlier message you sent to load it back into the input. Adjust the text and press Enter to resend: the conversation branches from that message — everything after it is discarded and the prior turns are replayed as context into a fresh agent session (the agent provides no native session/fork). Press Esc or Cancel edit to abandon the edit without changing the conversation.

This is the beginning of the README. Read the rest at the original. Read the full README ↗