---
title: tb
meta:
    description: Root command for the Tinybird CLI
---

# tb

`tb` is the root command for the Tinybird CLI.

## Usage

Run `tb` without a subcommand to see help:

```bash
tb
```

Use subcommands for specific actions, for example:

```bash
tb init
tb build
tb deploy
tb test run
```

{% callout type="info" %}
`tb --prompt` and interactive AI mode are no longer available.
{% /callout %}

## Common root options

Global options are passed before the subcommand. For example:

```bash
tb --cloud deploy
tb --branch=my_feature build
tb --output json deployment ls
```

## Examples

```bash
tb --help
tb --version
tb init --type cli --dev-mode manual
tb --cloud deploy
```

For the full list of global flags, see [Global options](/forward/dev-reference/commands/global-options).

## Environment support

{% table %}
  * Environment
  * Supported
  * Description
  ---
  * `--local`
  * ✓ Yes
  * Selects Tinybird Local as the target for the subcommand.
  ---
  * `--cloud`
  * ✓ Yes
  * Selects Tinybird Cloud as the target for the subcommand.
  ---
  * `--branch=BRANCH_NAME`
  * ✓ Yes
  * Selects a Tinybird branch as the target for the subcommand.
{% /table %}