Specify use a Personal Access Token for the authentication. You can create it from the dedicated page on the web app. Once you have a personal access token, you can use it in two ways:

You can use the environment variable named SPECIFY_PAT

SPECIFY_PAT=xxxxxxxxxxxxxxxxxx specify pull


If you prefer a flag, you can use --personal-access-token or -p

specify --personal-access-token xxxxxxxxxxxxxxxxxx pull

You can also write the personal access token directly in the config file.

The personal access token in a config file is useful if you need to execute some custom business logic. To stay safe, you should use a library like dotenv to store credentials outside of the code.

    "repository": "<@your-organization/your-repository-name>"
    "version": "2",
    "personalAccessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    "rules": []

If multiple credentials are used together, Specify will choose following this order:

  1. the flag

  2. the configuration file

  3. the environment variable

Last updated