Global options¶
Use these options with any command. Place them before the command name. For example: tb --host https://api.tinybird.co workspace ls.
Environment options (--cloud, --local, --branch, --staging) don't apply to all commands. For example, tb dev and tb build don't support --cloud. Check the Environment support section on each command's page to see which options apply.
| Option | Description |
|---|---|
| --host TEXT | Tinybird host. Defaults to the value of the TB_HOST environment variable, then to https://api.tinybird.co. |
| --token TEXT | Authentication token. Defaults to the value of the TB_TOKEN environment variable, then to the .tinyb file. See .tinyb file. |
| --show-tokens | Shows available tokens. |
| --user-token | Use the user token, defaults to the TB_USER_TOKEN environment variable, then to the .tinyb file. See .tinyb file. |
| --cloud / --local | Run against Tinybird Cloud or Tinybird Local. Use only one of --cloud, --local or --branch per command. Cloud-only commands reject --local. |
| --branch TEXT | Run against a branch. |
| --staging | Run against the staging deployment. |
| --output [human|json|csv] | Output format. Default: human. |
| --max-depth INTEGER | Maximum depth of the project files. Default: 3. |
| --version-warning / --no-version-warning | Shows or hides the new version warning. Defaults to the value of the TB_VERSION_WARNING environment variable, then to shown. |
| --debug / --no-debug | Prints internal representation. Combine it with any command to get more information. |
| --version | Shows the version and exits. |
| -h, --help | Shows help for the command. |