docs: track aitools rename to top-level command#60
Merged
Conversation
jamesbroadhead
requested review from
a team,
camielstee-db,
lennartkats-db and
simonfaltum
as code owners
pkosiec
force-pushed
the
jbroadhead/aitools-cmd-rename
branch
from
8fe4978 to
1bdfc0c
Compare
pkosiec
approved these changes
May 21, 2026
Member
pkosiec
left a comment
pkosiec
left a comment
There was a problem hiding this comment.
LGTM
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 👍 I just pushed the prerequisite versions update for the changed skills.
Member
|
@lennartkats-db @simonfaltum please take a look 🙏 Thank you! |
pkosiec
force-pushed
the
jbroadhead/aitools-cmd-rename
branch
from
1bdfc0c to
0f77c39
Compare
1 task
simonfaltum
approved these changes
May 25, 2026
…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
The non-experimental `databricks aitools install` command requires CLI >= v1.0.0. Bump compatibility and skill versions accordingly. Co-authored-by: Isaac
pkosiec
force-pushed
the
jbroadhead/aitools-cmd-rename
branch
from
0f77c39 to
d639b22
Compare
lennartkats-db
approved these changes
May 26, 2026
pkosiec
added a commit
that referenced
this pull request
May 26, 2026
## Summary Addresses 4 friction clusters identified in the CAO (Coding Agent Optimization) benchmark run 2 (May 21-22, 2026; Opus 4.7 + Codex 5.5, 25 tasks). ### Changes **P2: OAuth auth guidance (Cluster A -- 16/25 tasks affected)** - `databricks-core/SKILL.md`: Add troubleshooting row for `"OAuth Token not supported for current auth type pat"` directing to `databricks auth login` - `databricks-apps/SKILL.md`: Note that `databricks apps logs` requires OAuth in Post-Deploy Verification **P4: Model Serving endpoint readiness (Cluster F -- regression on both models)** - `databricks-model-serving/SKILL.md`: Add "Endpoint Readiness" subsection with state transitions, provisioning times, and poll-before-query guidance. Enhance troubleshooting for `NOT_READY` state. **P5: Off-platform anti-pattern (Drizzle task -- Codex scores 35)** - `databricks-lakebase/references/off-platform.md`: Add callout that off-platform apps are NOT Databricks Apps. Add "Running Locally" section with standard Node.js commands. - `databricks-lakebase/SKILL.md`: Strengthen off-platform reference description. **P6: Lakehouse Sync UI-only limitation (Cluster G)** - `databricks-lakebase/references/lakehouse-sync.md`: Strengthen warning: "Do NOT attempt to automate this step." - `databricks-lakebase/SKILL.md`: Add "(UI-only)" annotation to Lakehouse Sync reference entry. ### Context The benchmark also identified these clusters that are addressed elsewhere: - **Cluster B/D** (npm proxy ETIMEDOUT / apps init failure): Fixed in newer AppKit version (wrong `package-lock.json` entry) - **Cluster C** (CLI `experimental aitools install` deprecation): Addressed in PR #60 ### Test plan - [x] `python3 scripts/skills.py validate` passes This pull request and its description were written by Isaac.
jamesbroadhead
added a commit
that referenced
this pull request
May 27, 2026
Follow-up to #60, which only touched README/manifest and the jobs + pipelines SKILL.md. This sweeps the remaining `databricks experimental aitools` references across the core/apps skills, the experimental skills, and reference docs. The old paths still work as deprecated aliases (see databricks/cli#4917), but new readers should be pointed at the supported command. Co-authored-by: Isaac
1 task
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Mirrors databricks/cli#4917 which promotes the aitools skills-management surface from
databricks experimental aitoolsto top-leveldatabricks aitools. Updates 3 install-command references so user-facing copy points at the canonical path:README.mdskills/databricks-jobs/SKILL.mdskills/databricks-pipelines/SKILL.mdWhy now
Purely cosmetic — there is no deprecation warning to avoid. The CLI keeps
databricks experimental aitools installworking 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 inskills/databricks-core/,skills/databricks-apps/, and elsewhere are not updated. Thetoolssubtree (query, discover-schema, get-default-warehouse, statement) keeps its "no stability guarantees" disclaimer in #4917 and stays underexperimental 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
databricks-jobsanddatabricks-pipelinesskill markdown points at the new commandtools-subtree referencesThis pull request was AI-assisted by Isaac.