Skip to content

CLI Commands

This guide provides a reference for all commands in the deeep CLI.

Run deeep --help or deeep <command> --help at any time for command-specific options.

Global options

OptionDescription
-v, --versionShow the CLI version
-h, --helpShow help information

Commands

deeep auth

Authenticate with deeepSpace. The command prompts for your email and then asks for a one-time verification code sent to your inbox.

Terminal window
deeep auth

deeep init

Initialize the current Git repository as a deeepSpace project. The command walks you through selecting a workspace, choosing or creating a project, and configuring component discovery.

Terminal window
deeep init

Options:

OptionDescription
-f, --forceReinitialize an already linked project
-c, --createSkip the prompt and create a new deeepSpace project from this repository

deeep sync

Scan your local components and sync the component index with the linked deeepSpace project.

Terminal window
deeep sync

Options:

OptionDescription
--dry-runBuild the component index without sending it to deeepSpace

deeep status

Show the current project status, including the linked project name, workspace, and project settings.

Terminal window
deeep status

deeep whoami

Display the email address of the currently authenticated user.

Terminal window
deeep whoami

deeep update

Check for updates and install the latest version of the deeep CLI.

Terminal window
deeep update

deeep logout

Remove locally stored authentication tokens and sign out of deeepSpace.

Terminal window
deeep logout

Common workflow

Terminal window
# Authenticate
deeep auth
# Link or create a project
deeep init
# Sync components
deeep sync
# Check project status
deeep status

For more details about the configuration file, see the Project Settings Reference.