Describe the issue
databricks aitools install skips Codex when --scope project and
--skills-only are used together:
Skipped Codex CLI: does not support project-scoped skills
Codex supports repository-scoped raw skills under
<repo>/.agents/skills:
https://developers.openai.com/codex/skills#where-codex-loads-local-skills
Codex does not appear to support project-scoped plugin installation:
codex plugin add and codex plugin marketplace add expose no project
or --scope option. However, plugin scope should not prevent installation
when --skills-only explicitly requests raw skill files.
Steps to reproduce
Run from a project directory:
databricks aitools install \
--agents claude-code,codex \
--scope project \
--skills-only
Expected behavior
Because --skills-only explicitly requests raw skill files, the CLI should
install the Codex skills into:
Claude Code should continue using:
Whether Codex plugins support project scope should not affect the
--skills-only installation path.
Actual behavior
Claude Code is processed, but Codex is skipped:
Skipped Codex CLI: does not support project-scoped skills
Possible cause
The agent model appears to use a single SupportsProjectScope capability:
https://github.com/databricks/cli/blob/main/libs/aitools/agents/agents.go
The Codex registry entry does not set SupportsProjectScope or
ProjectConfigDir, so SupportsProjectScope defaults to false.
This may correctly reflect the lack of project-scoped Codex plugin
installation, but it also blocks project-scoped raw skills when
--skills-only is used.
The capabilities may need to be distinguished by delivery method, for
example:
- Project-scoped plugin installation
- Project-scoped raw-skill installation
For Codex, raw-skill project scope should be enabled with a project
configuration directory of .agents, producing:
Environment
Databricks CLI v1.12.1
Codex CLI 0.147.0
Related issue
Related to #6037, which proposes installing skills into the
vendor-neutral .agents/skills directory. This report specifically
concerns --skills-only being rejected because Codex plugin and
raw-skill scope capabilities appear to be treated as one capability.
Describe the issue
databricks aitools installskips Codex when--scope projectand--skills-onlyare used together:Codex supports repository-scoped raw skills under
<repo>/.agents/skills:https://developers.openai.com/codex/skills#where-codex-loads-local-skills
Codex does not appear to support project-scoped plugin installation:
codex plugin addandcodex plugin marketplace addexpose no projector
--scopeoption. However, plugin scope should not prevent installationwhen
--skills-onlyexplicitly requests raw skill files.Steps to reproduce
Run from a project directory:
Expected behavior
Because
--skills-onlyexplicitly requests raw skill files, the CLI shouldinstall the Codex skills into:
Claude Code should continue using:
Whether Codex plugins support project scope should not affect the
--skills-onlyinstallation path.Actual behavior
Claude Code is processed, but Codex is skipped:
Possible cause
The agent model appears to use a single
SupportsProjectScopecapability:https://github.com/databricks/cli/blob/main/libs/aitools/agents/agents.go
The Codex registry entry does not set
SupportsProjectScopeorProjectConfigDir, soSupportsProjectScopedefaults tofalse.This may correctly reflect the lack of project-scoped Codex plugin
installation, but it also blocks project-scoped raw skills when
--skills-onlyis used.The capabilities may need to be distinguished by delivery method, for
example:
For Codex, raw-skill project scope should be enabled with a project
configuration directory of
.agents, producing:Environment
Related issue
Related to #6037, which proposes installing skills into the
vendor-neutral
.agents/skillsdirectory. This report specificallyconcerns
--skills-onlybeing rejected because Codex plugin andraw-skill scope capabilities appear to be treated as one capability.