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)

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

pnpx maestria@latest update cursor
pnpx maestria@latest status

To pin to a specific version:

pnpx maestria@latest update [email protected]

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.

Alternative: Manual setup from a monorepo checkout

1. Copy the plugin

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

2. Or run without installing

   agent --plugin-dir ./packages/cursor

3. Verify

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

CLI Agent Invocation

When running Cursor CLI (agent) with the plugin:

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

For non-interactive usage (CI, scripts):

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

pnpx maestria@latest uninstall cursor

Next steps

Continue to the Quick Start to run your first pipeline.