Skip to content

docs: track aitools rename to top-level command#60

Open
jamesbroadhead wants to merge 1 commit intomainfrom
jbroadhead/aitools-cmd-rename
Open

docs: track aitools rename to top-level command#60
jamesbroadhead wants to merge 1 commit intomainfrom
jbroadhead/aitools-cmd-rename

Conversation

@jamesbroadhead
Copy link
Copy Markdown

@jamesbroadhead jamesbroadhead commented Apr 29, 2026

Summary

Mirrors databricks/cli#4917 which promotes the aitools skills-management surface from databricks experimental aitools to top-level databricks aitools. Updates 3 install-command references so user-facing copy points at the canonical path:

  • README.md
  • skills/databricks-jobs/SKILL.md
  • skills/databricks-pipelines/SKILL.md

Why now

Purely cosmetic — there is no deprecation warning to avoid. The CLI keeps databricks experimental aitools install working as a silent backward-compat alias (it forwards to the same code, prints nothing). This PR is just keeping the docs aligned with the canonical command path so users meet the right name on first read.

Intentionally left alone

The 37 databricks experimental aitools tools … references in skills/databricks-core/, skills/databricks-apps/, and elsewhere are not updated. The tools subtree (query, discover-schema, get-default-warehouse, statement) keeps its "no stability guarantees" disclaimer in #4917 and stays under experimental aitools tools. The docs continue to point at the live, canonical path.

Compatibility

Lands in any order relative to #4917 — the old paths work either way, with or without the CLI change.

Test plan

  • README setup steps point at the new command
  • databricks-jobs and databricks-pipelines skill markdown points at the new command
  • No accidental rewrites of tools-subtree references

This pull request was AI-assisted by Isaac.

…s install'

Mirrors the CLI change in databricks/cli#4917 which promotes the
aitools skills-management surface (install/update/uninstall/list/
version/skills) from `databricks experimental aitools` to top-level
`databricks aitools`.

Updates 3 install-command references:
- README.md
- skills/databricks-jobs/SKILL.md
- skills/databricks-pipelines/SKILL.md

The 37 `databricks experimental aitools tools …` references in
skills/databricks-core/, skills/databricks-apps/, and elsewhere are
intentionally left as-is — that subtree (query, discover-schema,
get-default-warehouse, statement) still has "no stability guarantees"
per its own help text and is NOT being promoted to the top level in
#4917. It stays under `experimental aitools tools`.

Co-authored-by: Isaac
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant