OpenParable
Skip to content
← Back to skills

Tinybird CLI Guidelines

Apps & Automation
tinybird-cli-guidelines

Tinybird CLI Guidelines is an Agent Skill for apps & automation published in the MapleTechLabs/maple repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Tinybird CLI commands, workflows, and operations. Use when running tb commands, managing local development, deploying, or working with data operations.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/MapleTechLabs/maple/blob/HEAD/.agents/skills/tinybird-cli-guidelines/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tinybird-cli-guidelines, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.