Skip to main content

aitools command group

note

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The aitools command group within the Databricks CLI installs Databricks AI skills so your coding agent can work effectively with Databricks resources such as bundles, jobs, and SQL. For more details, see the Databricks Agent Skills GitHub repository.

For information about other AI skills available for Databricks, see Agent skills for AI coding assistants.

databricks aitools install

Install Databricks AI skills for detected coding agents.

By default, skills are installed globally to each agent's skills directory. Use --scope=project to install to the current project directory instead. When multiple agents are detected, skills are stored in a canonical location and symlinked to each agent to avoid duplication.

databricks aitools install [flags]

Options

--agents string

    Agents to install skills for (comma-separated, e.g. claude-code,cursor). When not set in an interactive session, a multi-select prompt is shown over detected agents. When not set in a non-interactive session, installs for every detected agent.

Agents of the following tools are supported:

  • Claude Code (claude-code)
  • Cursor (cursor)
  • Codex CLI (codex)
  • OpenCode (opencode)
  • GitHub Copilot (copilot)
  • Antigravity (antigravity)

--experimental

    Include experimental skills.

--scope string

    The install scope, either project (current project directory) or global. Default is global, or a prompt when running interactively.

--skills string

    Specific skills to install (comma-separated). For a complete list of supported skills, see the Databricks Agent Skills GitHub repository.

Global flags

Examples

The following example installs all skills for all detected agents:

Bash
databricks aitools install

The following example installs skills only for Claude Code:

Bash
databricks aitools install --agents claude-code

The following example installs skills into the current project directory instead of globally:

Bash
databricks aitools install --scope project

The following example installs specific skills for all detected agents:

Bash
databricks aitools install --skills bundles,sql

databricks aitools list

List installed AI tools components.

databricks aitools list [flags]

Options

--scope string

    Scope to show: project, global, or both (default: both).

Global flags

Examples

The following example lists all installed components across both project and global scopes:

Bash
databricks aitools list

The following example lists only globally installed components:

Bash
databricks aitools list --scope global

databricks aitools uninstall

Remove installed Databricks AI skills from all coding agents.

By default, removes all skills. Use --skills to remove specific skills only.

databricks aitools uninstall [flags]

Options

--scope string

    Uninstall scope: project or global.

--skills string

    Specific skills to uninstall (comma-separated). For a complete list of supported skills, see the Databricks Agent Skills GitHub repository.

Global flags

Examples

The following example uninstalls all skills from all agents:

Bash
databricks aitools uninstall

The following example uninstalls specific skills only:

Bash
databricks aitools uninstall --skills bundles,sql

databricks aitools update

Update installed Databricks AI skills to the latest release.

By default, updates all installed skills and auto-installs new skills from the manifest. Use --no-new to skip new skills, or --check to preview what would change without downloading.

databricks aitools update [flags]

Options

--check

    Show what would be updated without downloading.

--force

    Re-download even if versions match.

--no-new

    Don't auto-install new skills from the manifest.

--scope string

    Update scope: project, global, or both.

--skills string

    Specific skills to update (comma-separated). For a complete list of supported skills, see the Databricks Agent Skills GitHub repository.

Global flags

Examples

The following example updates all installed skills:

Bash
databricks aitools update

The following example previews available updates without downloading them:

Bash
databricks aitools update --check

The following example updates all installed skills but does not auto-install any new skills from the manifest:

Bash
databricks aitools update --no-new

databricks aitools version

Show the installed AI skills version.

databricks aitools version [flags]

Options

Global flags

Examples

Bash
databricks aitools version

Global flags

--debug

  Whether to enable debug logging.

-h or --help

    Display help for the Databricks CLI or the related command group or the related command.

--log-file string

    A string representing the file to write output logs to. If this flag is not specified then the default is to write output logs to stderr.

--log-format format

    The log format type, text or json. The default value is text.

--log-level string

    A string representing the log format level. If not specified then the log format level is disabled.

-o, --output type

    The command output type, text or json. The default value is text.

-p, --profile string

    The name of the profile in the ~/.databrickscfg file to use to run the command. If this flag is not specified then if it exists, the profile named DEFAULT is used.

--progress-format format

    The format to display progress logs: default, append, inplace, or json

-t, --target string

    If applicable, the bundle target to use