CLI
Quick Start

Get started with the Blockless CLI

The Blockless CLI is a command line tool that makes it simple to use the Blockless Network and manage your apps.

With the Blockless CLI, you can connect to the network with your on-chain identity, quickly set up a local worker environment, and build, test, deploy, and monitor your projects right away.

Install the Blockless CLI

With curl:

sudo sh -c "curl -sSL https://raw.githubusercontent.com/BlocklessNetwork/cli/main/download.sh | bash"

Or with wget:

sudo sh -c "wget <https://raw.githubusercontent.com/BlocklessNetwork/cli/main/download.sh> -v -O download.sh; chmod +x download.sh; ./download.sh; rm -rf download.sh"

To install on Windows, go to the releases page (opens in a new tab) on GitHub and download the x86 version of the Blockless CLI. Currently, the Windows ARM64 version is not supported.

Usage

To use the BLS CLI, open a terminal and run $ bls followed by the command you want to use. The command structure is as follows:

bls [command] [subcommand]

For example, to connect to the Blockless Network, you can run the $ bls login command:

bls login

Alternatively, you can use the $ bls function init command to initialize a new local project:

bls function init

Help

To see a list of available commands, you can run the $ bls or $ bls help command:

bls help

You can also use the -h or --help flag after any command or subcommand to display usage information. For example:

bls function -h
bls function init -h

Top level commands

The Blockless CLI provides a range of commands for managing your account, local components, and projects. For detailed reference, please visit the Blockless CLI Reference (opens in a new tab).

Below is a list of commonly used commands:

  • bls help: Displays information and usage instructions for the Blockless CLI and its available subcommands.
  • bls console: Opens the Blockless console, a web-based interface for managing your deployments and projects on the Blockless Network.
  • bls login: Authenticates and logs in to the Blockless Network using your wallet keypair.
  • bls whoami: Shows information about your current identity on the Blockless Network, including your public key.
  • bls components: Manages your local environment components, including the local worker agent and orchestrator agent. Note: If this is your first time building and testing your function, you need to use the $ bls components install command to install the local runtime components (which include the Blockless WASM Runtime Environment and the b7s networking module).
  • bls function: Build, test, and manage your projects and functions.

Global flags

Other than the help (-h or --help) global flag, there are two more flags that you can use globally.

-yes flag

You can use -y or --yes flag to set all options to the default value. For example:

bls function deploy -y

-version flag

  • v or -version flag can be used to verify the current version of the Blockless CLI:
bls -v
© 2023 TX Labs Foundation Ltd.