[Feature]: Make truncated model picker labels distinguishable (provider compaction or model-first order)

[DaveW001]

Area

Catalog / models

What are you trying to accomplish?

I want to tell similar models apart in the Codex App picker before I select one. The picker renders each routed row as provider/model-id in a narrow dropdown and cuts the end of the string with an ellipsis. The part that gets cut is the model suffix, which is usually the only part that differs between rows.

My picker currently shows these rows (OpenCodex 2.41.0, Windows 11):

• opencode-go/deepseek-v4-f... and opencode-go/deepseek-v4-...: these are deepseek-v4-flash and deepseek-v4-pro, but nothing on screen says which is which.
• opencode-zen/deepseek-v4-...: hides whether the row is the free variant.
• opencode-go/muse-spark-1.... and opencode-zen/muse-spark-1....: version and variant collapse into the same few visible characters.

I cannot tell which row selects which model until I pick one and check what actually runs. The label truncates exactly the information I am choosing on.

What prevents this today?

End-of-string ellipsis plus a provider-first label means a long provider name pushes the distinguishing suffix out of view. opencode-zen/ is 13 characters before the model name even starts.

The recent display work helps, but none of it fixes the default view:

• feat(catalog): durable display names for discovered models (#2201, carry of #2715) #3212 (from [Feature] configurable human-readable display names for discovered provider models #2201) landed modelDisplayNames, so I can override labels per model id. That only works if I notice each collision and hand-label every row, in every environment, and keep doing it whenever discovery adds a new colliding model.
• fix(catalog): display effective model aliases in Codex picker #2960 (from Bug: model aliases are not reflected in Codex picker display names #2959) made aliases reach the picker. Correct behavior, but still operator-maintained.
• feat(catalog,providers): compact google-antigravity to agy across display and routing #3531 compacts one provider (google-antigravity to agy). Useful precedent, but it is a single hard-coded compaction rather than a general display option.

Out of the box, two rows that share a prefix still render identically.

What should OpenCodex do?

Any of these would keep the distinguishing part visible in a narrow picker, in the order I would prefer:

1. A display-level provider compaction option: when a composed label exceeds a configurable length, render the provider's short form in the label only. Routing ids stay untouched. This generalizes what feat(catalog,providers): compact google-antigravity to agy across display and routing #3531 does for one provider.
2. A label-order option that renders model (provider), so end truncation eats the provider prefix instead of the model suffix. deepseek-v4-flash (opencode-zen) stays identifiable even when clipped; the current order does the opposite.
3. If neither fits, a docs note in the display-names guide: when two discovered rows truncate to the same visible prefix, set modelDisplayNames or a provider alias for that pair.

A wider picker or a smaller font would also fix it, but that rendering belongs to the Codex App rather than OpenCodex. The label string is the part OpenCodex controls, and it is enough.

Example usage or interface

Illustrative config. Field names are up to you; the ask is the behavior.

{
  "catalog": {
    "displayProviderCompaction": true   // opencode-go -> go, opencode-zen -> zen in picker labels only
  }
}

Before:

opencode-go/deepseek-v4-f...
opencode-go/deepseek-v4-...

After:

go/deepseek-v4-flash
go/deepseek-v4-pro

Same width, distinguishable.

Alternatives or workarounds

I can set modelDisplayNames for every colliding pair today, or alias the providers. It works, but it is manual, per-environment, and fails silently the next time discovery adds a colliding row. The dashboard editor in #2716 will lower the friction once it merges, but defaults would still truncate for anyone who has not labeled anything.

Additional context

Codex App on Windows 11, OpenCodex 2.41.0, routed providers opencode-go and opencode-zen. Related: #2201 and #3212 (model display names), #2959 and #2960 (alias-aware picker labels), #2716 (display-name editor), #3531 (per-provider compaction).

• I searched existing issues and documentation.
• This request describes a concrete OpenCodex workflow rather than merely naming a desired technology.
• I removed secrets and personal data.

[lidge-jun]

리뷰 · 우선순위 52 / 80

이 이슈는 Codex App 피커가 provider/model 라벨을 좁은 드롭다운에서 끝만 잘라(…) 보여줄 때, 긴 프로바이더 접두사 때문에 모델 접미사(실제로 고르는 부분) 가 화면에서 사라진다는 표시 UX 요청이다. 제보자는 Windows 11 + OpenCodex 2.41.0에서 opencode-go/deepseek-v4-flash와 opencode-go/deepseek-v4-pro가 둘 다 opencode-go/deepseek-v4-…처럼 보이고, opencode-zen·muse-spark-1…도 같은 식으로 구분이 안 된다고 했다. 라우팅 id는 그대로 두고, OpenCodex가 Codex에 넣는 표시 문자열(display_name) 만 바꿔서 좁은 폭에서도 구분되게 하자는 뜻이다.

지금 dev(HEAD 24cc558d5, package 2.43.0) 기준으로 피커 라벨이 어디서 정해지는지 보면 그림이 명확하다. 라우티드 행의 기본 표시는 src/codex/catalog/sync.ts의 routedDisplayName(slug)이고, command-code/commandcode만 예외로 짧게 고친 뒤 그 외 프로바이더는 slug 그대로 provider/model을 display_name에 찍는다(deriveEntry가 e.display_name = routedDisplayName(slug)). 그 다음에 applyCatalogModelMetadata(src/codex/catalog/effort.ts)가 CatalogModel.displayName이 있으면 그 값으로 display_name만 덮어쓴다. 이 필드는 주석대로 표시 전용이고 라우팅 slug·alias·프로바이더 동작에는 안 탄다. modelDisplayNames 설정은 #3212(머지됨, #2201/#2715 캐리)로 provider-fetch의 configuredModelDisplayName → CatalogModel.displayName 경로로 이미 들어가 있다. 모델 alias 쪽은 #2960이 머지되어, alias가 잡힌 행만 provider.alias || name/alias 형태로 표시 라벨을 만든다(provider-fetch.ts의 aliasDisplayNames). 즉 기본 라우티드 행은 여전히 긴 opencode-go/deepseek-v4-flash 같은 문자열이고, Codex App이 끝을 자르면 제보 그대로 충돌한다. OpenCodex가 바꿀 수 있는 것은 그 라벨 문자열이지, Codex App의 폭·폰트·말줄임 정책이 아니다.

제보가 제안한 세 가지는 모두 “표시만” 쪽이고, 우선순위도 제보자가 매긴 대로 (1) 표시용 프로바이더 축약 옵션 → (2) model (provider) 순서 옵션 → (3) display-names 가이드에 충돌 시 modelDisplayNames/alias 쓰라는 문서가 현실적이다. (1)은 #3531이 google-antigravity→agy로 하는 축약을 표시만이 아니라 라우팅까지 건드리는 방향이라, 이 이슈의 “routing ids stay untouched”와는 겹치면서도 범위가 다르다. 그리고 제보 본문은 #3531이 이미 랜딩한 선례처럼 적었는데, 지금 dev에는 #3531이 열려 있고 머지되지 않았다(base dev, review-ready). #2716 디스플레이 네임 에디터도 아직 오픈이라, 대시보드로 수동 라벨을 쉽게 넣는 길은 아직 HEAD에 없다. 수동 modelDisplayNames·프로바이더 alias는 워크어라운드로 동작하지만, discovery가 새 충돌 행을 넣을 때마다 다시 손대야 해서 “기본값으로 구분된다”는 요구를 못 채운다.

라인/경로로 보면 손댈 후보는 좁다. routedDisplayName이 기본 라벨 공장이고, 옵션이 생기면 여기 또는 deriveEntry 직전/직후에 provider short form·순서 변환을 넣는 식이 자연스럽다. modelDisplayNames와 alias 표시 경로는 이미 있으니, 새 옵션은 그 위에 기본 생성 규칙을 바꾸는 레이어여야 하고, 이미 operator displayName이 있으면 그걸 이기게 두는 게 #3212 계약과 맞다. Windows 피커 폭 문제는 재현 환경(Codex App) 쪽이지만, 제보가 말한 대로 라벨 문자열만으로도 같은 폭에서 구분이 가능해 보이므로 OpenCodex 쪽 이슈로 두는 건 타당하다. 현재 머지 트레인(S02 providers split #3566 등, Windows suite, #3348 combo 바운디드 스택)과는 겹치지 않는 catalog/display enhancement라 즉시 랜딩 필수는 아니다.

src/codex/catalog/sync.ts routedDisplayName - 기본 피커 라벨이 거의 항상 긴 provider/model이라, Codex App 끝 말줄임과 만나면 모델 접미사가 사라지는 제보의 직접 원인이다 (command-code만 예외).
src/codex/catalog/effort.ts applyCatalogModelMetadata - displayName이 있을 때만 덮어쓰므로, 옵션 없는 기본 경로에는 축약·순서 변경이 없다.
src/codex/catalog/provider-fetch.ts aliasDisplayNames / configuredModelDisplayName - alias·modelDisplayNames 워크어라운드는 이미 있으나 discovery 충돌마다 수동 유지가 필요하다.
이슈 본문 #3531 서술 - “이미 하드코딩 축약 선례”로 적혀 있으나 #3531은 아직 OPEN이라 사실 관계가 어긋난다. 리뷰/설계 시 HEAD 기준으로 고치는 편이 좋다.
#2716 - 에디터가 머지되면 수동 라벨 마찰은 줄지만, 제보가 원하는 “기본 표시로 구분”은 그대로 남는다.

메인테이너의 판단이 필요한 지점

• (1) 표시 전용 provider compaction vs #3531처럼 라우팅 id까지 줄이는 축약 — 이 이슈는 전자만 요구한다. #3531과 한 트레인으로 묶을지, display-only 옵션으로 분리할지.
• (2) model (provider) 전역 순서 변경은 기존 사용자·스크린샷·문서 습관을 깨므로, 기본값 유지 + opt-in인지, catalog 전역 기본인지.
• (3) 축약 테이블을 설정(displayProviderCompaction)으로 둘지, 내장 short map + 오버라이드로 둘지, 기존 providers.*.alias를 표시에도 더 넓게 쓸지.
• (4) 지금 트레인 뒤에서 받을지, catalog UX로 help wanted만 달고 외부 PR을 기다릴지.

너의 추천
라벨은 enhancement/catalog로 이미 맞다. #3531이 라우팅 축약이면 이 이슈는 display-only로 분리해 두고, 본문의 “#3531 already landed” 한 줄만 정정 댓글로 고치자. 구현 방향은 (1) opt-in 표시용 provider short form을 routedDisplayName(또는 그 직후)에 넣고, 기존 modelDisplayNames/alias displayName이 있으면 그대로 우선하는 쪽이 #3212 계약과 가장 잘 맞다. (2) 순서 옵션은 두 번째. (3) 문서는 임시 가이드로만. #2716 머지 전이라도 기본 충돌 완화는 이 이슈 단독으로 가치 있다. 우선순위 52 — 재현 명확·워크어라운드 있음·현재 랜딩 트레인과 비충돌. help wanted로 두거나, #3531 리뷰 때 display-only 범위를 명시해 후속 PR로 받는 걸 추천한다.

이 댓글은 grok-bot이 작성했습니다

[zigzag-007]

I am also working on #2716, which adds the missing dashboard editor for durable friendly names. Once #2716 is merged, users will be able to replace a long visible selector such as:

google-antigravity/claude-opus-4-6-thinking

with a friendly display name while the real routed selector stays unchanged.

After using many providers, my recommended manual naming convention for that editor is:

Model Name (Provider)

For example:

Opus 4.6 Thinking (Antigravity)
Composer 2.5 Fast (xAI)
Gemini 3.6 Flash (Antigravity)

This makes the model easy to identify in the narrow Codex picker, while the provider is still visible as short context. It also avoids changing any routing identity.

So #2716 provides the practical manual fix for this problem, and the examples above show how people can use it. I prefer explicit user chosen names here because provider naming is inconsistent and each user may want different labels.

[DaveW001]

Withdrawing this request. I found provider and model aliases in the current build.

I shortened opencode-go to OG and shortened two colliding model labels the same way. The picker rows are short enough now that I can tell them apart.

My example from the issue was opencode-go/deepseek-v4-flash versus opencode-go/deepseek-v4-pro. With aliases those render short and distinct, so the truncation problem I reported is gone for my setup.

Thanks for the detailed triage note. Closing this as no longer needed on my end. Anything you already planned for display defaults can stay separate from this. I am not asking for a change here.