# cursorcli-plugin-cc

**Repository Path**: xrz_admin/cursorcli-plugin-cc

## Basic Information

- **Project Name**: cursorcli-plugin-cc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-29
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cursor CLI plugin for Claude Code

Use Cursor CLI (`agent`) from inside Claude Code for code reviews or to delegate tasks.

This plugin is for Claude Code users who want an easy way to start using Cursor CLI from the workflow they already have.

## What You Get

- `/cursorcli:help` — list slash commands; `/cursorcli:help review` for details
- `/cursorcli:setup` — check Cursor CLI install and login
- `/cursorcli:review` — read-only review (`agent -p --mode ask --trust`)
- `/cursorcli:adversarial-review` — structured challenge review
- `/cursorcli:rescue` — delegate writable tasks (`--trust --force --approve-mcps`)
- `/cursorcli:status`, `/cursorcli:result`, `/cursorcli:cancel` — job management
- `/cursorcli:followup`, `/cursorcli:adopt`, `/cursorcli:doctor`, `/cursorcli:models`, `/cursorcli:cleanup`
- `/cursorcli:workflow` — local multi-agent DAGs (approve before run; never auto-merge)
- `/cursorcli:transfer` — official import unsupported; optional `--lossy` transcript bootstrap

## Requirements

- **Cursor account** — `agent login` or `CURSOR_API_KEY`
- **Node.js 18.18 or later**
- **Git** — review commands need a git repository

## Install Cursor CLI

macOS / Linux / WSL:

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

Windows PowerShell:

```powershell
irm 'https://cursor.com/install?win32=true' | iex
```

Then sign in:

```bash
agent login
```

## Install the plugin

```bash
/plugin marketplace add <owner>/cursorcli-plugin-cc
/plugin install cursorcli@cursorcli
/reload-plugins
/cursorcli:setup
```

## Usage

### `/cursorcli:help`

Lists every `/cursorcli:*` command. Pass a name for details:

```bash
/cursorcli:help
/cursorcli:help review
/cursorcli:help workflow
```

### `/cursorcli:review`

Read-only review of your current git state. Output is **verbatim** from Cursor CLI; Claude must not auto-fix afterward.

```bash
/cursorcli:review --wait
/cursorcli:review --background
/cursorcli:review --base main
```

### `/cursorcli:adversarial-review`

Structured review with `verdict` / `findings` / `next_steps`. Supports focus text after flags.

```bash
/cursorcli:adversarial-review --wait challenge the retry design
```

### `/cursorcli:rescue`

Delegates to the `cursorcli:cursor-rescue` subagent, which forwards once to `cursor-companion.mjs task`.

```bash
/cursorcli:rescue --background investigate flaky test failures
/cursorcli:rescue --resume
/cursorcli:rescue --fresh fix the auth bug
```

Rescue defaults to write-capable runs (`--write` → `--force --approve-mcps`).

### Job commands

```bash
/cursorcli:status
/cursorcli:status <job-id> --follow
/cursorcli:result
/cursorcli:cancel <job-id>
/cursorcli:followup <job-id> continue with tests
/cursorcli:doctor
/cursorcli:workflow list
/cursorcli:workflow run-preset parallel-review
```

Writable parallel work uses isolated `--worktree`s. Integrate only with `/cursorcli:adopt <job-id> --confirm`.

Completed jobs include `agent --resume <session_id>` when Cursor CLI returns a session id.

## Testing

```bash
npm test
```

Tests use `tests/fake-agent-fixture.mjs` via `CURSOR_AGENT_BIN` — no real model API calls.

## Documentation

- [docs/REQUIREMENTS.md](docs/REQUIREMENTS.md)
- [docs/DESIGN.md](docs/DESIGN.md)
- [AGENTS.md](AGENTS.md)