CLI Reference

Overview

The Cursorist CLI (cursorist) manages authentication, plugin deployment, and local plugin workflows. Install it globally or use via npx:

npx cursorist <command> [options]

Authenticate with GitHub via OAuth. Opens a browser to complete the flow and stores tokens in ~/.cursorist/config.json.

cursorist login

Option	Description
(none)	Interactive OAuth flow

Show authentication status, default org/team, plugin mode, and organization list.

cursorist status

Output includes:

Scaffold a plugin structure with manifest and starter component files. Prompts for organization, team, profile name, and components to include.

cursorist plugin init

Requires: Authentication

Creates:

Deploy a plugin bundle to Cursorist. Creates or updates the plugin and uploads a new version with assets.

cursorist plugin deploy --org <org> --team <team> --plugin <plugin> [options]

Option	Required	Description
`--org <org>`	Yes	Organization slug
`--team <team>`	Yes	Team slug
`--plugin <plugin>`	Yes	Plugin slug
`--dir <dir>`	No	Plugin root directory (default: cwd)
`--description <text>`	No	Override plugin description
`--type <type>`	No	Plugin type
`--stack <list>`	No	Comma-separated stack (e.g. `typescript,react`)
`--version <version>`	No	Version override (default: from manifest)

Example:

cursorist plugin deploy --org acme --team eng --plugin my-starter --description "Team standards"

List plugins in a team.

cursorist plugin list --org <org> --team <team>

Option	Required	Description
`--org <org>`	Yes	Organization slug
`--team <team>`	Yes	Team slug

Example:

cursorist plugin list --org acme --team eng

Uses default_org and default_team from config when options are omitted (if set).

Validate local plugin manifest and assets before deploying.

cursorist plugin validate [--dir <path>]

Option	Required	Description
`--dir <dir>`	No	Plugin root directory (default: cwd)

Example:

cursorist plugin validate
cursorist plugin validate --dir ./my-plugin

Download the latest stable version of a plugin and update local files.

cursorist plugin upgrade --org <org> --team <team> --plugin <plugin> [options]

Option	Required	Description
`--org <org>`	Yes	Organization slug
`--team <team>`	Yes	Team slug
`--plugin <plugin>`	Yes	Plugin slug
`--dir <dir>`	No	Plugin root directory (default: cwd)

Example:

cursorist plugin upgrade --org acme --team eng --plugin my-starter

Config is stored at ~/.cursorist/config.json:

{
  "default_org": "acme",
  "default_team": "engineering",
  "default_plugin": "acme-engineering-starter",
  "plugin_mode": true
}

Field	Description
`default_org`	Default organization slug
`default_team`	Default team slug
`default_plugin`	Default plugin name
`plugin_mode`	Whether plugin-first workflow is enabled

Auth tokens (access_token, refresh_token, user_id) are also stored here after cursorist login.

These commands are deprecated. Use the plugin equivalents instead.

Migration: Replace the old command with the new one. For example:

# Before
cursorist deploy --org acme --team eng --plugin my-plugin

# After
cursorist plugin deploy --org acme --team eng --plugin my-plugin

The deprecated commands still work but print a warning and delegate to the new implementation where applicable.