Tinybird CLI Guidelines
Apps & Automationtinybird-cli-guidelinesTinybird 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
tbcommand - 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.mdrules/cli-commands.mdrules/build-deploy.mdrules/local-development.mdrules/branch-development.mdrules/ci-cd.mdrules/data-operations.mdrules/append-data.mdrules/mock-data.mdrules/tokens.mdrules/secrets.md
Quick Reference
- CLI 4.0 workflow: configure
dev_modeonce, then use plaintb buildandtb deploy. tb buildtargets your configured development environment (branchorlocal) in tinybird.config.json.tb deploytargets Tinybird Cloud production.- Use
--cloud/--local/--branchonly as explicit manual overrides. - Use
tb infoto check CLI context. - Use
tb endpoint data <pipe>to test endpoints (nottb pipe data). - Never invent commands or flags; run
tb <command> --helpto verify.