Xpersona
C

Cursor CLI Agent

CLAWHUB · Unverified

A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide). Skill: Cursor CLI Agent Owner: swiftlysingh Summary: A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide). Tags: latest:2.1.0 Version history: v2.1.0 | 2026-01-13T21:19:51.701Z | user Add tmux automation guide for AI agents - Cursor CLI requires real TTY for automated execution v2.0.0 | 2026-01-13T20:46:38.656Z | user I

62
Rank
84
Safety
13k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 13.2K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s172v8dwtevweqy5xqnkq7yfyd884py9:cursor-agent
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-swiftlysingh-cursor-agent-or-agent-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

19,340 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: cursor-agent
version: 2.1.0
description: A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).
author: Pushpinder Pal Singh
---

# 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.

## Installation

### Standard Installation (macOS, Linux, Windows WSL)

```bash
curl https://cursor.com/install -fsS | bash
```

### Homebrew (macOS only)

```bash
brew install --cask cursor-cli
```

### Post-Installation Setup

**macOS:**
- Add to PATH in `~/.zshrc` (zsh) or `~/.bashrc` (bash):
  ```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:

```bash
agent login
```

Or use API key:

```bash
export CURSOR_API_KEY=your_api_key_here
```

## Update

Keep your CLI up to date:

```bash
agent update
# or
agent upgrade
```

## Commands

### Interactive Mode

Start an interactive session with the agent:

```bash
agent
```

Start with an initial prompt:

```bash
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:

```bash
agent models
# or
agent --list-models
```

Use a specific model:

```bash
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:

```bash
agent -p

README.md

# Cursor CLI Agent Skill

This repository contains the definition and documentation for the `cursor-agent` skill, updated for 2026 features.

## Overview

The `cursor-agent` skill encapsulates workflows and commands for the Cursor CLI, enabling efficient AI-pair programming directly from the terminal. This skill includes all modern features from the January 2026 update.

## What's New in v2.0.0

- **Model Switching**: Switch between AI models with `agent models`, `--model` flag, and `/models` command
- **MCP Management**: Enable/disable MCP servers on the fly with `/mcp enable` and `/mcp disable`
- **Rules & Commands**: Create and edit rules directly from CLI with `/rules` and `/commands`
- **Modern Command Interface**: Use `agent` as the primary command (backward compatible with `cursor-agent`)
- **Enhanced Headless Mode**: New flags including `--force`, `--output-format json`, and `--stream-partial-output`
- **Interactive Features**: Context selection with `@`, slash commands, and keyboard shortcuts
- **Cross-Platform Support**: Complete instructions for macOS (including Homebrew), Linux/Ubuntu, and Windows WSL

## Contents

- **SKILL.md**: The core skill definition file containing all commands, workflows, and usage instructions
- **README.md**: This file, providing an overview and quick reference

## Quick Start

Install the Cursor CLI:
```bash
# Standard installation (macOS, Linux, WSL)
curl https://cursor.com/install -fsS | bash

# Homebrew (macOS only)
brew install --cask cursor-cli
```

Authenticate:
```bash
agent login
```

Start an interactive session:
```bash
agent
```

Switch models:
```bash
agent models
```

## Usage

Refer to `SKILL.md` for comprehensive instructions on:
- Installation and authentication
- Interactive and non-interactive modes
- Model switching and configuration
- MCP server management
- Rules and commands creation
- Slash commands and keyboard shortcuts
- Workflows for code review, refactoring, debugging, and CI/CD integration

_meta.json

{
  "ownerId": "kn77723dp6c19p441g3hnpfaw17yr5wz",
  "slug": "cursor-agent",
  "version": "2.1.0",
  "publishedAt": 1768339191701
}

skill-card.md

## Description:

A comprehensive skill for using the Cursor CLI agent for various software engineering tasks, including 2026 features and tmux automation guidance.

This skill is ready for commercial/non-commercial use.

## Publisher:

[swiftlysingh](https://clawhub.ai/user/swiftlysingh)

### License/Terms of Use:


## Use Case:

Developers and engineers use this skill to operate Cursor CLI from the terminal for software engineering workflows, including installation, authentication, model and session management, code review, refactoring, debugging, and CI-style automation.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Installer commands may execute unverified remote code when using curl piped directly to a shell.

Mitigation: Prefer a package-managed or verified Cursor CLI installer and review installation scripts before execution.

Risk: Workspace trust automation and force mode can bypass human review or apply changes in an unreviewed repository.

Mitigation: Use controlled branches or sandboxes, avoid force mode unless rollback is available, and review resulting changes before merging or deploying.

Risk: Automated Cursor CLI runs can hang when launched without a real terminal.

Mitigation: Run automated invocations through a managed TTY such as tmux, monitor execution with timeouts, and capture output for review.

## Reference(s):

- [Cursor CLI Agent on ClawHub](https://clawhub.ai/swiftlysingh/skills/cursor-agent)
- [Cursor CLI Installer](https://cursor.com/install)

## Skill Output:

**Output Type(s):** [Guidance, Shell commands, Configuration instructions]

**Output Format:** [Markdown with inline shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Includes Cursor CLI examples for text, JSON, and streaming JSON modes; the skill itself emits guidance rather than a structured API response.]

## Skill Version(s):

2.1.0 (source: frontmatter and server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Cursor CLI Agent and adjacent AI workflows.