> For the complete documentation index, see [llms.txt](https://docs.specifyapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.specifyapp.com/reference/specify-cli.md).

# Specify CLI

### Global flags

#### `-h, --help`

Show the help

#### `-v, --version`

Show the current version of the CLIx

#### `-C, --config-path [configPath]`

The path to your JSON or Javascript config file, or the folder containing all your configs (default: `.specifyrc.json`)

#### `-p, --personal-access-token <personalAccessToken>`

Your personal access token. . It will try to read it from the env var `SPECIFY_PAT` as well.

{% hint style="info" %}
Need a personal access token? [Generate one ↗](https://specifyapp.com/user/personal-access-tokens)
{% endhint %}

#### `-r, --repository <repository>`

The repository containing the design tokens you're requesting. It follows the pattern `@organizationName/repositoryName`. It will try to read it from the env var `SPECIFY_REPOSITORY` as well.

## Init

Generate a Specify ready-to-use configuration to pull your design data from your Specify repository.

{% hint style="warning" %}
For now it will only generate an empty config file, but we will bring back the template selection soon
{% endhint %}

### Flags

#### `--root [.]`

By default everything is generated in the current dir, but you can choose a different path to generate your configuration file (Default: `.`)

## Pull

Pull the tokens from the repository following the configs

### Flags

*No flags for now*