> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pluxx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

Use Pluxx in Cursor when you want a native Cursor plugin bundle plus optional Cursor CLI refine and review passes.

## What Cursor Consumes

Pluxx builds the Cursor target into `dist/cursor/`. Cursor consumes:

* `.cursor-plugin/plugin.json`
* `skills/`
* `commands/`
* `agents/`
* `rules/` when `platforms.cursor.rules` is configured
* `hooks/hooks.json`
* `mcp.json`
* `AGENTS.md`

The required manifest is `.cursor-plugin/plugin.json`. Pluxx wires plugin-native rules, hooks, skills, commands, agents, and MCP config from that root.

## Build And Install

```bash theme={null}
npx @orchid-labs/pluxx build --target cursor --install
```

If you already built the bundle, install it directly:

```bash theme={null}
npx @orchid-labs/pluxx install --target cursor
```

Pluxx installs the local Cursor bundle to:

* `~/.cursor/plugins/local/<plugin>`

If the plugin defines local hook commands, add `--trust` or confirm the trust prompt during install.

## Agent-Driven Refinement

Build and install are deterministic. Cursor only does model work when you explicitly run an agent pass:

```bash theme={null}
npx @orchid-labs/pluxx agent prepare
npx @orchid-labs/pluxx agent run review --runner cursor --no-verify
```

Use Cursor for:

* iterative instruction cleanup
* taxonomy review
* host-specific scaffold review

## Cursor-Specific Caveats

* Headless Pluxx runs target the official Cursor CLI binary `agent`. Older installs that only expose `cursor-agent` are still supported as a fallback.
* Real Cursor CLI runs require Cursor auth. Use your normal Cursor CLI login flow or provide `CURSOR_API_KEY` for scripted runs.
* Use the Cursor **app** to verify plugin presence, installed skills, and commands. Cursor CLI is the runner surface for Pluxx agent passes, not the strongest plugin-discovery proof surface.
* Cursor plugin hooks live inside `hooks/hooks.json` in the plugin bundle. Project hooks in `.cursor/hooks.json` are a separate surface and are not auto-installed by Pluxx.
* Cursor subagents under `.cursor/agents` or `~/.cursor/agents` are also separate from the plugin bundle. Pluxx installs plugin `agents/`, not project-level subagents.