--skills-only --scope project incorrectly skips Codex

Open
  • Is something wrong?
#6,284 4 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
72/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
go
Domain
cli

Research direction

Start with libs/aitools/agents/agents.go and reproduce the issue using the documented databricks aitools install command. Trace how --scope project and --skills-only use the Codex capability settings, then inspect the existing agent installation tests if present. Done means Codex skills install under /.agents/skills while Claude Code continues using /.claude/skills.

Written by the indexing model from the issue text.

Description

Stale
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:

<project>/.agents/skills

Claude Code should continue using:

<project>/.claude/skills

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:

<project>/.agents/skills
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.

Dominant language
Go
Stars
427
Forks
267
Avg merge
2d 1h
Merged PRs (30d)
233

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from databricks/cli

All issues in databricks/cli

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.