โ† All skills
Tencent SkillHub ยท Developer Tools

Cursor CLI Agent

A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
README.md, SKILL.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
2.1.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 22 sections Open source page

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

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
2 Docs
  • SKILL.md Primary doc
  • README.md Docs