Skip to content

Add Cursor plugin metadata#456

Merged
edgarsskore merged 10 commits into
mainfrom
cursor-marketplace-submission
Apr 30, 2026
Merged

Add Cursor plugin metadata#456
edgarsskore merged 10 commits into
mainfrom
cursor-marketplace-submission

Conversation

@edgarsskore

@edgarsskore edgarsskore commented Apr 29, 2026

Copy link
Copy Markdown
Collaborator

CodeAnt-AI Description

Add Cursor plugin listing, setup guidance, and usage rules for Desktop Commander

What Changed

  • Adds Cursor marketplace metadata so Desktop Commander can be discovered and installed as a plugin
  • Adds a plugin README that explains when to use Desktop Commander for terminal work, local files, structured documents, SSH sessions, and long-running processes
  • Adds default guidance for agents to prefer Desktop Commander for filesystem, search, process, and workspace tasks

Impact

✅ Plugin can be installed from Cursor
✅ Clearer guidance for terminal and file tasks
✅ Easier use of long-running shells, SSH, and local data files

🔄 Retrigger CodeAnt AI Review

Details

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

@codeant-ai

codeant-ai Bot commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is reviewing your PR.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@coderabbitai

coderabbitai Bot commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds a new Cursor plugin "Desktop Commander": a marketplace manifest, a plugin manifest with an MCP server entry, and documentation/skill guides describing terminal/REPL, filesystem, process, and SSH capabilities for agents to operate outside the IDE sandbox.

Changes

Cohort / File(s) Summary
Marketplace Manifest
/.cursor-plugin/marketplace.json
New marketplace metadata registering the desktop-commander plugin (owner, version 0.1.0, pluginRoot: "plugins", single desktop-commander entry sourced from cursor).
Plugin Manifest
plugins/cursor/.cursor-plugin/plugin.json
New Cursor plugin manifest declaring "Desktop Commander": identity, metadata, skills and rules paths, and an mcpServers entry that starts the server via npx -y @wonderwhy-er/desktop-commander@latest.
Skill & Docs
plugins/cursor/skills/desktop-commander-overview/SKILL.md, plugins/cursor/README.md
Added skill documentation and README describing persistent shells/REPLs, SSH workflows, out-of-workspace file operations, structured/binary format handling, large-search pagination, process management commands, example workflows, and operational conventions.
Rules
plugins/cursor/rules/desktop-commander-default.mdc
New rule config enforcing Desktop Commander as the default handler for local filesystem, terminal, process, search, and workspace operations, with guidance when it is not used.

Sequence Diagram(s)

sequenceDiagram
    participant Agent as Cursor Agent
    participant Plugin as Cursor Skill / Plugin
    participant MCP as Desktop Commander MCP Server
    participant OS as Local OS / Filesystem

    Agent->>Plugin: Request Desktop Commander capability
    Plugin->>MCP: Start or forward session/command (mcpServers)
    MCP->>OS: Run shell/REPL, file ops, process management, or SSH
    OS-->>MCP: Return output, file content, process info
    MCP-->>Plugin: Structured results and session updates
    Plugin-->>Agent: Tool responses, session handles, and follow-ups
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 I hopped to the repo with a twitch and a cheer,
Desktop Commander lands — local tasks now near.
Manifests and skills in tidy little rows,
Agents can shell, search, and manage as they go,
Cheers from the burrow — ready, steady, clear!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Add Cursor plugin metadata' directly matches the main objective of the PR, which is to add Cursor marketplace metadata and plugin configuration files to enable Desktop Commander publication as a Cursor plugin.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor-marketplace-submission

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Apr 29, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
plugins/cursor/skills/desktop-commander-overview/SKILL.md (1)

96-104: Add an explicit “confirm before destructive action” convention.

This section is strong; consider adding one explicit rule to require user confirmation before destructive operations (e.g., force_terminate, bulk move_file, overwrite edits) unless the user already requested it in the same turn.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@plugins/cursor/skills/desktop-commander-overview/SKILL.md` around lines 96 -
104, Add a new convention line in the Conventions section of SKILL.md requiring
an explicit confirmation step before performing destructive operations;
specifically state that commands like force_terminate, bulk move_file, and any
write_file/overwrite edits must prompt the user to confirm (or require the user
to have already requested the destructive action in the same turn) and that
denied confirmations must abort the operation and be surfaced to the user
(similar to how out-of-scope paths are surfaced for
list_directory/read_file/write_file); update the Conventions paragraph alongside
the Absolute paths / Allowed-directory scope entries so readers see this rule
next to related safety guidance.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@plugins/cursor/skills/desktop-commander-overview/SKILL.md`:
- Around line 96-104: Add a new convention line in the Conventions section of
SKILL.md requiring an explicit confirmation step before performing destructive
operations; specifically state that commands like force_terminate, bulk
move_file, and any write_file/overwrite edits must prompt the user to confirm
(or require the user to have already requested the destructive action in the
same turn) and that denied confirmations must abort the operation and be
surfaced to the user (similar to how out-of-scope paths are surfaced for
list_directory/read_file/write_file); update the Conventions paragraph alongside
the Absolute paths / Allowed-directory scope entries so readers see this rule
next to related safety guidance.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5af053ff-dc89-4871-9bdd-226d341f9b23

📥 Commits

Reviewing files that changed from the base of the PR and between 6be424c and 5a01050.

📒 Files selected for processing (3)
  • .cursor-plugin/marketplace.json
  • plugins/cursor/.cursor-plugin/plugin.json
  • plugins/cursor/skills/desktop-commander-overview/SKILL.md

@codeant-ai

codeant-ai Bot commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI finished reviewing your PR.

@codeant-ai

codeant-ai Bot commented Apr 30, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is running Incremental review


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels Apr 30, 2026
@codeant-ai

codeant-ai Bot commented Apr 30, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI Incremental review completed.

@edgarsskore edgarsskore merged commit 43116a8 into main Apr 30, 2026
2 checks passed
@edgarsskore edgarsskore deleted the cursor-marketplace-submission branch April 30, 2026 07:58
@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels May 7, 2026
@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

Sequence Diagram

This PR registers Desktop Commander as a Cursor plugin, adds a default rule to prefer it for local filesystem and terminal tasks, and provides a skill that guides agents on how to use its MCP tools.

sequenceDiagram
    participant User
    participant CursorAgent as Cursor agent
    participant Rules as Cursor rules
    participant Skill as Desktop Commander skill
    participant MCP as Desktop Commander MCP

    User->>CursorAgent: Request local file or terminal operation
    CursorAgent->>Rules: Evaluate rules for local operations
    Rules-->>CursorAgent: Prefer Desktop Commander MCP
    CursorAgent->>Skill: Read guidance for Desktop Commander tools
    Skill-->>CursorAgent: Recommended tools and workflows
    CursorAgent->>MCP: Execute terminal or filesystem command
    MCP-->>CursorAgent: Command result
    CursorAgent-->>User: Present operation outcome
Loading

Generated by CodeAnt AI

@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI finished running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels May 7, 2026
@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

Sequence Diagram

This PR wires Desktop Commander into Cursor as a plugin and defines rules and guidance so the Cursor agent prefers it for local filesystem, terminal, process, search, workspace, and SSH tasks.

sequenceDiagram
    participant User
    participant CursorAgent
    participant CursorPlugin
    participant DesktopCommanderMCP
    participant LocalSystem

    User->>CursorAgent: Ask for local filesystem or terminal task
    CursorAgent->>CursorPlugin: Select Desktop Commander for system operation
    CursorPlugin->>DesktopCommanderMCP: Start MCP server using configured command
    CursorAgent->>DesktopCommanderMCP: Invoke tool for shell, file, or process workflow
    DesktopCommanderMCP->>LocalSystem: Perform requested command or file operation
    LocalSystem-->>DesktopCommanderMCP: Return operation result
    DesktopCommanderMCP-->>CursorAgent: Return structured response
    CursorAgent-->>User: Present results and next steps
Loading

Generated by CodeAnt AI

@codeant-ai

codeant-ai Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI finished running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels May 8, 2026
@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

Sequence Diagram

This PR registers Desktop Commander as a Cursor plugin and adds rules and skills so Cursor agents route local terminal, filesystem, process, and document tasks through the Desktop Commander MCP server.

sequenceDiagram
    participant User
    participant CursorAgent
    participant DesktopCommanderPlugin
    participant DesktopCommanderMCP
    participant LocalSystem

    User->>CursorAgent: Ask for terminal or filesystem help
    CursorAgent->>DesktopCommanderPlugin: Apply default rule and skill to choose Desktop Commander
    DesktopCommanderPlugin->>DesktopCommanderMCP: Start MCP server via configured command
    CursorAgent->>DesktopCommanderMCP: Send terminal or filesystem request
    DesktopCommanderMCP->>LocalSystem: Execute commands and file operations
    LocalSystem-->>DesktopCommanderMCP: Return outputs and file data
    DesktopCommanderMCP-->>DesktopCommanderPlugin: Send structured results
    DesktopCommanderPlugin-->>CursorAgent: Provide processed results for response
    CursorAgent-->>User: Present outcome and explanation
Loading

Generated by CodeAnt AI

@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI finished running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI is running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels May 8, 2026
@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

Sequence Diagram

This PR adds Cursor plugin metadata, a usage skill, and a default rule so Cursor agents route local filesystem, terminal, process, and search tasks through the Desktop Commander MCP server.

sequenceDiagram
    participant User
    participant CursorAgent
    participant CursorPlugin
    participant DesktopCommanderMCP
    participant LocalSystem

    User->>CursorAgent: Request local filesystem or terminal task
    CursorAgent->>CursorPlugin: Select Desktop Commander tools for this task
    CursorPlugin->>DesktopCommanderMCP: Ensure MCP server is running and configured
    CursorAgent->>DesktopCommanderMCP: Run persistent shell or file operation
    DesktopCommanderMCP->>LocalSystem: Execute command or file action
    LocalSystem-->>DesktopCommanderMCP: Return results
    DesktopCommanderMCP-->>CursorAgent: Operation output
    CursorAgent-->>User: Present results and next steps
Loading

Generated by CodeAnt AI

@codeant-ai

codeant-ai Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

CodeAnt AI finished running the review.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant