# Send Cursor CLI Agent to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "cursor-agent", "name": "Cursor CLI Agent", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/swiftlysingh/cursor-agent", "canonicalUrl": "https://clawhub.ai/swiftlysingh/cursor-agent", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/cursor-agent", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cursor-agent", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "cursor-agent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T07:20:42.816Z", "expiresAt": "2026-05-09T07:20:42.816Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cursor-agent", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cursor-agent", "contentDisposition": "attachment; filename=\"cursor-agent-2.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "cursor-agent" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/cursor-agent" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/cursor-agent", "downloadUrl": "https://openagent3.xyz/downloads/cursor-agent", "agentUrl": "https://openagent3.xyz/skills/cursor-agent/agent", "manifestUrl": "https://openagent3.xyz/skills/cursor-agent/agent.json", "briefUrl": "https://openagent3.xyz/skills/cursor-agent/agent.md" } } ``` ## Documentation ### Cursor CLI Agent Skill This skill provides a comprehensive guide and set of workflows for utilizing the Cursor CLI tool, including all features from the January 2026 update. ### Standard Installation (macOS, Linux, Windows WSL) curl https://cursor.com/install -fsS | bash ### Homebrew (macOS only) brew install --cask cursor-cli ### Post-Installation Setup macOS: Add to PATH in ~/.zshrc (zsh) or ~/.bashrc (bash): export PATH="$HOME/.local/bin:$PATH" Restart terminal or run source ~/.zshrc (or ~/.bashrc) Requires macOS 10.15 or later Works on both Intel and Apple Silicon Macs Linux/Ubuntu: Restart your terminal or source your shell config Verify with agent --version Both platforms: Commands: agent (primary) and cursor-agent (backward compatible) Verify installation: agent --version or cursor-agent --version ### Authentication Authenticate via browser: agent login Or use API key: export CURSOR_API_KEY=your_api_key_here ### Update Keep your CLI up to date: agent update # or agent upgrade ### Interactive Mode Start an interactive session with the agent: agent Start with an initial prompt: agent "Add error handling to this API" Backward compatibility: cursor-agent still works but agent is now the primary command. ### Model Switching List all available models: agent models # or agent --list-models Use a specific model: agent --model gpt-5 Switch models during a session: /models ### Session Management Manage your agent sessions: List sessions: agent ls Resume most recent: agent resume Resume specific session: agent --resume="[chat-id]" ### Context Selection Include specific files or folders in the conversation: @filename.ts @src/components/ ### Slash Commands Available during interactive sessions: /models - Switch between AI models interactively /compress - Summarize conversation and free up context window /rules - Create and edit rules directly from CLI /commands - Create and modify custom commands /mcp enable [server-name] - Enable an MCP server /mcp disable [server-name] - Disable an MCP server ### Keyboard Shortcuts Shift+Enter - Add newlines for multi-line prompts Ctrl+D - Exit CLI (requires double-press for safety) Ctrl+R - Review changes (press i for instructions, navigate with arrow keys) ArrowUp - Cycle through previous messages ### Non-interactive / CI Mode Run the agent in a non-interactive mode, suitable for CI/CD pipelines: agent -p 'Run tests and report coverage' # or agent --print 'Refactor this file to use async/await' Output formats: # Plain text (default) agent -p 'Analyze code' --output-format text # Structured JSON agent -p 'Find bugs' --output-format json # Real-time streaming JSON agent -p 'Run tests' --output-format stream-json --stream-partial-output Force mode (auto-apply changes without confirmation): agent -p 'Fix all linting errors' --force Media support: agent -p 'Analyze this screenshot: screenshot.png' ### ⚠️ Using with AI Agents / Automation (tmux required) CRITICAL: When running Cursor CLI from automated environments (AI agents, scripts, subprocess calls), the CLI requires a real TTY. Direct execution will hang indefinitely. The Solution: Use tmux # 1. Install tmux if not available sudo apt install tmux # Ubuntu/Debian brew install tmux # macOS # 2. Create a tmux session tmux kill-session -t cursor 2>/dev/null || true tmux new-session -d -s cursor # 3. Navigate to project tmux send-keys -t cursor "cd /path/to/project" Enter sleep 1 # 4. Run Cursor agent tmux send-keys -t cursor "agent 'Your task here'" Enter # 5. Handle workspace trust prompt (first run) sleep 3 tmux send-keys -t cursor "a" # Trust workspace # 6. Wait for completion sleep 60 # Adjust based on task complexity # 7. Capture output tmux capture-pane -t cursor -p -S -100 # 8. Verify results ls -la /path/to/project/ Why this works: tmux provides a persistent pseudo-terminal (PTY) Cursor's TUI requires interactive terminal capabilities Direct agent calls from subprocess/exec hang without TTY What does NOT work: # ❌ These will hang indefinitely: agent "task" # No TTY agent -p "task" # No TTY subprocess.run(["agent", ...]) # No TTY script -c "agent ..." /dev/null # May crash Cursor ### Rules & Configuration The agent automatically loads rules from: .cursor/rules AGENTS.md CLAUDE.md Use /rules command to create and edit rules directly from the CLI. ### MCP Integration MCP servers are automatically loaded from mcp.json configuration. Enable/disable servers on the fly: /mcp enable server-name /mcp disable server-name Note: Server names with spaces are fully supported. ### Code Review Perform a code review on the current changes or a specific branch: agent -p 'Review the changes in the current branch against main. Focus on security and performance.' ### Refactoring Refactor code for better readability or performance: agent -p 'Refactor src/utils.ts to reduce complexity and improve type safety.' ### Debugging Analyze logs or error messages to find the root cause: agent -p 'Analyze the following error log and suggest a fix: [paste log here]' ### Git Integration Automate git operations with context awareness: agent -p 'Generate a commit message for the staged changes adhering to conventional commits.' ### Batch Processing (CI/CD) Run automated checks in CI pipelines: # Set API key in CI environment export CURSOR_API_KEY=$CURSOR_API_KEY # Run security audit with JSON output agent -p 'Audit this codebase for security vulnerabilities' --output-format json --force # Generate test coverage report agent -p 'Run tests and generate coverage report' --output-format text ### Multi-file Analysis Use context selection to analyze multiple files: agent # Then in interactive mode: @src/api/ @src/models/ Review the API implementation for consistency with our data models ## Trust - Source: tencent - Verification: Indexed source record - Publisher: swiftlysingh - Version: 2.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T07:20:42.816Z - Expires at: 2026-05-09T07:20:42.816Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/cursor-agent) - [Send to Agent page](https://openagent3.xyz/skills/cursor-agent/agent) - [JSON manifest](https://openagent3.xyz/skills/cursor-agent/agent.json) - [Markdown brief](https://openagent3.xyz/skills/cursor-agent/agent.md) - [Download page](https://openagent3.xyz/downloads/cursor-agent)