Skip to content

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

Merged
pkosiec merged 3 commits into
mainfrom
jbroadhead/aitools-cmd-rename
May 21, 2026
Merged

docs: track aitools rename to top-level command#330
pkosiec merged 3 commits into
mainfrom
jbroadhead/aitools-cmd-rename

Conversation

@jamesbroadhead
Copy link
Copy Markdown
Contributor

@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 in appkit so that user-facing copy points at the new canonical path:

  • packages/shared/src/cli/commands/setup.ts (×2) — the CLAUDE.md snippet emitted by the appkit setup flow
  • docs/docs/index.md (×1)

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, so the old path doesn't break and doesn't print anything. This PR is just keeping new docs aligned with the canonical command path so users learning aitools for the first time meet the right name.

Note on the tools subtree

databricks experimental aitools tools … (query / discover-schema / get-default-warehouse / statement) is not being promoted in #4917 — it stays under experimental. appkit doesn't reference any of those commands, so nothing else here needed updating.

Test plan

  • databricks-appkit setup emits a CLAUDE.md that points at databricks aitools install
  • Docs site renders the new command

This pull request was AI-assisted by Isaac.

@MarioCadenas MarioCadenas requested a review from a team as a code owner May 6, 2026 10:59
@MarioCadenas MarioCadenas requested review from pkosiec and removed request for a team May 6, 2026 10:59
jamesbroadhead and others added 2 commits May 21, 2026 11:07
…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`.

The old `experimental aitools install` path still works in the CLI
(prints a deprecation warning) but new docs should use the top-level
form.

Note: the `databricks experimental aitools tools …` subtree (query,
discover-schema, get-default-warehouse, statement) intentionally stays
under experimental — appkit doesn't reference any of those, so nothing
else to update here.

Co-authored-by: Isaac
Signed-off-by: Pawel Kosiec <pawel.kosiec@databricks.com>
@pkosiec pkosiec force-pushed the jbroadhead/aitools-cmd-rename branch from 09397a6 to a70e2d8 Compare May 21, 2026 09:08
@pkosiec
Copy link
Copy Markdown
Member

pkosiec commented May 21, 2026

Databricks CLI 1.0 has been released: https://github.com/databricks/cli/releases/tag/v1.0.0

I've just verified that the aitools command group is no longer under experimental, so we can merge this 👍

Comment thread docs/docs/development/ai-assisted-development.mdx
@pkosiec pkosiec enabled auto-merge (squash) May 21, 2026 09:11
Signed-off-by: Pawel Kosiec <pawel.kosiec@databricks.com>
@pkosiec pkosiec force-pushed the jbroadhead/aitools-cmd-rename branch from 1a80298 to f5f7633 Compare May 21, 2026 09:16
@pkosiec pkosiec merged commit ab5d033 into main May 21, 2026
9 checks passed
@pkosiec pkosiec deleted the jbroadhead/aitools-cmd-rename branch May 21, 2026 09:30
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.

2 participants