codex - 💡(How to fix) Fix `/subagents` should prioritize user-defined agent names over forced runtime nicknames [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#19186Fetched 2026-04-24 05:59:14
View on GitHub
Comments
1
Participants
2
Timeline
7
Reactions
1
Author
Timeline (top)
labeled ×4unlabeled ×2commented ×1
RAW_BUFFERClick to expand / collapse

Problem

The /subagents UX is confusing in role-based workflows.

When a user intentionally creates agents with business-role names like:

  • Orchestrator
  • Compliance Worker
  • Design Worker
  • QA Evidence Worker

…the UI still surfaces forced Codex-generated runtime nicknames as the visible labels. That makes the feature feel unserious and creates unnecessary confusion in business workflows.

Why this is a problem

  • Users want agent names to reflect actual work roles.
  • Forced random nicknames add noise instead of clarity.
  • The runtime labels are not useful in structured delivery models.
  • The experience is not business-like when the system insists on showing names the user did not choose.
  • /subagents is harder to interpret when it mixes the main session, active workers, and historical/closed entries without clear distinctions.

Expected behavior

If a user names an agent Orchestrator, /subagents should show Orchestrator as the primary label.

Requested improvements

  • Allow explicit user-defined subagent names to be the primary displayed label.
  • Allow hiding or disabling auto-generated runtime nicknames.
  • Clearly distinguish main from spawned workers.
  • Clearly distinguish active, closed, and historical subagents.
  • Support a role-oriented view for teams using structured multi-agent workflows.

Short version

Please let users control subagent display names in /subagents and stop forcing random runtime nicknames into the primary UX. In business workflows, those names are confusing and reduce usability.

extent analysis

TL;DR

Allow users to define and display custom subagent names in the /subagents UX, hiding or disabling auto-generated runtime nicknames.

Guidance

  • Introduce a configuration option to prioritize user-defined subagent names over auto-generated runtime nicknames.
  • Implement a feature to distinguish between main and spawned workers, as well as active, closed, and historical subagents, to improve clarity in the /subagents view.
  • Consider adding a role-oriented view for teams using structured multi-agent workflows to enhance usability.
  • Evaluate the current UX design to ensure it aligns with business workflow expectations and makes necessary adjustments to reduce confusion.

Example

No specific code example is provided due to the lack of technical implementation details in the issue.

Notes

The solution may require significant changes to the existing UX and backend logic, and careful consideration should be given to ensure that the new features align with the overall system architecture and user experience goals.

Recommendation

Apply a workaround by introducing a configuration option to allow users to define custom subagent names, as this directly addresses the primary concern of confusing auto-generated runtime nicknames and aligns with the expected behavior described in the issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

If a user names an agent Orchestrator, /subagents should show Orchestrator as the primary label.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING