# Chalk CLI Reference: Getting Started
source: https://docs.chalk.ai/cli#getting-started

Install the Chalk CLI and learn about global flags and options available across all commands.

## `install`
source: https://docs.chalk.ai/cli?command=install

```bash
install
```

Installing Chalk is easy! On Linux and Mac, run the command below to install the latest version of Chalk.

```
$ curl -s -L https://api.chalk.ai/install.sh | sh
```

On Windows, download the latest version of the executable from one of the following links:

```
https://storage.googleapis.com/cli-go.chalk-prod.chalk.ai/latest/chalk-windows-amd64

https://storage.googleapis.com/cli-go.chalk-prod.chalk.ai/latest/chalk-windows-386
```

Subsequent updates for Mac, Linux, and Windows can be installed using [`chalk update`](https://docs.chalk.ai/cli?command=update). After installing, you may need to restart your terminal, or source your shell's rc file (e.g. `~/.bashrc`, `~/.zshrc`, etc.)

**Example**

```
$ curl -s -L https://api.chalk.ai/install.sh | sh
Installing Chalk...
Downloading binary for Darwin arm64... Done!

Version:    v1.33.3
Platform:
Hash:       2e819766273dbc14ab2cd1094a5fbe5ed8fb388b
Build Time: 2025-07-27T16:29:24+00:00
OS:         darwin
Arch:       arm64

Chalk was installed successfully to /Users/emarx/.chalk/bin/chalk-v1.33.3
Run 'chalk --help' to get started.

You may need to open a new terminal window for these changes to take effect.
```

## `chalk`
source: https://docs.chalk.ai/cli?command=chalk

```bash
chalk {command} <arguments> [flags]
```

Chalk is a feature platform for real-time machine learning. Use the CLI to deploy feature pipelines, run queries, and manage your Chalk environment.

**Flags**

- `--branch <branch>` (string)
  Target a specific Chalk branch
- `--environment <env>` (string)
  Target a specific environment
- `--api-host <host>` (string)
  API server URL (for isolated deployments)
- `--grpc-api-host <host>` (string)
  gRPC server URL (for isolated deployments)
- `--client-id <id>` (string)
  Client ID for authentication
- `--client-secret <secret>` (string)
  Client secret for authentication
- `--access-token <token>` (string)
  Access token for authentication (skips token exchange)
- `--web-identity-token-file <path>` (string)
  Path to a file containing a Chalk JWT, re-read as it rotates (skips token exchange)
- `--auth-config-file <path>` (string)
  Path to auth config file (default: ~/.chalk.yml)
- `--json <json>` (bool, default `false`)
  Write machine-readable command results as JSON to stdout
- `--no-spinners <no-spinners>` (bool, default `false`)
  Disable loading spinners (for CI environments)
- `-v, --verbose <verbose>` (bool, default `false`)
  Enable verbose logging
- `--debug <debug>` (bool, default `false`)
  Enable extra verbose logging, including gRPC request/responses and headers (alias: -vv)
- `--skip-version-check <skip-version-check>` (bool, default `false`)
  Disable automatic update checks
- `--dir <path>` (string)
  Working directory for config files
