# tinybird-cli-guidelines

Guides an agent through running Tinybird CLI (tb) commands for local development, branch work, building, deploying, and CI, with the correct flags.

Skill by Tinybird. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Warn
- Snyk: Warn
- Runlayer: Warn
- ZeroLeaks: Pass

Installs: 1213. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/tinybirdco/tinybird-agent-skills/tinybird-cli-guidelines)

## Source

[Open the source](https://github.com/tinybirdco/tinybird-agent-skills/tree/HEAD/skills/tinybird-cli-guidelines). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: tinybird-cli-guidelines
description: Tinybird CLI commands, workflows, and operations. Use when running tb commands, managing local development, deploying, or working with data operations.
---

# 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.
````

- Previous: [stream](https://syn4pse.dev/terminal/stream.md)
- Next: [tinybird-typescript-sdk-guidelines](https://syn4pse.dev/terminal/tinybird-typescript-sdk-guidelines.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
