tinybird 4.6.6

Tinybird Command Line Tool

The Tinybird command-line tool allows you to use all the Tinybird functionality directly from the command line. Additionally, it includes several functions to create and manage data projects easily.

Changelog

4.6.6

• Fixed tb local now starts the Tinybird Local container using the host’s native architecture (linux/arm64 on Apple Silicon, linux/amd64 elsewhere) instead of always forcing linux/amd64, so it no longer runs under emulation on arm64 machines.

• Added TB_LOCAL_IMAGE_PLATFORM environment variable to override the auto-detected image platform (e.g. linux/amd64 to run the amd64 image emulated on an arm64 host, or to run a locally built single-arch image that does not match the host).

• Fixed tb local start new-version detection now normalizes Docker Hub image digests and no longer pulls when the registry is unreachable.

4.6.5

• Changed tb pull now automatically creates cloud secrets and shows full Kafka connections.

4.6.4

• Added tb datasource delete now accepts --lightweight-delete, --partition and --projection-mode, backed by the new POST /v1/datasources/{name}/delete endpoint that uses ClickHouse’s lightweight DELETE FROM instead of the heavy ALTER TABLE ... DELETE mutation. Lightweight delete is synchronous by default and returns the affected row count plus a partition-level mutation block; pass --no-wait to enqueue a LightweightDeleteJob and receive the v0-compatible job envelope.

4.6.2

• Changed Replaced branch_data_on_create with branch_data_mode in CLI project config handling. The legacy key now raises an explicit migration error.

• Changed branch_data_mode now only accepts last_partition as a user-facing value.

• Fixed dev_mode=local now warns about branch data mode only when branch_data_mode is explicitly set in tinybird.config.json.

• Changed tb branch create and tb branch clear now show a deprecation warning (instead of failing) when –ignore-datasource is provided, and continue by ignoring that flag.

4.6.1

• Changed tb pull to overwrite existing local files when pulling from a Tinybird workspace.

4.6.0

• Added Support for AWS DynamoDB datasource creation and management.

4.5.12

• Fixed tb info now lists branches and marks the current branch correctly when running on a branch.

4.5.11

• Added tb connection create kafka now supports SASL OAUTHBEARER for Amazon MSK clusters with IAM-based authentication. The wizard asks up-front whether the user already has an IAM role for the cluster — if yes, it collects region + role ARN + external ID directly; if no, it walks the user through creating the IAM access policy and trust policy in the AWS Console, copying them to the clipboard.

• Added --oauthbearer-aws-external-id flag (and matching interactive prompt) so users can supply a pre-shared external ID instead of the one Tinybird auto-generates for the connection.

• Added PLAINTEXT security protocol now skips the SASL mechanism prompt entirely.

• Added .connection files generated by the wizard now emit KAFKA_SASL_OAUTHBEARER_METHOD, KAFKA_SASL_OAUTHBEARER_AWS_REGION, KAFKA_SASL_OAUTHBEARER_AWS_ROLE_ARN, and KAFKA_SASL_OAUTHBEARER_AWS_EXTERNAL_ID, with the role ARN stored as a tb_secret.

• Fixed tb connection create kafka now accepts comma-separated bootstrap-server lists (e.g. b-1.kafka:9092,b-2.kafka:9092) instead of rejecting them as malformed. Validation passes as soon as any one broker is reachable, matching Kafka bootstrap semantics.

• Fixed tb init now persists folder in tinybird.config.json, so subsequent resource creation targets the configured project folder instead of the repository root.

• Fixed Branch names derived from Git refs are now sanitized in tb preview –name and tb branch create/rm/clear, preventing CI/CD failures with invalid workspace names.

4.5.9

• Fixed Manage correctly LLM errors when analyzing quarantine errors.

4.5.8

• Changed tb migrate-to-forward removes the need to add a dummy pipe on first deployment

4.5.7

• Fixed tb build logs now display correct resource paths

4.5.6

• Fixed Issue when executing command tb migrate-to-forward

4.5.5

• Fixed Issue when running executing command tb –cloud deploy –check

4.5.4

• Added tb migrate-to-forward to help users migrate Classic workspaces to Forward

4.5.3

• Changed tb init now defaults to CLI projects when –type is not provided.

• Fixed GitHub and GitLab CI templates generated by tb init now run tb –local build and tb –local test run.

4.5.2

• Fixed tb build on branches now runs as an asynchronous job, avoiding timeouts on long-running executions.

4.5.1

• Fixed tb open now generates the correct UI URL when running against Tinybird Local.

4.5.0

• Added tb copy pause and tb copy resume commands to pause and resume copy pipes.

4.4.2

• Added tb build and tb dev now display git branch, Tinybird branch name, and dashboard URL before building. In local mode, a separate workspace is created per git branch.

4.4.1

• Changed CLI messages now show uv run tinybird for python-sdk projects and npx tinybird for ts-sdk projects instead of tb.

4.4.0

• Added tb copy run has a new –on-demand-compute flag to use on-demand compute instances for copy jobs.

4.3.2

• Changed CLI API requests now set the from parameter dynamically from the detected project type (python-sdk, ts-sdk, or cli) instead of using a hardcoded source.

4.3.1

• Fixed tb deploy –help and tb deployment create –help.

4.3.0

• Changed tb deploy –auto/–no-auto keeps the same CLI behavior (default –auto) while using server-side deployment auto_promote under the hood when enabled.

4.2.2

• Changed Improved the max-depth warning message to clarify when the warning can be safely ignored.

4.1.1

• Changed tb init now installs tinybird-python-sdk-guidelines when selecting the Python SDK project type.

• Changed tb init now defaults dev_mode to branch and persists that value in tinybird.config.json.

4.1.0

• Added New WORKSPACE:DEPLOY scope for static tokens. To create one, run: tb –cloud token create static deploy –scope “WORKSPACE:DEPLOY”

4.0.0

• Removed Tinybird Code entry points and AI-assisted command paths (tb –prompt, tb datasource create –prompt, tb test create, and tb mock).

• Changed tb init is now the project scaffolding command.

• Changed tb build now uses the dev_mode configuration from the project JSON config file.

• Changed tb deploy now uses the dev_mode configuration from the project JSON config file.

3.5.4

• Fixed Pulling vendored data sources from a Classic workspace to migrate to Forward now includes all workspaces in SHARED_WITH.

3.5.3

• Fixed Support SASL_PLAINTEXT as a Kafka security protocol, fixing connections to brokers that use SASL authentication without TLS (e.g. WarpStream).

3.5.2

• Changed tb deploy –auto/–no-auto keeps the same CLI behavior (default –auto) while using server-side deployment auto_promote under the hood when enabled.

3.5.1

• Fixed Support special characters in workspace names in the login flow.

3.5.0

• Changed AI-assisted CLI commands now show a deprecation warning indicating they will be removed in a future major release and include agent skills guidance (npx skills add @tinybirdco/tinybird-agent-skills).

3.4.0

• Changed Prompt-based AI flows now print a deprecation warning (tb –prompt, tb create –prompt, tb datasource create –prompt, tb test create, tb mock) ahead of their removal in a future release.

3.3.2

• Added tb logs command to query service observability data sources from the CLI.

• Added support for –start, –end, –source, –limit, and –expand in tb logs.

• Added support for –source ‘*’ in tb logs to query all supported sources.

• Changed default tb logs sources to tinybird.datasources_ops_log, tinybird.pipe_stats_rt, and tinybird.jobs_log.

• Changed tb logs table output to show full datetime (YYYY-MM-DD HH:MM:SS) in TIME and to hide temporal fields from DETAILS.

• Fixed tb logs to correctly parse SQL responses returned as JSON strings.

3.3.1

• Changed Tinybird Code (tb / tb –prompt) no longer prompts users to auto-update the CLI when starting an agent session.

3.3.0

• Added tb datasource stop and tb datasource start commands to pause/resume Kafka ingestion in forward branches

• Added POST /v0/datasources/{name}/sample API endpoint to import sample data from S3/GCS connections in forward branches

• Changed --with-connections flag for tb build and tb deploy is now stable (previously experimental)

3.0.2

• Changed IMPORT_FORMAT is now optional for S3/GCS data sources and will be automatically inferred from the file extension if not provided

3.0.1

• Experimental Added hidden –with-connections flag to tb build and tb dev commands for enabling connection datasources (S3, Kafka, GCS) in branches. This is an experimental feature and is not yet publicly documented.

3.0.0

• Removed Python 3.9 support. The minimum supported Python version is now 3.10.

• Removed BigQuery and Snowflake connector support from Forward CLI build and deployment commands

1.1.14

• Changed tb deploy First deployment will not show feedback related to deleting the previous deployment, as it does not exist yet.

1.1.13

• Changed tb workspace members subcommands now use the token from context instead of asking for a user token.

• Removed Guest role option from tb workspace members, only Viewer role remains.

1.1.12

• Added support for formatting connection files with tb fmt command.

1.1.11

• Changed Improve first deployment feedback message.

• Changed do not show tb materialization populate command as it is not supported.

1.1.10

• Changed Tinybird Code now will not load all the resources content at start and instead will load them on demand using its own tools: read_datafile and search_datafiles.

1.1.9

• Fixed tb dev won’t show a multiple environment flags error when a command is passed with an environment flag.

1.1.8

• Fixed tb deploy will return a meaningful error in case of invalid cloud provider credentials instead of returning Internal Server Error.

1.1.7

• Fixed tb connection create s3 now will show a warning if the AWS credentials are not available and will continue without Tinybird Local.

1.1.6

• Changed Using more than one environment flag (–cloud, –local, –branch) at the same time will raise an error.

1.1.5

• Changed Changed the output of tb deploy to show real deployment order of events.

• Changed First deployment no longer shows the hint to ingest data if it detects data already planned to be ingested.

1.1.4

• Changed tb connection create s3 now will ask for the environments to create the secret in (Local and Cloud) and will use the corresponging AWS account IDs in the generated trust policy.

1.1.3

• Changed tb datasource create –s3 now will generate the exact schema from the bucket preview instead of a generic data column.

1.1.2

• Changed tb datasource create wording.

1.1.1

• Added Support for previewing S3 connections data in tb connection data command.

1.1.0

• Added tb fmt command to format .datasource and .pipe files. Not supported yet for .connection files.

1.0.7

• Changed tb datasource create –kafka now includes the Kafka meta columns explicitly in the generated file.

1.0.6

• Changed tb deploy will raise a warning when using engine parameters that are not useful for the picked engine.

1.0.5

• Added Internal changes

1.0.4

• Changed tb login help text has been updated to provide more clarity on the available options.

1.0.3

• Changed tb login now will warn the user if they are trying to login from a different folder than the last one and will ask for confirmation to continue.

1.0.2

• Changed If connection name is not provided in tb connection data, it will prompt the user to select a connection from the list of available connections.

1.0.1

• Added Support for schema_registry_url and auto_offset_reset when creating a Kafka connection.

1.0.0

• Released Version 1.0.0, from now on the tinybird-cli package uses the standard semver convention for stable versions. Development versions will be tagged as with the .devX suffix where X is an integer number.