mcpField
T
tinybird-cli-guidelines

tinybird-cli-guidelines

github.com/tinybirdcoData & databases221.3k installsUpdated 13w ago
Repository

About tinybird-cli-guidelines

tinybird-cli-guidelines is a guidance skill for Tinybird CLI users. It covers development workflows, deployment, data operations, and workspace management, with reminders to verify commands rather than assume them.

Key features

  1. 01Choose local, branch, or cloud workflows
  2. 02Build and deploy Tinybird projects
  3. 03Manage data operations
  4. 04Set up CI/CD pipelines
  5. 05Verify CLI commands and context

Use cases

  1. 01Select a Tinybird development target
  2. 02Deploy a project to production
  3. 03Append, replace, or delete data
  4. 04Configure CI/CD and run tests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines

After installing, type/tinybird-cli-guidelinesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

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.

Comments

Markdown supported