A powerful wrapper for executing Cursor agent tasks in non-interactive, headless mode for seamless automation and batch processing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cursor-cli-headless
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install cursor-cli-headless using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Cursor CLI Headless?
Cursor CLI Headless is a specialized tool within the Openclaw Skills ecosystem designed to bridge the gap between AI-driven development and automated workflows. By leveraging the Cursor CLI's print mode, this skill allows developers to delegate complex code writing, refactoring, and analysis tasks to a headless agent process without requiring manual intervention.
This skill is particularly valuable for developers looking to integrate LLM-based coding assistance into their existing scripts or pipelines. Whether you are running automated code changes across multiple repositories or performing batch file analysis, this implementation provides the reliable, programmatic interface needed to harness the full power of Cursor in any environment.
Cursor CLI Headless Use Cases
- Automating repetitive code refactoring tasks across large scale projects.
- Integrating AI-driven code reviews directly into CI/CD pipelines.
- Batch processing documentation updates or README summarizations.
- Delegating complex architectural analysis to a background agent process.
- Running automated test generation for new modules via script triggers.
How Cursor CLI Headless Works
- The user initiates a task using the run-task.sh wrapper script, providing either an inline prompt or a dedicated prompt file.
- The script configures the Cursor agent environment, ensuring the correct working directory and model parameters are applied.
- The headless agent executes the requested task, optionally modifying files directly if the force flag is enabled.
- Real-time progress is streamed via NDJSON, providing visibility into tool calls and model activity.
- Upon completion, the skill returns the final result in the requested format (text, JSON, or stream) and exits with a status code indicating success or failure.
Cursor CLI Headless Setup
To begin using this skill from the Openclaw Skills collection, ensure the Cursor CLI is installed and authenticated:
# Install Cursor CLI if missing
curl https://cursor.com/install -fsS | bash
# Authenticate your account
agent login
# Verify installation
agent --version
Set your CURSOR_API_KEY in your environment variables for non-interactive script execution.
Cursor CLI Headless Data Schema & Taxonomy
The skill manages data through standard streams and specific output formats to ensure compatibility with downstream tools:
| Data Type | Description |
|---|---|
| Input Prompts | Supports raw text files (.txt) or inline string arguments. |
| Standard Output | Emits NDJSON (default), raw text, or a single JSON object. |
| Standard Error | Used for real-time progress tracking (via jq) and error reporting. |
| JSON Schema | When using -o json, returns an object containing result and duration_ms. |
Cursor CLI Headless Advanced Features
- Multi-format output support (text, json, stream-json) for integration with various parsing tools.
- Support for multiple execution modes including agent, plan, and ask.
- Configurable file modification permissions using the force and no-force flags.
- Seamless working directory targeting to provide the agent with specific project context.
- Progress streaming via jq for high-visibility terminal feedback during long-running tasks.
SKILL.md
Loading
Related Openclaw Skills
Warden Messari Agent
A professional-grade crypto research agent that provides quantitative and qualitative market insights via the A2A protocol and x402 micropayments.
PokePerps AI Agent Skill
A decentralized perpetual futures exchange on Solana for trading real-time Pokemon TCG card price movements with up to 50x leverage.
Roast Agents Game Skill
A competitive social gaming skill that enables AI agents to participate in, host, and win automated roast battles on the Moltbook platform.
Daily Info
Daily Info is a powerful tool designed to provide AI agents with integrated current date, lunar calendar, and local weather data in a single, structured report.
PayRam Payment Gateway
PayRam is an MCP-powered payment gateway that allows developers and AI agents to accept USDC, BTC, and ETH payments instantly without KYC or bank accounts.
Zhihu Automation Skill
A sophisticated browser-based automation tool for Zhihu that enables AI agents to publish articles, answer questions, and extract platform data securely.
Featured*
