State Tool CLI

This quick start is for intermediate or advanced developers who want to get up and running right away.

Install the State Tool

On Linux or macOS:

sh <(curl -q

On Windows:

  1. Run the following as Administrator in PowerShell:

    IEX(New-Object Net.WebClient).downloadString('')
  2. Start the command prompt (cmd.exe) to use the State Tool.

Sign in to the ActiveState Platform

If you don’t have a Platform account yet, you need to sign up:

state auth signup 

Enter the requested information at the prompt to register your account. You will receive an email to verify your account. You have limited permissions to the Platform before you verify it. After registering your account you can sign in.

If you already have an ActiveState Platform account, or you just created an account you need to sign in:

state auth

Enter your username and password for the Platform at the prompts.

Create a new project locally

state init <username_or_org_name>/<project_name> language@version

For example:

state init jsmith/python-3-6 python3@3.6.6

Change directories into your project folder

Linux and macOS:

cd <username_or_org_name>/<project_name>


cd <username_or_org_name>\<project_name>

Push your project to the ActiveState Platform

state push

Add required packages for your project

state packages add requests@2.21.0
state packages add pandas

For Python projects, if you have a requirements.txt file, you can alternatively import all your packages using the file.

state packages import --file requirements.txt

For Perl projects, if you have a cpanfile or META.json file, you can import all your packages using the file.

state packages import --file cpanfile
state packages import --file META.json

Synchronize your local project with the Platform project

state pull

Activate your project

state activate

Access documentation for CLI commands

To learn more about the State Tool commands, run state --help in the terminal.

For help on individual commands, run state COMMAND --help. For example, state packages --help.

For more information on the State Tool and the available commands see the State Tool section of the docs.