Metadata-Version: 2.4
Name: thingsboard-cli
Version: 4.3.1.2.post2
Summary: CLI tool for managing ThingsBoard resources
Project-URL: Homepage, https://github.com/thingsboard/thingsboard-cli
Project-URL: Source, https://github.com/thingsboard/thingsboard-cli
Project-URL: Issues, https://github.com/thingsboard/thingsboard-cli/issues
Requires-Python: <3.15,>=3.11
Requires-Dist: click<9.0,>=8.1
Requires-Dist: filelock<4.0,>=3.13
Requires-Dist: httpx<1.0,>=0.28
Requires-Dist: packaging>=24.0
Requires-Dist: pydantic-settings<3.0,>=2.13
Requires-Dist: pydantic<3.0,>=2.12
Requires-Dist: rich<15.0,>=14.0
Requires-Dist: tb-pe-client==4.3.1.2
Requires-Dist: textual<2.0,>=0.83
Requires-Dist: typer<1.0,>=0.24.1
Requires-Dist: tzdata>=2024.1
Description-Content-Type: text/markdown

# ThingsBoard CLI

CLI tool for managing ThingsBoard resources from the terminal.

## Installation

Install [uv](https://docs.astral.sh/uv/) if you don't have it:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Then install the CLI:

```bash
uv tool install thingsboard-cli
```

### Upgrading

The CLI checks for updates automatically on launch and prompts to upgrade. You can also upgrade manually:

```bash
tb update
```

### Shell Completion

```bash
# Bash
tb --install-completion bash

# Zsh
tb --install-completion zsh

# Fish
tb --install-completion fish
```

Restart your terminal after installing completion.

## Usage

```bash
tb --help
tb config set --url https://thingsboard.cloud --api-key YOUR_KEY
tb device list
```

## Verbose Help

Use `-H` or `--help-verbose` on any command to see detailed API documentation, JSON schemas, and field descriptions:

```bash
tb device create -H
tb dashboard save -H
```

## Contributing

For local development setup, editable installs, regenerating help text, and publishing, see [CONTRIBUTING.md](https://github.com/thingsboard/thingsboard-cli/blob/master/CONTRIBUTING.md).
