ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

use-cursor

Manage Cursor CLI tasks via tmux with security hardening

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/brucezhu888/use-cursor
Or

Use Cursor - OpenClaw + Cursor CLI Integration

Enable OpenClaw to execute Cursor CLI for various software engineering tasks, supporting interactive mode, background tasks, CI/CD, and more.


🔒 Security Notes

Before installing, understand these security implications:

What This Skill Does

  • ✅ Manages Cursor CLI tasks via tmux (stated purpose)
  • ✅ Reads ~/.cursor/cli-config.json to check auth status (email redacted in output)
  • ✅ Captures tmux pane output (may contain workspace code/data)
  • ✅ All shell arguments are escaped to prevent injection
  • ✅ Does not download remote code at install time

Privacy Considerations

Data AccessPurposeProtection
~/.cursor/cli-config.jsonCheck auth statusEmail redacted (shows ***@domain.com)
~/.cursor/credentialsCheck auth statusNot read, only existence checked
$CURSOR_API_KEYOptional authNot logged or stored
$PATH, $HOME, etc.Inherited by child processesNot modified or logged
tmux outputReturn task resultsMay contain workspace data

⚠️ Critical: tmux Pane Execution Risk

This skill sends user-provided strings into tmux panes via tmux send-keys.

How it works:

  1. Script creates tmux session
  2. Runs agent --print --trust 'TASK' in the pane
  3. Captures pane output and returns to agent

Risk: If the pane is running a shell, any text sent via send-keys will be executed. While we escape arguments at the JavaScript level, special characters/control sequences could still affect the shell.

Mitigation:

  • Use in isolated environments (container/VM) for untrusted tasks
  • Don't run on production machines with live secrets
  • Review task strings before sending

Recommendations

EnvironmentRecommendation
Personal dev machine✅ Safe for normal projects
Open source work✅ Safe
Corporate environment⚠️ Review with security team first
Production server❌ Not recommended
Machine with high-value secrets❌ Use isolated container/VM

Security Features (v1.0.0+)

  • ✓ Shell argument escaping via single-quote method (prevents injection)
  • ✓ tmux literal mode (-l flag) for all send-keys commands
  • ✓ Email redaction (***@domain.com)
  • ✓ API key/token redaction in output
  • ✓ No autonomous execution (always: false)
  • ✓ No remote code download
  • ✓ Explicit permissions declared in manifest
  • ✓ Isolated mode with minimal environment (hardcoded PATH)

🎯 Use Cases

ScenarioRecommended ModeDescription
Quick tasksInteractiveDirect agent "task description"
Long-running codingBackgroundtmux-managed, no timeout
CI/CD automationNon-interactiveagent -p + JSON output
Code reviewInteractive/BackgroundWith context analysis
Large refactoringBackgroundInterruptible, resumable

Metadata

Stars4190
Views0
Updated2026-04-18
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-brucezhu888-use-cursor": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.