> ## Documentation Index
> Fetch the complete documentation index at: https://docs.state.space/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Reference

> Learn how to use the State Space CLI to take advantage of powerful features.

## Install State Space CLI

<CodeGroup>
  ```bash Install theme={null}
  brew install state-space/state-space/cli
  ```

  ```bash Update theme={null}
  brew upgrade state-space/state-space/cli
  ```
</CodeGroup>

## Usage

```bash theme={null}
Usage:
  state-space [command]

Examples:
  state-space init	# Initialize a configuration file
  state-space push	# Pushes contract sources and deployments

Commands:
  init        Creates an empty config file
  push        Push contract source and deployments.

Authentication:
  login       Login to State Space
  logout      Logout of State Space

Additional Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command

Flags:
      --config string   configuration file
  -h, --help            help for state-space
      --verbose         enable verbose logging
  -v, --version         version for state-space

Use "state-space [command] --help" for more information about a command.

```

## Updating settings in `state-space.toml`

Visit the configuration settings section [here](/docs/cli/settings).