tb branch (Beta)¶
Manages branches in your Tinybird project. Branches allow you to develop and test your project in ephemeral environments using production data. Global options apply to this command. See Global options.
Branches are currently in beta. Some features might not be available yet or might change in the future.
The following subcommands are available:
| Subcommand | Description |
|---|---|
| create BRANCH_NAME [OPTIONS] | Creates a new branch from your production workspace. |
| rm BRANCH_NAME [OPTIONS] | Removes an existing branch. |
| ls [OPTIONS] | Lists all available branches. |
tb branch create¶
Creates a new branch from your production workspace. You can optionally include the last partition of production data.
tb branch create my_feature_branch
To create a branch with production data:
tb branch create my_feature_branch --last-partition
| Option | Description |
|---|---|
| --last-partition | Brings the last partition of production data into the branch |
Use the --last-partition flag when you want to test your changes with real production data.
tb branch rm¶
Removes an existing branch from your workspace.
tb branch rm my_feature_branch
To skip the confirmation prompt:
tb branch rm my_feature_branch --yes
| Option | Description |
|---|---|
| --yes | Skips confirmation prompt and removes the branch immediately |
Removing a branch is irreversible. All data and changes in the branch will be permanently deleted.
tb branch ls¶
Lists all available branches in your workspace.
tb branch ls
This command shows all branches you have created, along with their status and creation information.
Working with branches¶
Once you create a branch, you can start working with it using the --branch flag with other commands:
# Start development in a branch tb --branch=my_feature_branch dev # Open Tinybird UI for the branch tb --branch=my_feature_branch open
For more information about working with branches, see Branches.