Cursorist CLI

Plugin-first command-line tool for publishing and managing Cursor plugin bundles.

Installation

npm install -g cursorist
# or
npx cursorist <command>

Authentication

cursorist login

Core Commands

• cursorist plugin init - scaffold .cursor-plugin/plugin.json and starter assets
• cursorist plugin validate - validate local manifest and plugin assets
• cursorist plugin deploy --org <org> --team <team> --plugin <slug> - publish a plugin version
• cursorist plugin list --org <org> --team <team> - list team plugins
• cursorist plugin upgrade --org <org> --team <team> --plugin <slug> - sync local assets to latest stable version
• cursorist status - auth/config/plugin mode status

Deprecated Commands

• cursorist deploy
• cursorist list
• cursorist init

These are retained as compatibility wrappers and print migration warnings.

Generated Structure (plugin init)

.cursor-plugin/plugin.json
rules/project-standards.mdc
skills/project-lead/SKILL.md
commands/refresh-standards.md
mcp/cursorist.mcp.json

Config

Global config: ~/.cursorist/config.json

{
  "access_token": "...",
  "refresh_token": "...",
  "user_id": "...",
  "default_org": "myorg",
  "default_team": "frontend",
  "default_plugin": "myorg-frontend-starter",
  "plugin_mode": true
}