Last update: 2026-01-29T22:06:15.000Z
Content:
---
title: "tb create · Tinybird Docs"
theme-color: "#171612"
description: "Creates an empty data project with predefined folders, CI configuration files, and a git repository."
inkeep:version: "forward"
---




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

Copy as MD Creates an empty data project with predefined folders, CI configuration files, and a git repository.

Pass the `--prompt` flag to generate a customized starter project based on your prompt.

## Options [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-create#options)

| Option | Description |
| --- | --- |
| --prompt STRING | Prompt to generate a customized initial project. Tinybird Local and authentication are required. |
| --folder PATH | Path that will contain the Tinybird project files. Dotfiles are created in project's root. Tinybird Local (run `tb local start`   ) and authentication ( `tb login`   ) are required. |
| --data STRING | Creates a data project based on the file passed as an argument. You can pass a url or a path to a local file. Supported formats are CSV, NDJSON and Parquet. |
| --agent | Creates rules for an LLM agent. Supported values are `cursor`   . The default value is `cursor`  . |

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

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✓ Yes (implicit) | Creates project files locally but you will need to run `tb build`   or `tb deploy`   to see the new resources in Tinybird Local. |
| `--cloud` | ✗ No | To see the new resources in Tinybird Cloud, you will need to run `tb --cloud deploy`  . |
| `--branch=BRANCH_NAME` | ✗ No | To see the new resources in a branch, you will need to run `tb --branch=BRANCH_NAME build`   or `tb --branch=BRANCH_NAME deploy`  . |


