Skip to content

Getting Started

OpenStatus CLI

You can use the OpenStatus CLI to manage and run your synthetic checks. The CLI is a powerful tool that allows you to interact with OpenStatus from your terminal.

Installation

You can install the OpenStatus CLI using brew.

Terminal window
brew tap openstatus/cli

Terminal window
brew install openstatus

Then you can run the following command to verify the installation.

Terminal window
openstatus --help

You need to get an API token to use the CLI. You can get an API key by signing up on the OpenStatus website.

Settings → API Token → Create API token

You can set the API token using the following command.

Terminal window
export OPENSTATUS_API_TOKEN=your-api-token

or you can set the --access-token option in the CLI command.

Terminal window
openstatus [COMMAND] --access-token your-api-token