Tinybird Code

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:

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

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

Updated