From 0f4a10f4a38f9d8594ad15244444a8bd50a9b59e Mon Sep 17 00:00:00 2001
From: David Hill <iamdavidhill@gmail.com>
Date: Mon, 26 Jan 2026 17:29:15 +0000
Subject: [PATCH] feat(app): add provider descriptions to settings

---
 .../app/src/components/settings-providers.tsx | 47 ++++++++++++++-----
 packages/app/src/i18n/en.ts                   |  9 ++--
 2 files changed, 41 insertions(+), 15 deletions(-)

diff --git a/packages/app/src/components/settings-providers.tsx b/packages/app/src/components/settings-providers.tsx
index eec0ac7b9b..8d0ab3f54f 100644
--- a/packages/app/src/components/settings-providers.tsx
+++ b/packages/app/src/components/settings-providers.tsx
@@ -84,10 +84,10 @@ export const SettingsProviders: Component = () => {
             >
               <For each={connected()}>
                 {(item) => (
-                  <div class="group flex items-center justify-between gap-4 h-14 border-b border-border-weak-base last:border-none">
+                  <div class="group flex items-center justify-between gap-4 h-16 border-b border-border-weak-base last:border-none">
                     <div class="flex items-center gap-3 min-w-0">
                       <ProviderIcon id={item.id as IconName} class="size-5 shrink-0 icon-strong-base" />
-                      <span class="text-14-regular text-text-strong truncate">{item.name}</span>
+                      <span class="text-14-medium text-text-strong truncate">{item.name}</span>
                       <Tag>{type(item)}</Tag>
                     </div>
                     <Show
@@ -114,21 +114,44 @@ export const SettingsProviders: Component = () => {
           <div class="bg-surface-raised-base px-4 rounded-lg">
             <For each={popular()}>
               {(item) => (
-                <div class="flex items-center justify-between gap-4 h-14 border-b border-border-weak-base last:border-none">
-                  <div class="flex items-center gap-x-3 min-w-0">
-                    <ProviderIcon id={item.id as IconName} class="size-5 shrink-0 icon-strong-base" />
-                    <span class="text-14-regular text-text-strong">{item.name}</span>
+                <div class="flex items-center justify-between gap-4 h-16 border-b border-border-weak-base last:border-none">
+                  <div class="flex flex-col min-w-0">
+                    <div class="flex items-center gap-x-3">
+                      <ProviderIcon id={item.id as IconName} class="size-5 shrink-0 icon-strong-base" />
+                      <span class="text-14-medium text-text-strong">{item.name}</span>
+                      <Show when={item.id === "opencode"}>
+                        <Tag>{language.t("dialog.provider.tag.recommended")}</Tag>
+                      </Show>
+                    </div>
                     <Show when={item.id === "opencode"}>
-                      <Tag>{language.t("dialog.provider.tag.recommended")}</Tag>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.opencode.note")}
+                      </span>
                     </Show>
                     <Show when={item.id === "anthropic"}>
-                      <div class="text-14-regular text-text-weak">{language.t("dialog.provider.anthropic.note")}</div>
-                    </Show>
-                    <Show when={item.id === "openai"}>
-                      <div class="text-14-regular text-text-weak">{language.t("dialog.provider.openai.note")}</div>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.anthropic.note")}
+                      </span>
                     </Show>
                     <Show when={item.id.startsWith("github-copilot")}>
-                      <div class="text-14-regular text-text-weak">{language.t("dialog.provider.copilot.note")}</div>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.copilot.note")}
+                      </span>
+                    </Show>
+                    <Show when={item.id === "openai"}>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.openai.note")}
+                      </span>
+                    </Show>
+                    <Show when={item.id === "google"}>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.google.note")}
+                      </span>
+                    </Show>
+                    <Show when={item.id === "openrouter"}>
+                      <span class="text-12-regular text-text-weak pl-8">
+                        {language.t("dialog.provider.openrouter.note")}
+                      </span>
                     </Show>
                   </div>
                   <Button
diff --git a/packages/app/src/i18n/en.ts b/packages/app/src/i18n/en.ts
index 44f8f8505e..000ee2836b 100644
--- a/packages/app/src/i18n/en.ts
+++ b/packages/app/src/i18n/en.ts
@@ -91,9 +91,12 @@ export const dict = {
   "dialog.provider.group.popular": "Popular",
   "dialog.provider.group.other": "Other",
   "dialog.provider.tag.recommended": "Recommended",
-  "dialog.provider.anthropic.note": "Connect with Claude Pro/Max or API key",
-  "dialog.provider.openai.note": "Connect with ChatGPT Pro/Plus or API key",
-  "dialog.provider.copilot.note": "Connect with Copilot or API key",
+  "dialog.provider.opencode.note": "Curated models including Claude, GPT, Gemini and more",
+  "dialog.provider.anthropic.note": "Direct access to Claude models, including Pro and Max",
+  "dialog.provider.copilot.note": "Claude models for coding assistance",
+  "dialog.provider.openai.note": "GPT models for fast, capable general AI tasks",
+  "dialog.provider.google.note": "Gemini models for fast, structured responses",
+  "dialog.provider.openrouter.note": "Access all supported models from one provider",
 
   "dialog.model.select.title": "Select model",
   "dialog.model.search.placeholder": "Search models",