Activate a project
Usage
state activate [flags] <org/project>
Arguments
<org/project>
(optional) The namespace of the project that you wish to
activateFlags
--path
Where to install the project--default
Configures the project to be the global default project--branch
Defines the branch to be usedExample
state activate ActiveState/Python-3.9 --default
Intercept and run a script via a project runtime environment
Usage
state exec [flags]
Flags
--path
The path of the project that you want to use the runtime environment
of. If no path is given the current working directory is used.Example
state exec python script.py
List your projects
Usage
state projects
List all projects, including ones you have not checked out locally
Usage
state projects remote
Run your project scripts
Usage
state run <script>
Arguments
<script>
Name of script to runExample
state run build
Import packages from a list of dependencies
Usage
state import [flags] <File>
Arguments
<File>
The file to importFlags
--force
Run import operation without promptsExample
state import requirements.txt
Add a new package to your project
Usage
state install <name[@version]>
Arguments
<name[@version]>
Package name and optionally the desired versionLists packages used in your project
Usage
state packages [flags]
Flags
--commit
The commit that the listing should be based on--package
The filter for package names to include in the listing--namespace
The namespace packages should be listed fromRemove a package from your project
Usage
state uninstall <name>
Arguments
<name>
Package nameAuthenticate against the ActiveState Platform
Usage
state auth [flags]
Flags
--token
The API Token generated via the ActiveState
Platform--username
The username to authenticate with--password
The password to authenticate with--totp
The TOTP code generated via two-factor authentication
(must be used in conjunction with username and password flags)--prompt
Sign in via your terminal, rather than your web browser.Logout
Usage
state auth logout
Signup a new account
Usage
state auth signup [flags]
Flags
--prompt
Sign up via your terminal, rather than your web browser.Fork an existing ActiveState Platform project
Usage
state fork [flags] <org/project>
Arguments
<org/project>
The namespace of the project to be forkedFlags
--org
The organization to fork the project to--name
The name of the new project to be created--private
Denotes if the forked project will be privateExample
state fork ActiveState/Python-3.9 --org MyOrg --name Python
View history of the active or given project
Usage
state history [flags]
Flags
--namespace
The namespace to view the history for in the format of <
org/project>Pull in the latest version of your project from the ActiveState Platform
Usage
state pull [flags]
Flags
--set-project
Pull from the specified project instead of the checked out onePush your latest changes to the platform
Usage
state push <org/project>
Arguments
<org/project>
(optional) The project to push to (uses project under current
dir otherwise).Reset local checkout to be equal to the project on the platform.
Usage
state reset
Revert a commit
Usage
state revert <commit-id>
Arguments
<commit-id>
The commit ID to revert toRemoves cached Runtime Environments
Usage
state clean cache <org/project>
Arguments
<org/project>
(optional) The project to be removed from the local cache.Removes global State Tool configuration. Project configuration will not be affected.
Usage
state clean config [flags]
Flags
--force
, -f
Run clean config operation without prompts and ignoring any
errors stopping running servicesRemove the State Tool, installed languages, and any configuration files
Usage
state clean uninstall [flags]
Flags
--force
, -f
Run uninstall operation without prompts and ignoring any errors
stopping running servicesPrint config values to the terminal
Usage
state config get <key>
Arguments
<key>
Config keyExample
state config get autoupdate
Set config values using the terminal
Usage
state config set <key> <value>
Arguments
<key>
Config key<value>
Config valueExample
state config set optin.unstable true
Print jwt credentials
Usage
state export jwt
Create and print new API key
Usage
state export new-api-key <name>
Arguments
<name>
API key nameExports the private key, useful if you want to set it via environment variable ( ACTIVESTATE_PRIVATE_KEY)
Usage
state export private-key
Read the State Tool cheat sheet to learn about common commands
Usage
state learn
Updates the State Tool to the latest available version
Usage
state update [flags]
Flags
--set-channel
Switches to the given update channel, eg. ‘release’.--set-version
Switches to the given State Tool version.Lock the State Tool at the current version, this disables automatic updates.
Usage
state update lock [flags]
Flags
--set-channel
Switches to the given update channel, eg. ‘release’.--force
Automatically confirm that you would like to update the State Tool
version that your project is locked to.