Comparison between CLIs
StackState Self-hosted v5.0.x
StackState has a new CLI! The new CLI has many advantages and a few notable differences.
stsCLI has been built for a reason. Here are the major advantages of switching:
- Easy installation and configuration for all Operating Systems
- Native macOS support
- Faster releases - the CLI is versioned independently of the StackState product
- Backwards as well as forwards compatible with StackState versions
- Machine readable output for every command
- Many UX improvements, including syntax highlighting, auto-completion and progress bars.
- SaaS support
stac, the new
stsCLI will not have commands for sending data to StackState. For these purposes, you can use either the StackState Agent or the StackState Receiver API.
- Some commands have been renamed to fall more in line with how we think of StackState today. For example, the old command
stac graphis now called
- The new
stsCLI only works with StackState v5.0 or later.
CLI: sts (new)
There are now two versions of the StackState CLI and the old version of the CLI has been renamed:
- The new CLI is called
sts- note that this name was used by the old CLI in previous releases of StackState.
- The old CLI has been renamed to
stac, this allows you to have the old CLI and new CLI installed on the same machine.
You can check which version of the
stsCLI you are running with the following command:
# new `sts` CLI - example output:
VERSION | BUILD DATE | COMMIT
1.0.0 | 2022-06-24T12:26:50Z | 6553352125d31a46c4790068e36c8eca32ace7fd
# old `sts` CLI - example output:
usage: cli.py [-h] [-v] [-i [INSTANCE]] [-c [CLIENT]]
# no `sts` CLI installed - example output:
command not found: sts
If you are not running the new
stsCLI yet, we recommend that you:
stsCLI will completely replace the old
stacCLI. Not all commands have been moved to the new CLI yet and some commands are not available in the old CLI. The following table gives an overview of the commands available in each CLI and the current
- 🚧 - Work in progress.
- ❌ - Command will not be available in this CLI.