2.4  · Changelog

Subagents, Skills, and Image Generation

Agents are solving increasingly complex, long-running tasks across your codebase. This release introduces new agent harness improvements for better context management, as well as many quality-of-life fixes in the editor and CLI.

Subagents

Subagents are independent agents specialized to handle discrete parts of a parent agent's task. They run in parallel, use their own context, and can be configured with custom prompts, tool access, and models.

The result is faster overall execution, more focused context in your main conversation, and specialized expertise for each subtask.

Cursor includes default subagents for researching your codebase, running terminal commands, and executing parallel work streams. These will automatically start improving the quality of your agent conversations in the editor and the Cursor CLI.

Optionally, you can define custom subagents. Learn more in our docs.

Skills

Cursor now supports Agent Skills in the editor and CLI. Agents can discover and apply skills when domain-specific knowledge and workflows are relevant. You can also invoke a skill using the slash command menu.

Define skills in SKILL.md files, which can include custom commands, scripts, and instructions for specializing the agent’s capabilities based on the task at hand.

Compared to always-on, declarative rules, skills are better for dynamic context discovery and procedural “how-to” instructions. This gives agents more flexibility while keeping context focused.

Image generation

Generate images directly from Cursor's agent. Describe the image in text or upload a reference to guide the underlying image generation model (Google Nano Banana Pro).

Images are returned as an inline preview and saved to your project's assets/ folder by default. This is useful for creating UI mockups, product assets, and visualizing architecture diagrams.

Cursor Blame

On the Enterprise plan, Cursor Blame extends traditional git blame with AI attribution, so you can see exactly what was AI-generated versus human-written.

When reviewing or revisiting code, each line links to a summary of the conversation that produced it, giving you the context and reasoning behind the change.

Cursor Blame distinguishes between code from Tab completions, agent runs (broken down by model), and human edits. It also lets you track AI usage patterns across your team's codebase.

Clarification questions from the agent

The interactive Q&A tool used by agents in Plan and Debug mode now lets agents ask clarifying questions in any conversation.

While waiting for your response, the agent can continue reading files, making edits, or running commands, then incorporate your answer as soon as it arrives.

You can also build custom subagents and skills that use this tool by instructing them to "use the ask question tool."

  • Use agent to start working with the upgraded Cursor CLI in your terminal.
  • MCP server definitions and tools now live as JSON files in .cursor. Agents discover and load MCPs only when needed, reducing token usage and keeping the context focused.
  • Agents can now proactively request switching modes mid-conversation when it detects a different mode would be more effective for the task. You can also auto-approve and auto-reject specific transitions.
  • Fast read-only diff viewer improved performance of the review changes pane.
  • It's now faster to open and resize any chats which used inline code blocks.
  • Agents can now read PDFs, which you can attach in chats as context.
  • CLI can be linked to run as a service account.
  • Improved capabilities & coverage for hooks: stop hook; modify prompts beforeSubmitPrompt ; PreToolUse and PostToolUse hooks.
  • Hook commands now start 40x faster.
  • The in-editor browser is now 10× faster at navigation, with more reliable click actions, drag-and-drop support, and improved text input handling. Agents can also lock the browser while working to prevent accidental interference.
  • Light mode is now supported in the Cursor web dashboard.
  • We've removed the peek sidebar based on your feedback.
  • Windows notifications now have accept/reject buttons like MacOS.
  • Users who choose to "Run Everything" will never have their agents blocked.
  • Editing skills and rules files no longer requires approval in sandboxes.
  • Git writes are now allowed in sandboxes.
  • File edit approvals persist for the entire agent session in sandboxes.
  • Out-of-workspace folder edits can be allowed for the session in sandboxes.
  • Added team and MDM hooks support to CLI with more efficient execution.
  • Added more hooks to CLI already supported in the editor. See the full list of hooks in our docs.
  • Added compatibility with Claude Code hooks in CLI.
  • Faster startup on warm starts in CLI.
  • Unified CLI permissions with the editor, including Run Everything, Auto-Run in Sandbox (if available), and Ask Every Time (allowlist).
  • Improved Ctrl+C detection prevents accidental exits when canceling agent runsin CLI.
  • Ctrl+D now exits immediately on empty chat, matching common shell behavior in CLI.
  • Added -continue to quickly resume your last chat session (shorthand for --resume=-1) in CLI.
  • /mcp enable and /mcp disable now only show relevant MCP servers in autocomplete in CLI.
  • Added /max-mode [on|off] to toggle max mode on models that support it in CLI.
  • Better vim mode support in CLI.

  • Fixed performance issue with adding more MCP server connections.
  • Fixed text being truncated in Windows UI elements including chat tab titles, code block headers, and @-mentions.
  • Fixed the Browser panel rendering on top of other UI components.
  • Browser can now request local network permissions, fixing authentication flows with identity providers like Okta.
  • Fixed issues with splitting and joining browser tabs.
  • Improved message queueing with better handling, and added drag-and-drop reordering for queued items.
  • Fixed chat tabs persistence after reloading or restarting the app.
  • Fixed syntax highlighting issues in git worktrees.
  • Fixed stale diff views from previous sessions remaining visible after app restart.
  • Fixed tabs disappearing when the titlebar is hidden.
  • Fixed the accept/reject diff UI sometimes not appearing when edits were made to dotfiles.
  • Fixed some cases of input lag when handling rapid text changes in CLI.
  • Fixed text wrapping in queued follow-ups in CLI.
  • Fixed an issue allowing edit tool usage during plan mode execution in CLI.

 · Changelog

CLI Agent Modes and Cloud Handoff

This release brings many of the editor’s most-loved features to the Cursor CLI, along with improvements that make it easier to use.

Plan mode in CLI

Use Plan mode to design your approach before coding. Cursor will ask clarifying questions to refine your plan. Get started with /plan or --mode=plan.

Ask mode in CLI

Use Ask mode to explore code without making changes, just like in the editor. Start asking questions with /ask or --mode=ask.

Handoff to Cloud Agents

Push your local conversation to a Cloud Agent and let it keep running while you're away. Prepend & to any message to send it to the cloud, then pick it back up on web or mobile at cursor.com/agents.

Word-level Inline Diffs

Show exactly what changed with precise word-level highlighting in the CLI.

One-click MCP authentication

Connect Cursor to external tools and data sources with a new login flow supporting automatic callback handling. The agent gets access to authenticated MCPs immediately.

Use /mcp list for an updated interactive MCP menu to browse, enable, and configure MCP servers at a glance.

  • Added hooks for session start/end, prompt, and stop for customizing agent lifecycle events.
  • See Cursor streaks and stats with /usage.
  • Added WebFetch, WebSearch tools, & approval options for granular controls over web search and fetch requests from MCP tools.
  • Added /about for seeing basic details about your environment and Cursor CLI setup.
  • Faster message queueing and UX.
  • Shift+Enter for newlines now works in iTerm2, Ghostty, Kitty, Warp, and Zed. Run /setup-terminal to auto-configure /Option+Enter Apple Terminal, Alacritty, or VS Code. Ctrl+J and \+Enter work universally as alternatives.
  • Smarter terminal environment detection for optimal keybindings and display.
  • Better markdown rendering with proper links, tables, and rules.
  • Menu resize handling, long line truncation, and stable state on window changes.

  • /list removed. Use /resume to see all prior conversations.
  • /models removed. Use /model to see all models or select a model.

  • Fixed process hangs and silent failures. Agent runs should be more stable with fewer errors.

 · Changelog

New CLI Features and Improved CLI Performance

This release introduces new CLI controls for models, MCP management, rules and commands, alongside major hooks performance improvements and bug fixes.

Model list and selection

Use the new agent models command, --list-models flag, or /models slash command to list all available models and quickly switch between them.

Rules generation and management

Create new rules and edit existing ones directly from the CLI with the /rules command.

Enabling MCP servers

Enable and disable MCP servers on the fly with /mcp enable and /mcp disable commands.

  • Tabs are now automatically named based on chats.
  • New agent command is now the primary CLI entrypoint. cursor-agent remains as a backward-compatible alias.
  • Added agent models command, -list-models flag, and /models slash command to list all available models.
  • Added /mcp enable, /mcp disable commands to manage MCP servers.
  • Added /rules to create new rules and edit existing rules.
  • Added /commands to create new commands and edit existing commands.
  • Executed subcommands are now recorded in command history.
  • MCP server names with spaces are now supported in all /mcp commands.

  • Hooks now execute in parallel with merged responses, improving performance for projects with multiple hook scripts.
  • Hooks execution latency reduced by 10x.
  • afterFileEdit hook now correctly provides old_string with the file's previous content for proper diff capture.

  • Ctrl+D now follows standard shell behavior, requiring a double-press to exit.
  • Shift+Enter now inserts a newline instead of submitting, making it easier to write multi-line prompts.
  • Fixed ghost line rendering bug where deleted lines would leave visual artifacts on screen.
  • Fixed race condition where conversation state could be overwritten during turn completion.
  • Fixed "Cannot find module" error related to node-pty on some platforms.
  • Fixed chat name generation.
  • Fixed several bugs with follow-up messages.

2.3  · Changelog

Layout Customization and Stability Improvements

For this holiday release, we've focused entirely on fixing bugs and improving stability.

This includes the core agent, layout controls, viewing code diffs, and more. We will be slowly rolling these updates out over the week, ensuring there are no regressions during your holiday coding.

Stability improvements

  • Cursor now separates processes running for user-installed extensions and built-in Cursor extensions, such as codebase indexing.
  • Improved stability around how the agent respects auto-run preferences to prevent asking for approval on all changes if the user has selected run all or sandbox.
  • Improved integrated browser to support opening multiple tabs.
  • Fixed chat loading, where sometimes restarts or updates could cause past chats to be inaccessible.
  • Update button will show less frequently, and cool down for significantly longer when dismissed.
  • Fixed issue where generating plans in Plan Mode would steal focus from other active panes.
  • Fixed integrated browser menubar issue on Windows.

  • Improved parallel agent stability and quality when using worktrees.
  • Improved stability for rolling back to previous checkpoints in agent conversations.
  • Improved ability to edit and drag queued message to agent.
  • Fixed an edit bug caused old_str replace failed error message.
  • Fixed rare prompt input and @-menu delay when opening.
  • Fixed a bug where voice message start icon would not display.
  • Fixed files deleted in a worktree not being removed when applying changes.
  • Fixed accept/reject controls not appearing for file edits in parallel agents.
  • Fixed incorrect model names displaying in parallel agents after applying.
  • Fixed resubmitting the first model in a parallel agent run after applying.
  • Fixed multiple models toggle bug with non-git-root directories.
  • Fixed model mismatch in Plan Mode when using worktrees.
  • Fixed worktrees requiring edit approval outside of otherwise defined auto-run settings.
  • Fixed a rare bug where a user could be logged out on submission from abuse checks.
  • Fixed unread states persisting in the agent sidebar after Plan Mode Q&A.

  • Fixed issue where selected panes were being reset on version upgrades.
  • Fixed ⌘+N to only create new agent conversations when focused in chat view.
  • Fixed issue with native tabs not displaying correct with agent layout.
  • Fixed issue with displaying terminals on the right side layout.
  • Fixed issue where the bottom of the screen content could be cut off in some scenarios.
  • Added new keybindings (⌘+⌥+⇥) for switching between user-defined layouts.
  • View a file explorer when clicking on the repo name in the top navigation bar.
  • File explorer now defaults open during onboarding.
  • Moved the new agent icon from the main title bar into the panel itself based on feedback.
  • Added a "More Actions" ellipsis to hide the chat and configuring positioning directly.
  • Added keyboard shortcuts into display for the "More Actions" menu.

  • Selecting filenames directly from change summary focuses that file in the review pane.
  • Fixed bug where keep/undo all buttons would not show up in the UI.
  • Fixed bug where keep/undo all would flip sides when scrolling from files list to composer toolbar.
  • Improved visibility of changing between split/unified diffs for reviewing changes.

  • Added support for Static Client headers in MCP OAuth w/ scopes and state.
  • MCP OAuth servers now open new auth tabs for previously authenticated servers on startup.

Layout customization

It's now easier to customize your default layout across workspaces.

We've included four default layouts: agent, editor, zen, and browser. You can use Command (⌘) + Option (⌥) + Tab (⇥) to switch between layouts, or easily jump between different workspaces. Additionally, you can move backwards in this list by including Shift (⇧), similar to macOS.

 · Changelog

Enterprise Insights, Billing Groups, Service Accounts, and Improved Security Controls

Many of the largest software companies in the world have adopted Cursor for Enterprise. Here are some of the new features we're releasing today:

Conversation insights

Cursor can now analyze the code and context in each agent session to understand the type of work that is being done, including:

  • Category: Bug fixes, refactoring, explanation
  • Work Type: Maintenance, bug fixing, new features
  • Complexity: Difficulty and specificity of prompts

Enterprise customers can also extend these categories across their organization and teams. We protect your privacy by ensuring no PII or sensitive data is collected as part of these insights.

Shared agent transcripts

You can now share agent conversations with your team.

Generate a read-only transcript of any agent conversation to include in your PRs or internal documentation. Transcripts can be forked so others can start new agent conversations from the same context.

Billing groups

Cursor now supports billing groups for fine-grained visibility into where usage occurs.

Map usage and spend to the structure of your organization. Track spend by group, set budget alerts, and keep an eye on outliers. Understand which teams have the highest adoption of Cursor.

Linux sandboxing for agents

Sandboxing for agents supports Linux in addition to macOS.

This allows agents to work effectively within appropriate boundaries. Access is scoped to your workspace and can be configured to block unauthorized network and filesystem access.

Learn more about LLM safety and controls.

Service accounts

Service accounts are non-human accounts (and their API keys) that can configure Cursor, call APIs, and invoke cloud agents.

With service accounts, teams can securely automate Cursor-powered workflows without tying integrations to individual developers' accounts. This makes it easier to manage access, rotate credentials, and keep automations running even as people and roles change.

Service accounts will roll out to Enterprise accounts starting the week of 12/22.

Learn more about Cursor for Enterprise and talk to our team to learn more.