spark status

Show version, authentication, and configuration status.

Synopsis

spark status

Description

spark status displays a complete overview of your Spark CLI installation. It shows the installed version, whether a newer version is available, your authentication status, IDE integration configuration, and skills version.

This is the go-to diagnostic command. If something is not working, run spark status first to identify the issue — whether it is an outdated CLI, missing authentication, or a misconfigured integration.

The command checks the Spark API for the latest available version, so it requires network connectivity. If the API is unreachable, it still shows local information with a connectivity warning.

Arguments

This command has no arguments.

Flags

This command has no additional flags beyond global flags.

Example output

spark status

Spark CLI v1.4.2
Latest version: v1.4.2 (up to date)

Auth: authenticated
User: you@example.com

IDE: Claude Code
  Plugin: v1.2.0 (installed)
  Skills: v1.3.1

Project: enabled
  Config: .spark/settings.json

What each field means

Field	Description
Spark CLI version	The currently installed CLI version.
Latest version	The latest version available on npm. Shows if an update is needed.
Auth	Whether you are authenticated. Shows user email if logged in.
IDE	Which IDE integration is configured.
Plugin/Skills	Version of the installed IDE integration.
Project	Whether Spark is enabled for the current project directory.

Examples

Quick health check

spark status

Check if an update is available

spark status | grep "Latest version"

Use in CI to verify setup

spark status --no-color

Related commands

spark update — Update CLI and integrations
spark whoami — Quick authentication check
spark init — Set up IDE integration
Global Flags — Flags available on all commands

spark disable spark update