# Installation & Setup

`@maestria/cursor` is a declarative Cursor plugin: a manifest, agents, an orchestrator skill, global rules, and slash commands. There is no `npm install` of a runtime SDK for end users.

## Prerequisites

- **Cursor IDE** and/or **Cursor CLI** (`agent` on `$PATH`)
- No Node toolchain required for end-user install

## Installation via CLI (Recommended)

```bash
pnpx maestria@latest install cursor
pnpx maestria@latest status
```

The CLI pulls `@maestria/cursor` from npm (`npm pack @maestria/cursor@latest`)
and extracts it into `~/.cursor/plugins/local/maestria`.

### Updating

```bash
pnpx maestria@latest update cursor
pnpx maestria@latest status
```

To pin to a specific version:

```bash
pnpx maestria@latest update cursor@0.1.0
```

**Restart required:** Restart Cursor IDE after install so Customize → Plugins picks up the local plugin. For CLI, pass
  `--plugin-dir` or rely on the local plugins directory.

<details>
<summary>Alternative: Manual setup from a monorepo checkout</summary>

1. **Copy the plugin**

   ```bash
   mkdir -p ~/.cursor/plugins/local/maestria
   cp -a packages/cursor/. ~/.cursor/plugins/local/maestria/
   ```

2. **Or run without installing**

   ```bash
   agent --plugin-dir ./packages/cursor
   ```

3. **Verify**

   In Agent chat, confirm `/fein`, `/sonar`, `/blitz`, `/orchestrate` appear, and that specialist agents (builder, reviewer, …) are available.

</details>

### CLI Agent Invocation

When running Cursor CLI (`agent`) with the plugin:

```bash
agent --plugin-dir ~/.cursor/plugins/local/maestria
```

For non-interactive usage (CI, scripts):

```bash
echo "your prompt" | agent --plugin-dir ~/.cursor/plugins/local/maestria --cli-mode
```

## What gets installed

| Path                           | Purpose                  |
| ------------------------------ | ------------------------ |
| `.cursor-plugin/plugin.json`   | Plugin manifest          |
| `agents/*.md`                  | 7 specialist Task agents |
| `skills/orchestrator/SKILL.md` | Dispatcher methodology   |
| `rules/maestria-global.mdc`    | Always-on global rules   |
| `commands/*.md`                | Workflow slash commands  |

## Uninstall

```bash
pnpx maestria@latest uninstall cursor
```

## Next steps

Continue to the [Quick Start](/cursor/getting-started/quick-start/) to run your first pipeline.