# BH CLI Overview

> Overview of BH CLI

## Overview

The BH CLI is a command-line interface tool that allows you to interact with the
BH platform from your terminal. It provides various commands to make it easier
to directly dispatch the scan, download run artifacts, blobs, and more without
having to use the browser.

To learn more about what [BH](https://github.com/bountyhub-org/bh) does, visit
the [Commands](/bh/commands) page.

### Installation

You can install the BH CLI in various ways.

#### Using cargo

If you have Rust and Cargo installed, you can install the BH CLI using the
following command:

```bash
cargo install bh
```

#### From the source

You can also build the BH CLI from the source code. First, clone the repository:

```bash
git clone https://github.com/bountyhub-org/bh.git
cd bh
```

Then, build the BH CLI using Cargo:

```bash
cargo install --path .
```

#### Downloading pre-built binaries

You can download pre-built binaries for your operating system from the
[releases page](https://github.com/bountyhub-org/bh/releases). Choose the
appropriate binary for your OS, download it, and add it to your system's PATH.

### Configuration

Before using the BH CLI, you need to configure it with your BH API token. You
can obtain your API token from your
[BountyHub profile settings](https://bountyhub.org/settings?tab=developer).

When there, you have to provision the new Personal Access Token with the
required scopes. More about Personal Access Tokens can be found on
[Developer Overview](/developer/overview) page, while scopes you can configure
can be found on the [Developer Scopes](/developer/scopes) page.

Once the Personal Access Token (PAT) is created, you can add it as an
environment variable.

For example, if you are using bash, you can add the following line to your
`~/.bashrc` file:

```bash
echo "BOUNTYHUB_TOKEN='your_personal_access_token_here'" >> ~/.bashrc
source ~/.bashrc
```

## Next steps

- [BH Commands](/bh/commands): Explore the various commands available in the BH
CLI to interact with the BountyHub platform.
- [BH CLI Examples](/bh/examples): Task-based examples for scans, artifacts,
blobs, and runners.
- [Developer Overview](/developer/overview): Learn more about BountyHub's
developer features, including API usage and integration options.