← Package directory
Available on winget

Install DatabricksCLI

Databricks Command Line Interface

Install with winget
winget install --id Databricks.DatabricksCLI
Upgrade
winget upgrade --id Databricks.DatabricksCLI
Uninstall
winget uninstall --id Databricks.DatabricksCLI

About DatabricksCLI

Databricks Command Line Interface

What's new in 1.6.0

Release v1.6.0 CLI - ssh connect now accepts a --base-environment flag to run a serverless session on a custom base environment. It takes an env.yaml path, a workspace-base-environments/... resource ID, or a base environment display name, and is rejected together with --environment-version or --cluster (#5706). - databricks aitools install is now plugin-first: it installs the Databricks plugin through each agent's own CLI (Claude Code, Codex, GitHub Copilot) instead of copying raw skill files. Agents without a plugin (OpenCode, Antigravity) still get skill files, and Cursor prints the /add-plugin databricks step. Use --skills-only to force raw skill files for every agent, or --path <dir> to write skills to a directory (#5738). - databricks labs list now only shows projects that can be installed (#5560). Bundles - direct: Fixed persistent drift on model_serving_endpoints caused by the traffic_config field (#5708). - direct: Fix spurious update when apply_policy_default_values: true is set on job task, for-each-task, or job cluster new_cluster (#5731). Also fix spurious updates for for-each-task clusters due to missing backend defaults for data_security_mode, node_type_id, driver_node_type_id, driver_instance_pool_id, enable_elastic_disk, and enable_local_disk_encryption. - direct: Cluster resize now falls back to regular update if resize fails due to INVALID_STATE (#5716). - bundle generate dashboard now honors the --key flag when naming the generated resource, and rejects combining --existing-path, --existing-id, and --resource instead of silently ignoring all but one (#549...

Read release notes

Version history

Version Updated Notes
1.6.0 Unknown Release v1.6.0 CLI - ssh connect now accepts a --base-environment flag to run a serverless session on a custom base environment. It takes an env.yaml path, a workspace-base-environments/... resource ID, or a base environ...
1.5.0 Unknown CLI - workspace export-dir no longer aborts when a workspace object's name is not a legal local filename (e.g. a notebook named New Notebook 2026-05-04 13:54:24 whose : is illegal on Windows). Such files are now exported...
1.4.0 Unknown CLI - Improved error messages for ssh connect: when an SSH connection attempt fails, the client now fetches and prints the server's recent error logs (#5555). - Increase the SSH server startup timeout from 10 to 45 minut...
1.3.0 Unknown Release v1.3.0 (2026-06-10) Notable Changes - The direct deployment engine is now Generally Available and the default for new deployments. To opt out, set engine: terraform under bundle in your databricks.yml or set DATA...
1.2.1 Unknown Release v1.2.1 (2026-06-04) Bundles - direct: Fix updating the apps after the Go SDK upgrade (#5444)
1.2.0 Unknown Release v1.2.0 CLI - experimental open now opens every DABs resource type that has a workspace URL, picking up catalogs, schemas, volumes, database_instances, database_catalogs, synced_database_tables, postgres_catalogs,...
1.1.0 Unknown Release notes
1.0.0 Unknown The Databricks CLI is now generally available with version v1.0.0 as the first major release 🚀.From this version on, the CLI follows semantic versioning (see README).This change does not impact DABs or other existing com...
0.299.2 Unknown Release notes
0.299.1 Unknown Release notes
0.299.0 Unknown CLI - Moved file-based OAuth token cache management from the SDK to the CLI. No user-visible change; part of a three-PR sequence that makes the CLI the sole owner of its token cache (#5056). - Remove the --experimental-i...
0.298.0 Unknown CLI - Added --limit flag to all paginated list commands for client-side result capping (#4984). On jobs list and jobs list-runs the former API page-size flag was renamed to --page-size (hidden) to avoid collision. - Acce...
0.297.2 Unknown Notable Changes - This release includes a fix for error downloading Terraform: unable to verify checksums signature: openpgp: key expired error observed when running databricks bundle deploy command. Bundles - Use hardco...
0.297.1 Unknown Dependency updates - Bump Go toolchain to 1.25.9 (#5004)
0.297.0 Unknown CLI - Auth commands now accept a profile name as a positional argument (#4840) - Add auth logout command for clearing cached OAuth tokens and optionally removing profiles (#4613, #4616, #4647) Bundles - Added support for...
0.296.0 Unknown Notable Changes - Direct deployment engine for DABs is now in Public Preview. Documentation at docs/direct.md. CLI - Auth commands now error when --profile and --host conflict (#4841) - Add --force-refresh flag to databr...
0.295.0 Unknown Notable Changes - Databricks Asset Bundles have been renamed to Declarative Automation Bundles (DABs). This is a non-breaking change; no code or configuration modifications are required. See the FAQ. - Add bundle.engine...
0.294.0 Unknown Changelog - [Release] Release v0.294.0
0.293.0 Unknown Changelog - Add depguard rule to prevent imports of experimental/ packages (#4662) - Add lint rule for context.Background() in non-test code (#4664) - Added permissions support for Lakebase Database projects (#4626) - Pr...
0.292.0 Unknown Changelog - [Release] Release v0.292.0