Configure the OCP CLI

Development, management, and publication of an Optimizely Connect Platform (OCP) app is performed via the OCP command-line interface (CLI). Follow the steps below to configure and validate your CLI development environment.

Prerequisites

• You need the API key from your invitation email.
• The OCP CLI requires the Node.js 18 JavaScript runtime environment. Find your platform-specific installer here, or use your preferred Node version manager for the install.
• The OCP CLI requires Yarn. Find global install instructions for Yarn here. If you are on Windows, we suggest installing Yarn through Corepack, as described here.

Configure the OCP CLI

You can configure the OCP CLI on either a Mac/Linux machine or a Windows machine. Skip directly to the section that pertains to your environment.

Configure the OCP CLI for Mac/Linux

1. Run the following command to make a .opti directory:

   Shell

   mkdir ~/.opti (home dir)
   

2. Using the API key you received during onboarding, create the credentials file in the .opti directory:

   Shell

   echo '{"apiKey": "value from invitation"}' > ~/.opti/credentials.json
   

3. Run the following Yarn command to install the OCP CLI:

   Shell

   yarn global add @optimizely/opti-cli
   

4. Set your PATH variable:

   Shell

   export PATH="$(yarn global bin):$PATH"
   

5. Set your opti env variable to production:

   Shell

   opti env set production
   

Configure the OCP CLI for Windows

📘

Note

The following instructions are for PowerShell.

1. Run the following command to make a .opti directory:

   PowerShell

   New-Item -Path "~/.opti" -Name "home dir" -ItemType "directory"
   

2. Using the API key you received during onboarding, create the credentials file in the .opti directory:

   PowerShell

   Write-Output '{"apiKey": "value from invitation"}' | out-file "~/.opti/credentials.json" -encoding utf8
   

3. Run the following Yarn command to install the OCP CLI:

   PowerShell

   yarn global add @optimizely/opti-cli
   

4. Ensure the value returned from yarn global bin is on your path:

   PowerShell

   yarn global bin
   

   📘

   Note

   The output should look similar to the following:

   PowerShell

   C:\Users\user\AppData\Local\Yarn\bin
   

5. Set your current location to the path returned above:

   PowerShell

   Set-Location -Path "C:\Users\user\AppData\Local\Yarn\bin"
   

6. Set your opti env variable to production:

   PowerShell

   .\opti env set production
   

Validate the OCP CLI installation

Now you can validate that the OCP CLI is installed correctly. At this point, the same OCP CLI commands work for both Mac/Linux and Windows.

📘

Note

For Windows terminals (specifically PowerShell), you must use .\ before all opti commands. For example, to view your account details, run .\opti accounts whoami.

View your account details

Run the following command to view your account details:

opti accounts whoami

Example output:

Active environment: production
id: <ID Removed>
email: [email protected]
role: developer
apps:
  - id: 
accounts:
  - trackerId: <ID Removed>
    shard: us

Get help and view your environment details

The help context for the OCP CLI is -h. It provides help and information about your environment after any command. Run the following commands to view your environment details and see available commands.

View your environment details:

opti -h

Example output:

Active environment: production
@optimizely/opti-cli  1.0.0-beta.7  (Apache-2.0)
Usage: opti <command>

Namespaces: (`<namespace>` -h, --help for additional help)
  accounts
  app
  availability
  directory
  env

View available commands:

opti app -h

Example output:

Active environment: production
@optimizely/opti-cli  1.0.0-beta.7  (Apache-2.0)
Usage: opti app <command>

Commands:
  startDev, start-dev   Run an app locally
  init                  Create a new app project
  logs                  Fetch app logs
  package               Prepare a package for manual upload
  register              Register an app version
  upload                Validate, package, upload, and build an app to prepare for publishing
  validate              Validate an app locally

opti <command> -h, --help for help on specific commands