tinybirdco/tinybird-cli-guidelines

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
• Choosing a development workflow (local, branch, or cloud)
• Local development with Tinybird Local
• Branch development with Tinybird Cloud branches
• Building and deploying projects
• Setting up CI/CD pipelines
• Appending, replacing, or deleting data
• Managing tokens and secrets via CLI
• Generating mock data
• Running tests

Rule Files

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

Quick Reference

• CLI 4.0 workflow: configure dev_mode once, then use plain tb build and tb deploy.
• tb build targets your configured development environment (branch or local) in tinybird.config.json.
• tb deploy targets Tinybird Cloud production.
• Use --cloud/--local/--branch only as explicit manual overrides.
• Use tb info to check CLI context.
• Use tb endpoint data <pipe> to test endpoints (not tb pipe data).
• Never invent commands or flags; run tb <command> --help to verify.