Best practices

Set your Personal Access Token as an environment variable

Your Specify personal access token must always be private. We highly recommend you to set it in a private environment variable or in a .env file.

Using an .env file in a JavaScript config file

import path from 'node:path';
import process from 'node:process';
import dotenv from 'dotenv';

  path: path.resolve(process.cwd(), '.env.specify-cli'),

export default {
  version: '2',
  repository: '@workspace/repository',
  personalAccessToken: process.env.SPECIFY_ACCESS_TOKEN,
  rules: [],

Using the --personal-access-token CLI flag

You can inject your personal access token through the --personal-access-token, -p CLI flag.

specify pull -p $SPECIFY_TOKEN

You can use this method to sync Specify with git repositories in GitLab, GitHub, Azure DevOps or Bitbucket.

Last updated