Using the CLI

Use the Sparkle CLI to sign in, configure your AI coding tools, and verify that guardrails are active in your local workflow.

Quick start

Authenticate with Sparkle via browser OAuth:

sparkle login

Your session is stored locally under ~/.sparkle/.

Set up your tools

Configure all detected AI coding tools:

sparkle setup

sparkle setup auto-detects installed tools and wires each one with the Sparkle MCP server, IDE hooks, and guardrail rules.

Verify status

Check your login and setup state:

sparkle status

This shows whether you are logged in and which tools are configured.

To set up one tool instead of all detected tools, pass the --ide flag:

sparkle setup --ide cursor

See Supported IDEs for all --ide values.

Sign out machine-wide:

sparkle logout

To remove Sparkle configuration for a single tool:

sparkle logout --ide cursor

When you run sparkle setup, the CLI:

You can also use the Sparkle Guardrails extension for VS Code, Cursor, and Windsurf. The extension bundles this CLI and delegates setup to it.