cursor-cli
Delegate tasks to Cursor CLI (agent command) for IDE-grade coding in the terminal, cloud agent handoff for long-running tasks, and rapid prototyping with multi-model support.
Best use case
cursor-cli is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Delegate tasks to Cursor CLI (agent command) for IDE-grade coding in the terminal, cloud agent handoff for long-running tasks, and rapid prototyping with multi-model support.
Teams using cursor-cli should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/cursor-cli/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How cursor-cli Compares
| Feature / Agent | cursor-cli | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Delegate tasks to Cursor CLI (agent command) for IDE-grade coding in the terminal, cloud agent handoff for long-running tasks, and rapid prototyping with multi-model support.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
## What is Cursor CLI Cursor CLI brings the full Cursor IDE agent experience to the terminal. It supports cloud agent handoff (start locally, continue remotely), works with any model in your Cursor subscription, and provides the same powerful coding capabilities as the Cursor editor. ## When to delegate to Cursor CLI Use Cursor CLI when you need to: - Perform IDE-grade code generation and editing from the terminal - Hand off long-running tasks to cloud agents - Rapidly prototype features with multi-model support - Work on tasks that benefit from Cursor's proprietary model routing - Use plan mode to get implementation strategies before coding - Run background coding tasks while you work on other things ## How to invoke Cursor CLI ### Non-interactive (recommended for delegation) Use the `-p` flag for non-interactive print mode: ```bash agent -p "YOUR PROMPT HERE" ``` ### With cloud handoff (long-running tasks) ```bash agent -p "YOUR PROMPT" -c --cloud ``` ### With specific model ```bash agent -p "YOUR PROMPT" --model gpt-5.2 ``` ### Plan mode (get strategy without making changes) ```bash agent -p "YOUR PROMPT" --mode=plan ``` ### Ask mode (answer questions without changes) ```bash agent -p "YOUR PROMPT" --mode=ask ``` ### Full agent mode (default - makes changes) ```bash agent -p "YOUR PROMPT" --mode=agent ``` ### List active/previous sessions ```bash agent ls ``` ### Resume a previous session ```bash agent resume ``` ## Important notes - Install via `curl https://cursor.sh/cli -fsS | bash` - Requires a Cursor subscription for authentication - The CLI command is `agent` (NOT `cursor`) - Still in beta - some features may change - The `-p` flag is essential for non-interactive use - Cloud mode (`-c` or `--cloud`) hands off to remote agents - useful for long tasks - Supports `--output-format text` for clean output capture ## Delegation pattern For rapid prototyping: ```bash RESULT=$(agent -p "Create a complete CRUD API for a blog post system using Express.js and TypeScript. Include routes, controllers, types, and basic validation. Structure files under src/api/posts/") ``` For planning before implementation: ```bash PLAN=$(agent -p "How should I implement real-time notifications in this Next.js app? Consider WebSocket vs SSE, database design, and component architecture." --mode=plan) ``` For cloud-delegated long tasks: ```bash agent -p "Migrate the entire test suite from Jest to Vitest. Update all config files, test utilities, and mocks. Ensure all tests pass." -c --cloud ```
Related Skills
sdlc-orchestrator
Orchestrate multiple coding agent CLIs as sub-agents. Load this skill to understand which coding agent CLI to delegate tasks to based on task type (front-end, context engineering, GitHub workflows, refactoring, pair programming, rapid prototyping).
kimi-cli
Delegate tasks to Kimi CLI for front-end development, full-stack coding, and long-context code understanding. Powered by Moonshot AI's Kimi K2 model with extended context support.
gemini-cli
Delegate tasks to Gemini CLI for context engineering, large codebase analysis, research-heavy coding tasks, and documentation generation. Gemini has a 1M token context window and built-in Google Search grounding.
copilot-cli
Delegate tasks to GitHub Copilot CLI for GitHub workflow automation, PR creation and review, issue management, and repository operations. Deeply integrated with GitHub's ecosystem.
claude-code
Delegate tasks to Claude Code for complex refactoring, architecture-level changes, multi-file edits, in-depth code review, and debugging. Excels at deep reasoning about code structure.
aider
Delegate tasks to Aider for AI pair programming with auto-git-commits, model-agnostic LLM support, and architect mode for complex changes. Works with any LLM provider.
cursor2api
cursor2api proxy service management tool that converts Cursor IDE's free AI conversations into Anthropic Messages API / OpenAI Chat Completions API format. Supports Docker deployment, environment configuration, token refresh, and complete uninstallation. Use when user asks to: (1) Install or deploy cursor2api, (2) Configure cursor2api for OpenClaw/Claude Code/CC Switch, (3) Refresh or retrieve Cursor Session Token, (4) Uninstall cursor2api.
detecting-ransomware-precursors-in-network
Detects early-stage ransomware indicators in network traffic before encryption begins, including initial access broker activity, command-and-control beaconing, credential harvesting, reconnaissance scanning, and staging behavior. Uses network detection tools (Zeek, Suricata, Arkime), SIEM correlation rules, and threat intelligence feeds to identify ransomware precursor patterns such as Cobalt Strike beacons, Mimikatz network signatures, and RDP brute-force attempts. Activates for requests involving pre-ransomware detection, network-based ransomware indicators, or early warning ransomware monitoring.
clawdcursor
OS-level desktop automation tool server. 42 tools for controlling any application on Windows, macOS, and Linux. Model-agnostic — works with any AI that can do function calling via REST or MCP (Claude, GPT, Gemini, Llama, Mistral, or plain HTTP). No built-in LLM in serve/mcp mode. You are the brain. ClawdCursor is the hands.
cursor-agent
Run Cursor Agent CLI for coding tasks — writing, editing, refactoring, reviewing, or planning code — without spending OpenClaw API credits. Use when the user asks to write/fix/refactor/review code, a coding task would otherwise be done inline with Sonnet/Haiku, the user says "do this in cursor" or "use cursor for this", or any substantial file-editing task in a known repo. NOT for conversational questions about code (answer inline) or tiny one-liners that don't warrant a subprocess.
cursor-subagent-creator
Creates Cursor-specific AI subagents with isolated context for complex multi-step workflows. Use when creating subagents for Cursor editor specifically, following Cursor's patterns and directories (.cursor/agents/). Triggers on "cursor subagent", "cursor agent". Do NOT use for generic subagent creation outside Cursor (use subagent-creator instead).
cursor-usage-analytics
Track and analyze Cursor usage metrics via admin dashboard: requests, model usage, team productivity, and cost optimization. Triggers on "cursor analytics", "cursor usage", "cursor metrics", "cursor reporting", "cursor dashboard", "cursor ROI".