Last update: 2025-12-18T21:56:34.000Z
Content:
---
title: "tb branch · Tinybird Docs"
theme-color: "#171612"
description: "Manage branches in your Tinybird project"
inkeep:version: "forward"
---




# tb branch (Beta) [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#tb-branch-beta)

Copy as MD 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](/docs/forward/dev-reference/commands/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 [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#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 [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#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 [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#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 [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#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](/docs/forward/test-and-deploy/branches).

## Environment support [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-branch#environment-support)

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✗ No | Branches are not available locally. |
| `--cloud` | ✗ No | Branches are always created associated with a workspace in Tinybird Cloud. |
| `--branch=BRANCH_NAME` | ✗ No | Use `--branch`   with other commands to work in a branch, not for managing branches. |


