Cursor CLI Headless para Openclaw

Um wrapper poderoso para executar tarefas do agent Cursor em modo headless não interativo para automação e processamento em lote contínuos.

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

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install cursor-cli-headless

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o cursor-cli-headless usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Cursor CLI Headless?

O Cursor CLI Headless é uma ferramenta especializada dentro do ecossistema Openclaw Skills projetada para preencher a lacuna entre o desenvolvimento orientado por IA e os fluxos de trabalho automatizados. Ao aproveitar o modo print do Cursor CLI, esta skill permite que os desenvolvedores deleguem tarefas complexas de escrita de código, refatoração e análise para um processo de agent em modo headless, sem exigir intervenção manual.

Esta skill é particularmente valiosa para desenvolvedores que buscam integrar a assistência de codificação baseada em LLM em seus scripts ou pipelines existentes. Esteja você executando alterações de código automatizadas em vários repositórios ou realizando análises de arquivos em lote, esta implementação fornece a interface de programação confiável necessária para aproveitar todo o poder do Cursor em qualquer ambiente.

Casos de uso do Cursor CLI Headless

  • Automação de tarefas repetitivas de refatoração de código em projetos de grande escala.
  • Integração de revisões de código orientadas por IA diretamente em pipelines de CI/CD.
  • Processamento em lote de atualizações de documentação ou resumos de README.
  • Delegação de análises arquiteturais complexas para um processo de agent em segundo plano.
  • Execução de geração de testes automatizados para novos módulos via gatilhos de script.

Como o Cursor CLI Headless funciona

  1. O usuário inicia uma tarefa usando o script wrapper run-task.sh, fornecendo um prompt embutido ou um arquivo de prompt dedicado.
  2. O script configura o ambiente do agent Cursor, garantindo que o diretório de trabalho correto e os parâmetros de modelo sejam aplicados.
  3. O agent headless executa a tarefa solicitada, modificando arquivos diretamente caso a flag force esteja habilitada.
  4. O progresso em tempo real é transmitido via NDJSON, fornecendo visibilidade das chamadas de ferramentas e da atividade do modelo.
  5. Após a conclusão, a skill retorna o resultado final no formato solicitado (texto, JSON ou stream) e encerra com um código de status indicando sucesso ou falha.

Configuração do Cursor CLI Headless

Para começar a usar esta skill da coleção Openclaw Skills, certifique-se de que o Cursor CLI esteja instalado e autenticado:

# Instale o Cursor CLI se estiver faltando
curl https://cursor.com/install -fsS | bash

# Autentique sua conta
agent login

# Verifique a instalação
agent --version

Defina sua CURSOR_API_KEY nas variáveis de ambiente para execução de scripts não interativos.

Esquema de Dados e Taxonomia de Cursor CLI Headless

A skill gerencia dados através de fluxos padrão e formatos de saída específicos para garantir a compatibilidade com ferramentas downstream:

Tipo de Dados Descrição
Input Prompts Suporta arquivos de texto simples (.txt) ou argumentos de string embutidos.
Standard Output Emite NDJSON (padrão), texto simples ou um único objeto JSON.
Standard Error Usado para rastreamento de progresso em tempo real (via jq) e relatório de erros.
JSON Schema Ao usar -o json, retorna um objeto contendo result e duration_ms.

Recursos avançados do Cursor CLI Headless

  • Suporte a saída multiformato (text, json, stream-json) para integração com várias ferramentas de parsing.
  • Suporte para vários modos de execução, incluindo agent, plan e ask.
  • Permissões de modificação de arquivo configuráveis usando as flags force e no-force.
  • Direcionamento de diretório de trabalho contínuo para fornecer ao agent contexto de projeto específico.
  • Streaming de progresso via jq para feedback de terminal de alta visibilidade durante tarefas de longa duração.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*