/agents UI doesn't reflect agentSettings model overrides

Resolved 💬 7 comments Opened Dec 25, 2025 by darko-mijic Closed Mar 1, 2026

Description

The /agents command displays the original model: field from plugin agent definitions instead of the resolved model after applying agentSettings overrides in settings.json.

Steps to Reproduce

  1. Install plugin agents (e.g., from claude-code-workflows marketplace)
  2. Add agentSettings to ~/.claude/settings.json:

``json
"agentSettings": {
"debugging-toolkit:debugger": "inherit",
"unit-testing:test-automator": "inherit",
"documentation-generation:docs-architect": "inherit"
}
``

  1. Run /agents command

Expected Behavior

The /agents UI should show inherit (or the resolved parent model) for agents with agentSettings overrides.

Actual Behavior

The /agents UI shows the plugin's default (e.g., sonnet) instead of the user's configured inherit.

Evidence That Settings ARE Working at Runtime

Despite the UI showing sonnet for agents like documentation-generation:docs-architect and unit-testing:test-automator:

  • Token usage stats from ~/.claude/stats-cache.json show ONLY claude-opus-4-5-20251101 tokens
  • Zero Sonnet or Haiku tokens recorded in dailyModelTokens
  • This proves agentSettings with "inherit" is being applied at runtime, inheriting Opus from the main thread
// From stats-cache.json - no sonnet tokens despite using "sonnet"-marked agents
"dailyModelTokens": [
  {"date": "2025-12-24", "tokensByModel": {"claude-opus-4-5-20251101": 1021608}}
]

Impact

  • UX Confusion: Users can't verify their settings are working through the UI
  • Debugging difficulty: When troubleshooting agent performance, the UI shows misleading model information
  • Related issue: Arrow key navigation in /agents doesn't work on macOS (can't scroll to select agents)

Environment

  • macOS Darwin 25.1.0
  • Claude Code version: 2.0.76
  • Plugins: Multiple from claude-code-workflows marketplace

Additional Context

The agentSettings object in ~/.claude/settings.json contains 73 agent overrides set to "inherit". All of them appear to work correctly at runtime (based on token usage), but none are reflected in the /agents UI display.

View original on GitHub ↗

This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗