# CLI

The `bcl nodes` command is used to access the Nodes service.

The following operations are supported within `bcl nodes <OPERATION>`

| Operation      | Description                       |
| -------------- | --------------------------------- |
| chains         | Get list of supported blockchains |
| info           | Get information on a node         |
| list (default) | Get list of nodes                 |
| remove         | Remove a node                     |
| services       | Get list of Bloq Node services    |

#### Creating a New Node

Creation of a node must be done through the [Bloq Console](https://console.bloq.cloud/nodes/single/new). For the moment you are not allowed to use the CLI to spin a new node.

> TIP: Once initialization of a node is complete, a node will require some time to catch-up to the latest blocks on the blockchain. A node is created using a recent snapshot of the blockchain and generally needs to catch-up for the last few hours of data.\
> The duration to sync to the latest blockchain data will vary across blockchains. Upon completion of the sync, the node is ready for usage.

#### Listing supported chains

Viewing all blockchains supported by BloqNodes is accessed through the command: `bcl nodes chains`. The user will be able to view the list of all chains that are offered by Bloq Nodes.

#### Getting node information

To retrieve information on a node, use the command: `bcl nodes info`. The user will receive a prompt for the *Node ID*. Upon providing the *Node ID*, the CLI will provide detailed information on the node.

#### Listing nodes

Viewing the list of active nodes is accessed through the command: `bcl nodes list`.\
The user will be able to view the list of nodes including the *Node ID* and the time the node was initialized.

#### Removing a node <a href="#removing-a-node" id="removing-a-node"></a>

To remove a node, use the command: `bcl nodes remove`. The user will receive a prompt for the *Node ID*. Upon providing the *Node ID*, and confirmation for the removal of the node, the node will be removed.

#### Listing Bloq services <a href="#listing-bloq-services" id="listing-bloq-services"></a>

Viewing all services offered by Bloq Nodes is accessed through the command: `bcl nodes services`. The user will be able to view a comprehensive list of all types of nodes that can be accessed by the Bloq Nodes service. Specifications include the chain, region, performance tier, software version, and service id.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloq.com/bloq-services/bloqnodes/cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.