Last update: 2025-07-23T09:45:20.000Z
Content:
---
title: "Tinybird Code · Tinybird Docs"
theme-color: "#171612"
description: "Tinybird Code is an AI-powered agentic mode for the Tinybird CLI that helps you build, optimize, and manage data projects using natural language."
inkeep:version: "forward"
---




# Tinybird Code [¶](https://www.tinybird.co/docs/forward/tinybird-code#tinybird-code)

Copy as MD Tinybird Code is an AI-powered agentic mode for the Tinybird CLI. When you run `tb` without any arguments, it opens an interactive AI assistant that can understand your natural language requests and execute complex workflows on your behalf.

Think of it as having a ClickHouse engineer that understands your data projects and can handle everything from creating new resources to optimizing performance and managing deployments.

## Getting Started [¶](https://www.tinybird.co/docs/forward/tinybird-code#getting-started)

### Prerequisites [¶](https://www.tinybird.co/docs/forward/tinybird-code#prerequisites)

Before using Tinybird Code, ensure you have:

- Tinybird CLI installed and authenticated
- A Tinybird workspace set up
- Docker or similar container runtime (for local development)

### Launch Tinybird Code [¶](https://www.tinybird.co/docs/forward/tinybird-code#launch-tinybird-code)

Simply run the `tb` command without any arguments:

tb
» Initializing Tinybird Code...


  ████████╗██╗███╗   ██╗██╗   ██╗██████╗ ██╗██████╗ ██████╗     ██████╗ ██████╗ ██████╗ ███████╗
  ╚══██╔══╝██║████╗  ██║╚██╗ ██╔╝██╔══██╗██║██╔══██╗██╔══██╗   ██╔════╝██╔═══██╗██╔══██╗██╔════╝
     ██║   ██║██╔██╗ ██║ ╚████╔╝ ██████╔╝██║██████╔╝██║  ██║   ██║     ██║   ██║██║  ██║█████╗
     ██║   ██║██║╚██╗██║  ╚██╔╝  ██╔══██╗██║██╔══██╗██║  ██║   ██║     ██║   ██║██║  ██║██╔══╝
     ██║   ██║██║ ╚████║   ██║   ██████╔╝██║██║  ██║██████╔╝   ╚██████╗╚██████╔╝██████╔╝███████╗
     ╚═╝   ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═════╝ ╚═╝╚═╝  ╚═╝╚═════╝     ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

Tips for getting started:
- Describe what you want to build or ask for specific resources.
- Run tb commands directly without leaving interactive mode.
- Create a TINYBIRD.md file to customize your interactions.

tb (tinybird_web_analytics) » This opens the interactive Tinybird Code agent where you can start making requests in natural language.

**Usage Limits (Informative)** : Tinybird Code will have usage limits based on your plan:

- **  Free plans**   : 30 requests per month
- **  Developer and Enterprise plans**   : 100 requests per month, with additional requests charged per usage

These limits are not currently enforced and are provided for informational purposes.

## What you can do with Tinybird Code [¶](https://www.tinybird.co/docs/forward/tinybird-code#what-you-can-do-with-tinybird-code)

### Project Creation & Management [¶](https://www.tinybird.co/docs/forward/tinybird-code#project-creation-management)

- **  Project creation**   : Describe your project idea and let Tinybird Code create the entire structure, including Data Sources, Pipes, and Endpoints
- **  Add new resources**   : Request new endpoints, Data Sources, or optimizations in plain English
- **  Sample data generation**   : Create realistic sample data for your Data Sources
- **  Generate and run tests**   : Create test files for your endpoints and run them to validate your project

### Data Engineering & Optimization [¶](https://www.tinybird.co/docs/forward/tinybird-code#data-engineering-optimization)

- **  Schema optimization**   : Analyze and improve data types, sorting keys, and table structures
- **  Performance tuning**   : Improve endpoint performance through Materialized Views and other optimizations

### Development Workflow [¶](https://www.tinybird.co/docs/forward/tinybird-code#development-workflow)

- **  Local development**   : Test your APIs locally before deploying
- **  Error handling**   : Diagnose and fix build issues, quarantine problems, and deployment errors

### Other Tasks [¶](https://www.tinybird.co/docs/forward/tinybird-code#other-tasks)

- **  CLI command execution**   : Run any `tb`   command directly from the interactive mode
- **  Data exploration**   : Execute queries or endpoints directly to understand your data

For detailed workflow examples, see the [Common workflows](/docs/forward/tinybird-code/workflows) guide.

## Key Features [¶](https://www.tinybird.co/docs/forward/tinybird-code#key-features)

### Intelligent Planning [¶](https://www.tinybird.co/docs/forward/tinybird-code#intelligent-planning)

Tinybird Code breaks down complex requests into actionable steps, showing you exactly what it plans to do before executing.

### Context Awareness [¶](https://www.tinybird.co/docs/forward/tinybird-code#context-awareness)

The agent understands your existing project structure, schema definitions and the differences between your local and cloud environments.

### Deterministic Execution [¶](https://www.tinybird.co/docs/forward/tinybird-code#deterministic-execution)

When running CLI commands, Tinybird Code provides predictable, reliable results that you can trust in production workflows.

### Error Recovery [¶](https://www.tinybird.co/docs/forward/tinybird-code#error-recovery)

If something goes wrong, Tinybird Code can diagnose the issue and suggest or implement fixes automatically.

Ready to get started? Run `tb` in your terminal and describe what you want to build. Tinybird Code will handle the rest.


