Skip to main content
Reference for all Sparkle CLI commands, options, and supported IDE values.

Command overview

CommandDescription
sparkle loginAuthenticate with Sparkle via browser OAuth
sparkle setupConfigure supported AI coding tools with Sparkle
sparkle statusShow login and setup state
sparkle logoutSign out or remove config for all IDEs/coding agents or specific one

sparkle login

Authenticate with Sparkle and store your session locally.
sparkle login
Opens your browser to complete OAuth sign-in. Session data is saved under ~/.sparkle/.

sparkle setup

Wire up supported tools with the Sparkle MCP server, IDE hooks, and guardrail rules. Configure all detected tools:
sparkle setup
Configure a specific tool:
sparkle setup --ide cursor

Options

OptionDescription
--ide <value>Target a specific IDE. See Supported IDEs.

sparkle status

Show whether you are logged in and which tools are configured.
sparkle status

sparkle logout

Sign out of Sparkle on your machine.
sparkle logout
Remove Sparkle configuration for one tool:
sparkle logout --ide cursor

Options

OptionDescription
--ide <value>Remove config for a specific IDE only

Supported IDEs/Coding Agents

Tool--ide value
Cursorcursor
Claude CodeclaudeCode
Windsurfwindsurf
Codexcodex

Requirements

Install CLI

Install the CLI on your machine.

Using the CLI

Typical CLI workflows and setup.