---
title: Tinybird Code
meta:
    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.
---

# Tinybird Code

{% callout type="warning" title="Tinybird Code is being sunset" %}
Tinybird Code is being sunset. This page is kept for reference and may not receive further updates.
{% /callout %}

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

### 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

Simply run the `tb` command without any arguments:

```shell
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.

{% callout type="info" %}
**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.
{% /callout %}

## What you can do with 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
- **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
- **Local development**: Test your APIs locally before deploying
- **Error handling**: Diagnose and fix build issues, quarantine problems, and deployment errors

### 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](/forward/tinybird-code/workflows) guide.

## Key Features

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

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

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

### 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.