Commands

View help page

Lets you view available commands.

xoptcli or xoptcli -h, -help

• Options:
  • -h, -help - view available commands

Set Token for API calls

First generate an API token, then run this command. This will create a hidden directory labeled .optclix with your API token.

xoptcli set-token <token>

• Arguments:
  • <token> - API token generated through Optimizely.
  • Sample Call:

    xoptcli set-token 1:7robo847SYSwow9384GS-Fr488GJslkjLKUIJNkjlkjis_ioi_2

Initialize a new Optimizely X project locally.

Initializes a new Optimizely X project in the directory you are currently in, creating a project.json file with the project_id.

xoptcli init <project_id>

• Arguments:
  • <project_id> – The project ID from optimizely where you want to host experiments in this directory. Required.
  • Type: integer. Example: 1740413223
  • Sample Call:

    xoptcli init 1740413223

Create a local experiment

Creates a local experiment with an "Original" variation that has a starting weight or traffic allocation of 100%. Optimizely uses a scale of 10000, so that's what you will see in original/variation.json. are attached to all variations using experiment.json.

xoptcli experiment <folder> <name> <page_ids>

• Arguments:
  • <folder> – The name of the local directory for the new experiment. Required.
  • Type: string. Example: "robo-test"
  • <name> – The name of the new experiment you will see in Optimizely X. Required.
  • Type: string. Example: "Test3:Funnel"
  • <page_ids> - As many page IDs, but at least one, which to attach to your experiment. Page IDs must be created through Optimizely X before adding them to your experiment. Required.
  • Type: string of comma separated values. Example: "10198685817, 10248681248"
  • Sample Call:

    xoptcli experiment "robo-test" "Test3:Funnel" "10198685817,10248681248"

Create a local variation

Creates a local variation and builds the necessary source files. Setting here will necessitate an update to the other variations so that total adds up to 10000 before pushing to Optimizely.

xoptcli variation <experiment> <folder> <name> <traffic_allocation>

• Arguments:
  • <experiment> - The directory for this experiment. Required.
  • Type: directory name as a path. Example: roboboogie-test/
  • <folder> - The name of the local folder for the new variation. Required.
  • Type: string. Example: "variation-1"
  • <name> – The name of the new variation you will see in Optimizely X. Required.
  • Type: string. Example: "v:1 variation directory name"
  • <traffic_allocation> - The weight or traffic allocation allotted to the variation with a total adding up to 10000.
  • Type: string. Example: "5000"
  • Sample call:

    xoptcli variation roboboogie-test/ "variation-1" "v:1 variation directory name" "5000"

Push experiment to Optimizely X

Creates or udates an experiment and all variation to your Optimizely X project. On create, it will assign a default metric "Overall Revenue", because it is required by the API to have a metric. With the -m option you can push metrics with experiments. This is really helpful for adding groups of metrics at once, like checkout funnel metrics.

xoptcli push-experiment <path>

• Options:
  • -m, --metrics – push with metrics (will overwrite remote metrics).
• Arguments:
  • <path> - the path to the directory of the experiment you want to push.
  • Type: directory name as a path. Example: roboboogie-test/
  • Sample Call:

    xoptcli push-experiment roboboogie-test/

Pull Experiment

Pulls a specific experiment to a specific file, allowing you to sync whats on Optimizely X with your local project folder. As of right now we do not support multiple versions of code for different pages in the same experiment (it's even confusing to type that out!). We do support pulling metrics though!

xoptcli pull-experiment <folder> <experiment_id>

• Options:
  • -m, --metrics – pull with metrics (syncing with local metrics). Unfortunately the experiment api does not return the name of a metric. If it exists locally it will retain the name, but otherwise it may be preferable to search for the event_id within your "pull-pages -m" output.
• Arguments:
  • <folder> - name of folder where you want put the experiment, will write over experiment. Required.
  • Type: string. Example: "my-great-experiment"
  • <experiment_id> - id of experiment you want pulled.
  • Type: integer. Example: 11124913096
  • Sample Call:

    xoptcli pull-experiment "my-great-experiment" 11124913096

Pull all pages for a project

Pulls all pages for a project into a single json file with the option for metrics attached to those pages. This is mostly for reference.

xoptcli pull-pages [options] <file>

• Options:
  • -m – Pull all metrics with pages.
• Arguments:
  • <file> - name of file where you want to store the json dump. Required.
  • Type: string. Example: "pages.json"
  • Sample Call:

    xoptcli pull-pages -m pages.json

Host variation locally

Host a variation locally. Add xoptcli=activate as a parameter after you've run the command below and your preferred extension will inject the CSS and JS of the variation you choose. Or point your browser at http(s)://localhost:8080 (default port) for usage info. If you are using the -s option, your browser may need you to give it permission to load unsafe scripts before script injection can take place. You can do that by going to http(s)://localhost:8080 and toggeling the advanced section and then clicking the "proceed to unsafe localhost" option.

xoptcli host [option] <path> [port]

• Options:
  • -s --ssl – host over https
• Arguments:
  • <path> - the path to the directory of the variation you want to host. Required.
  • Type: directory name as a path. Example: roboboogie-test/variation-1
  • <port> - the port where you want to host the server. Optional: Default is 8080.
  • Type: integer. Example: 8082
  • Sample Call:

    xoptcli host -s roboboogie-test/variation-1/ 8082