Cursor CLI Headless para Openclaw

Un potente wrapper para ejecutar tareas del agent Cursor en modo headless no interactivo para una automatización y procesamiento por lotes sin interrupciones.

daxingplay
v1.1.0
Feb 19, 2026
0
1.1k
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install cursor-cli-headless

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar cursor-cli-headless usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Cursor CLI Headless?

Cursor CLI Headless es una herramienta especializada dentro del ecosistema Openclaw Skills diseñada para cerrar la brecha entre el desarrollo impulsado por IA y los flujos de trabajo automatizados. Al aprovechar el modo print del Cursor CLI, esta skill permite a los desarrolladores delegar tareas complejas de escritura de código, refactorización y análisis a un proceso de agent en modo headless sin necesidad de intervención manual.

Esta skill es particularmente valiosa para desarrolladores que buscan integrar la asistencia de codificación basada en LLM en sus scripts o pipelines existentes. Ya sea que esté ejecutando cambios de código automatizados en múltiples repositorios o realizando análisis de archivos por lotes, esta implementación proporciona la interfaz programática confiable necesaria para aprovechar todo el potencial de Cursor en cualquier entorno.

Casos de uso de Cursor CLI Headless

  • Automatización de tareas repetitivas de refactorización de código en proyectos a gran escala.
  • Integración de revisiones de código impulsadas por IA directamente en pipelines de CI/CD.
  • Procesamiento por lotes de actualizaciones de documentación o resúmenes de README.
  • Delegación de análisis arquitectónicos complejos a un proceso de agent en segundo plano.
  • Ejecución de generación de pruebas automatizadas para nuevos módulos mediante activadores de script.

Cómo funciona Cursor CLI Headless

  1. El usuario inicia una tarea usando el script wrapper run-task.sh, proporcionando un prompt en línea o un archivo de prompt dedicado.
  2. El script configura el entorno del agent Cursor, asegurando que se apliquen el directorio de trabajo correcto y los parámetros de modelo adecuados.
  3. El agent headless ejecuta la tarea solicitada, modificando opcionalmente archivos directamente si la flag force está habilitada.
  4. El progreso en tiempo real se transmite vía NDJSON, proporcionando visibilidad de las llamadas a herramientas y la actividad del modelo.
  5. Al finalizar, la skill devuelve el resultado final en el formato solicitado (texto, JSON o stream) y sale con un código de estado que indica éxito o fallo.

Configuración de Cursor CLI Headless

Para comenzar a usar esta skill de la colección Openclaw Skills, asegúrese de que el Cursor CLI esté instalado y autenticado:

# Instale Cursor CLI si falta
curl https://cursor.com/install -fsS | bash

# Autentique su cuenta
agent login

# Verifique la instalación
agent --version

Establezca su CURSOR_API_KEY en sus variables de entorno para la ejecución de scripts no interactivos.

Esquema de datos y taxonomía de Cursor CLI Headless

La skill gestiona los datos a través de flujos estándar y formatos de salida específicos para garantizar la compatibilidad con herramientas downstream:

Tipo de Datos Descripción
Input Prompts Admite archivos de texto sin formato (.txt) o argumentos de cadena en línea.
Standard Output Emite NDJSON (predeterminado), texto plano o un único objeto JSON.
Standard Error Se utiliza para el seguimiento del progreso en tiempo real (vía jq) y el reporte de errores.
JSON Schema Al usar -o json, devuelve un objeto que contiene result y duration_ms.

Funciones avanzadas de Cursor CLI Headless

  • Soporte de salida multiformato (text, json, stream-json) para la integración con varias herramientas de parsing.
  • Soporte para múltiples modos de ejecución incluyendo agent, plan y ask.
  • Permisos de modificación de archivos configurables usando las flags force y no-force.
  • Orientación del directorio de trabajo sin interrupciones para proporcionar al agent un contexto de proyecto específico.
  • Streaming de progreso vía jq para feedback de terminal de alta visibilidad durante tareas de larga duración.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*