Tinybird CLI Guidelines

Guidance for using the Tinybird CLI (tb) for local development, deployments, data operations, and workspace management.

When to Apply

• Running any tb command
• Local development with Tinybird Local
• Building and deploying projects
• Appending, replacing, or deleting data
• Managing tokens and secrets via CLI
• Generating mock data
• Running tests

Rule Files

• rules/cli-commands.md
• rules/build-deploy.md
• rules/local-development.md
• rules/data-operations.md
• rules/append-data.md
• rules/mock-data.md
• rules/tokens.md
• rules/secrets.md

Quick Reference

• CLI commands by default target Local; use tb --cloud <command> to target Cloud.
• Use tb info to check CLI context.
• Use tb --branch <branch-name> <command> to target a specific branch in Cloud.
• Never invent commands or flags; run tb <command> --help to verify.