Last update: 2025-12-18T09:52:50.000Z
Content:
---
title: "tb · Tinybird Docs"
theme-color: "#171612"
description: "Launch Tinybird Code, the AI-powered agentic mode for managing data projects"
inkeep:version: "forward"
---




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

Copy as MD Launches Tinybird Code, an AI-powered assistant that helps you build, optimize, and manage data projects using natural language commands.

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

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

tb Opens a conversational interface where you can describe what you want to accomplish.

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

tb --prompt "Create a new analytics project for user events"
tb -p "Add an endpoint to get daily active users"
## Options [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb#options)

| Option | Description |
| --- | --- |
| `--prompt`  , `-p` | Execute a single command in one-shot mode |

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

# Interactive mode
tb

# One-shot commands
tb -p "Create an e-commerce project with user events Data Source"
tb -p "Optimize my slow endpoint with a Materialized View"
tb -p "Show me top 10 errors from logs in the last 24 hours" For detailed capabilities, see the [Tinybird Code guide](/docs/forward/tinybird-code).

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

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✗ No | Tinybird Code works with all environments depending on the prompt. |
| `--cloud` | ✗ No | Tinybird Code works with all environments depending on the prompt. |
| `--branch=BRANCH_NAME` | ✗ No | Branches are not supported in Tinybird Code yet. |


