diff --git a/apps/desktop/src/settings/DesktopClientSettings.test.ts b/apps/desktop/src/settings/DesktopClientSettings.test.ts
index 11030fcc5fa4..f7ce3e957904 100644
--- a/apps/desktop/src/settings/DesktopClientSettings.test.ts
+++ b/apps/desktop/src/settings/DesktopClientSettings.test.ts
@@ -37,6 +37,7 @@ const clientSettings: ClientSettings = {
   glassOpacity: 80,
   planModeEnabled: false,
   showSkillsInSlashMenu: false,
+  showProviderUsageInComposer: true,
   providerModelPreferences: {},
   sidebarAutoSettleAfterDays: 3,
   sidebarAutoSettleOnMerge: true,
diff --git a/apps/web/src/components/chat/ChatComposer.tsx b/apps/web/src/components/chat/ChatComposer.tsx
index 6d0ca8a765ba..0529cbe0342c 100644
--- a/apps/web/src/components/chat/ChatComposer.tsx
+++ b/apps/web/src/components/chat/ChatComposer.tsx
@@ -125,6 +125,8 @@ import {
   renderProviderTraitsMenuContent,
   renderProviderTraitsPicker,
 } from "./composerProviderState";
+import { ComposerUsageMeter } from "./ComposerUsageMeter";
+import { resolveComposerUsageMeter } from "./ComposerUsageMeter.logic";
 import { ContextWindowMeter } from "./ContextWindowMeter";
 import { resolveContextWindowModelDisplayName } from "./ContextWindowMeter.logic";
 import { buildExpandedImagePreview, type ExpandedImagePreview } from "./ExpandedImagePreview";
@@ -438,6 +440,7 @@ const ComposerFooterModeControls = memo(function ComposerFooterModeControls(prop
 
 const ComposerFooterPrimaryActions = memo(function ComposerFooterPrimaryActions(props: {
   compact: boolean;
+  composerUsage: ReturnType<typeof resolveComposerUsageMeter>;
   activeContextWindow: ContextWindowSnapshot | null;
   activeThreadModelDisplayName: string | null;
   isPreparingWorktree: boolean;
@@ -467,6 +470,9 @@ const ComposerFooterPrimaryActions = memo(function ComposerFooterPrimaryActions(
 }) {
   return (
     <>
+      {props.composerUsage && !props.activeContextWindow ? (
+        <ComposerUsageMeter usage={props.composerUsage} />
+      ) : null}
       {props.activeContextWindow ? (
         <ContextWindowMeter
           usage={props.activeContextWindow}
@@ -474,6 +480,7 @@ const ComposerFooterPrimaryActions = memo(function ComposerFooterPrimaryActions(
           onCompact={props.onCompactContext}
           compactDisabled={props.compactDisabled}
           compactDisabledReason={props.compactDisabledReason}
+          providerUsage={props.composerUsage}
         />
       ) : null}
       {props.isPreparingWorktree ? (
@@ -927,6 +934,15 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   const noProviderAvailable = selectedProviderEntry === undefined;
   const resolvedCompactDisabledReason =
     compactDisabledReason ?? (noProviderAvailable ? "Compacting is unavailable right now" : null);
+  const composerUsage = useMemo(
+    () =>
+      resolveComposerUsageMeter({
+        enabled: settings.showProviderUsageInComposer,
+        hasStartedTurn: activeThread?.latestTurn != null || phase === "running",
+        provider: selectedProviderEntry?.snapshot,
+      }),
+    [activeThread?.latestTurn, phase, selectedProviderEntry, settings.showProviderUsageInComposer],
+  );
   // The driver kind follows the instance that will actually run the turn,
   // which can differ from the persisted selection when that selection is
   // disabled.
@@ -3557,6 +3573,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                   {showMobilePendingAnswerActions ? null : inlineStashBadge}
                   <ComposerFooterPrimaryActions
                     compact={isComposerPrimaryActionsCompact}
+                    composerUsage={composerUsage}
                     activeContextWindow={activeContextWindow}
                     activeThreadModelDisplayName={activeThreadModelDisplayName}
                     pendingAction={pendingPrimaryAction}
diff --git a/apps/web/src/components/chat/ComposerUsageMeter.logic.test.ts b/apps/web/src/components/chat/ComposerUsageMeter.logic.test.ts
new file mode 100644
index 000000000000..d97633ed7176
--- /dev/null
+++ b/apps/web/src/components/chat/ComposerUsageMeter.logic.test.ts
@@ -0,0 +1,130 @@
+import {
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ServerProvider,
+  type ServerProviderUsageLimits,
+} from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import { headlineUsageUsedPercent, resolveComposerUsageMeter } from "./ComposerUsageMeter.logic";
+
+function usageLimits(windows: ServerProviderUsageLimits["windows"]): ServerProviderUsageLimits {
+  return {
+    source: "codexAppServer",
+    available: true,
+    checkedAt: "2026-08-16T00:00:00.000Z",
+    windows,
+  };
+}
+
+function provider(
+  overrides: Partial<ServerProvider> & Pick<ServerProvider, "driver">,
+): ServerProvider {
+  return {
+    instanceId: ProviderInstanceId.make("codex"),
+    enabled: true,
+    installed: true,
+    availability: "available",
+    auth: { status: "authenticated" },
+    models: [],
+    ...overrides,
+  } as ServerProvider;
+}
+
+describe("headlineUsageUsedPercent", () => {
+  it("uses the most constrained window so the ring tracks the tighter limit", () => {
+    expect(
+      headlineUsageUsedPercent([
+        { kind: "session", label: "Session", usedPercent: 35 },
+        { kind: "weekly", label: "Weekly", usedPercent: 82 },
+      ]),
+    ).toBe(82);
+  });
+});
+
+describe("resolveComposerUsageMeter", () => {
+  const codex = provider({
+    driver: ProviderDriverKind.make("codex"),
+    displayName: "Codex",
+    usageLimits: usageLimits([
+      { kind: "session", label: "Session", usedPercent: 20 },
+      { kind: "weekly", label: "Weekly", usedPercent: 55 },
+    ]),
+  });
+  const claude = provider({
+    driver: ProviderDriverKind.make("claudeAgent"),
+    instanceId: ProviderInstanceId.make("claudeAgent"),
+    displayName: "Claude Code",
+    usageLimits: usageLimits([{ kind: "session", label: "Session", usedPercent: 90 }]),
+  });
+
+  it("stays hidden until the setting is on", () => {
+    expect(
+      resolveComposerUsageMeter({ enabled: false, hasStartedTurn: true, provider: codex }),
+    ).toBeNull();
+  });
+
+  it("stays hidden until the thread has started a turn", () => {
+    expect(
+      resolveComposerUsageMeter({ enabled: true, hasStartedTurn: false, provider: codex }),
+    ).toBeNull();
+  });
+
+  it("shows only the current provider's windows", () => {
+    expect(
+      resolveComposerUsageMeter({ enabled: true, hasStartedTurn: true, provider: codex }),
+    ).toEqual({
+      providerLabel: "Codex",
+      usageLimits: codex.usageLimits,
+      usedPercent: 55,
+    });
+    expect(
+      resolveComposerUsageMeter({ enabled: true, hasStartedTurn: true, provider: claude })
+        ?.providerLabel,
+    ).toBe("Claude Code");
+    expect(
+      resolveComposerUsageMeter({ enabled: true, hasStartedTurn: true, provider: claude })
+        ?.usedPercent,
+    ).toBe(90);
+  });
+
+  it("hides when the current provider has no usable quota snapshot", () => {
+    expect(
+      resolveComposerUsageMeter({ enabled: true, hasStartedTurn: true, provider: undefined }),
+    ).toBeNull();
+    expect(
+      resolveComposerUsageMeter({
+        enabled: true,
+        hasStartedTurn: true,
+        provider: provider({ driver: ProviderDriverKind.make("codex"), usageLimits: undefined }),
+      }),
+    ).toBeNull();
+    expect(
+      resolveComposerUsageMeter({
+        enabled: true,
+        hasStartedTurn: true,
+        provider: provider({
+          driver: ProviderDriverKind.make("opencode"),
+          usageLimits: usageLimits([{ kind: "session", label: "OpenCode Go", usedPercent: 10 }]),
+        }),
+      }),
+    ).toBeNull();
+    expect(
+      resolveComposerUsageMeter({
+        enabled: true,
+        hasStartedTurn: true,
+        provider: provider({
+          driver: ProviderDriverKind.make("grok"),
+          auth: { status: "authenticated", label: "Free", type: "Free" },
+          usageLimits: {
+            source: "grokStatusProbe",
+            available: false,
+            checkedAt: "2026-08-16T00:00:00.000Z",
+            reason: "Usage is only shown for paid tiers",
+            windows: [],
+          },
+        }),
+      }),
+    ).toBeNull();
+  });
+});
diff --git a/apps/web/src/components/chat/ComposerUsageMeter.logic.ts b/apps/web/src/components/chat/ComposerUsageMeter.logic.ts
new file mode 100644
index 000000000000..80446faedf4d
--- /dev/null
+++ b/apps/web/src/components/chat/ComposerUsageMeter.logic.ts
@@ -0,0 +1,44 @@
+import type { ServerProvider, ServerProviderUsageLimits } from "@t3tools/contracts";
+
+import {
+  providerQuotaLabel,
+  providerQuotaNotice,
+  shouldShowProviderQuota,
+} from "../usage/ProviderQuotaLimits";
+
+export type ComposerUsageMeterModel = {
+  readonly providerLabel: string;
+  readonly usageLimits: ServerProviderUsageLimits;
+  readonly usedPercent: number;
+};
+
+export function headlineUsageUsedPercent(windows: ServerProviderUsageLimits["windows"]): number {
+  if (windows.length === 0) return 0;
+  return Math.max(...windows.map((window) => window.usedPercent));
+}
+
+/**
+ * Chat-box usage is opt-in, scoped to the thread's current provider, and
+ * hidden until the thread has started a turn. Unavailable, unpaid, or empty
+ * snapshots stay hidden so the chat box never renders an error state next
+ * to send.
+ */
+export function resolveComposerUsageMeter(input: {
+  readonly enabled: boolean;
+  readonly hasStartedTurn: boolean;
+  readonly provider: ServerProvider | null | undefined;
+}): ComposerUsageMeterModel | null {
+  if (!input.enabled || !input.hasStartedTurn) return null;
+  const provider = input.provider;
+  if (!provider || !shouldShowProviderQuota(provider)) return null;
+  if (providerQuotaNotice(provider) !== null) return null;
+
+  const usageLimits = provider.usageLimits;
+  if (!usageLimits?.available || usageLimits.windows.length === 0) return null;
+
+  return {
+    providerLabel: providerQuotaLabel(provider),
+    usageLimits,
+    usedPercent: headlineUsageUsedPercent(usageLimits.windows),
+  };
+}
diff --git a/apps/web/src/components/chat/ComposerUsageMeter.test.tsx b/apps/web/src/components/chat/ComposerUsageMeter.test.tsx
new file mode 100644
index 000000000000..516381a55d9e
--- /dev/null
+++ b/apps/web/src/components/chat/ComposerUsageMeter.test.tsx
@@ -0,0 +1,45 @@
+import type { ReactNode } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it, vi } from "vite-plus/test";
+
+vi.mock("../ui/popover", () => ({
+  Popover: ({ children }: { children: ReactNode }) => children,
+  PopoverPopup: ({ children }: { children: ReactNode }) => children,
+  PopoverTrigger: ({ render }: { render: ReactNode }) => <div>{render}</div>,
+}));
+
+vi.mock("~/hooks/useSettings", () => ({
+  usePrimarySettings: (selector?: (settings: { timestampFormat: "locale" }) => unknown) =>
+    selector ? selector({ timestampFormat: "locale" }) : { timestampFormat: "locale" },
+}));
+
+import { ComposerUsageMeter } from "./ComposerUsageMeter";
+
+describe("ComposerUsageMeter", () => {
+  it("labels the control with the current provider and keeps usage out of the context meter", () => {
+    const markup = renderToStaticMarkup(
+      <ComposerUsageMeter
+        usage={{
+          providerLabel: "Codex",
+          usedPercent: 55,
+          usageLimits: {
+            source: "codexAppServer",
+            available: true,
+            checkedAt: "2026-08-16T00:00:00.000Z",
+            windows: [
+              { kind: "session", label: "Session", usedPercent: 20 },
+              { kind: "weekly", label: "Weekly", usedPercent: 55 },
+            ],
+          },
+        }}
+      />,
+    );
+
+    expect(markup).toContain('aria-label="Codex usage 55% used"');
+    expect(markup).toContain(">55%<");
+    expect(markup).toContain("Usage");
+    expect(markup).toContain("Session");
+    expect(markup).toContain("Weekly");
+    expect(markup).not.toContain("Context Window");
+  });
+});
diff --git a/apps/web/src/components/chat/ComposerUsageMeter.tsx b/apps/web/src/components/chat/ComposerUsageMeter.tsx
new file mode 100644
index 000000000000..b4b8f64e7b6c
--- /dev/null
+++ b/apps/web/src/components/chat/ComposerUsageMeter.tsx
@@ -0,0 +1,74 @@
+import { Button } from "../ui/button";
+import { cn } from "~/lib/utils";
+import { ProviderUsageBars } from "../usage/ProviderQuotaLimits";
+import type { ComposerUsageMeterModel } from "./ComposerUsageMeter.logic";
+import { Popover, PopoverPopup, PopoverTrigger } from "../ui/popover";
+
+function formatPercentage(value: number): string {
+  if (value < 10) {
+    return `${value.toFixed(1).replace(/\.0$/, "")}%`;
+  }
+  return `${Math.round(value)}%`;
+}
+
+function usageMeterTextClass(percent: number): string {
+  if (percent >= 90) return "text-destructive";
+  if (percent >= 70) return "text-warning";
+  return "text-muted-foreground";
+}
+
+export function ComposerProviderUsageDetails(props: { usage: ComposerUsageMeterModel }) {
+  return (
+    <div className="flex flex-col gap-2">
+      <div className="flex items-center justify-between gap-3">
+        <div className="font-medium text-muted-foreground text-xs">Usage</div>
+        <div className="truncate text-secondary-label text-[11px]">{props.usage.providerLabel}</div>
+      </div>
+      <ProviderUsageBars usageLimits={props.usage.usageLimits} className="gap-2" />
+    </div>
+  );
+}
+
+export function ComposerUsageMeter(props: { usage: ComposerUsageMeterModel }) {
+  const { usage } = props;
+  const normalizedPercentage = Math.max(0, Math.min(100, usage.usedPercent));
+  const usedPercentage = formatPercentage(normalizedPercentage);
+
+  return (
+    <Popover>
+      <PopoverTrigger
+        openOnHover
+        delay={150}
+        closeDelay={0}
+        render={
+          <Button
+            size="sm"
+            variant="ghost-muted"
+            className="h-7 rounded-full px-2 hover:text-muted-foreground data-pressed:text-muted-foreground"
+            aria-label={`${usage.providerLabel} usage ${usedPercentage} used`}
+          >
+            <span
+              className={cn(
+                "text-[11px] tabular-nums font-medium",
+                usageMeterTextClass(normalizedPercentage),
+              )}
+            >
+              {usedPercentage}
+            </span>
+          </Button>
+        }
+      />
+      <PopoverPopup
+        tooltipStyle
+        side="top"
+        align="end"
+        viewportClassName="p-0"
+        className="w-64 max-w-none text-left whitespace-normal"
+      >
+        <div className="flex flex-col gap-2 p-[var(--floating-content-inset)]">
+          <ComposerProviderUsageDetails usage={usage} />
+        </div>
+      </PopoverPopup>
+    </Popover>
+  );
+}
diff --git a/apps/web/src/components/chat/ContextWindowMeter.test.tsx b/apps/web/src/components/chat/ContextWindowMeter.test.tsx
index 90617ca63af1..8e416a87b19b 100644
--- a/apps/web/src/components/chat/ContextWindowMeter.test.tsx
+++ b/apps/web/src/components/chat/ContextWindowMeter.test.tsx
@@ -3,6 +3,11 @@ import type { ReactNode } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it, vi } from "vite-plus/test";
 
+vi.mock("~/hooks/useSettings", () => ({
+  usePrimarySettings: (selector?: (settings: { timestampFormat: "locale" }) => unknown) =>
+    selector ? selector({ timestampFormat: "locale" }) : { timestampFormat: "locale" },
+}));
+
 import { deriveLatestContextWindowSnapshot } from "~/lib/contextWindow";
 import { ContextWindowMeter } from "./ContextWindowMeter";
 
@@ -59,4 +64,34 @@ describe("ContextWindowMeter", () => {
     expect(markup).toContain(">Send or clear your draft before compacting<");
     expect(markup).not.toContain('aria-label="Send or clear your draft before compacting"');
   });
+
+  it("shows the current provider's usage bars without replacing context window stats", () => {
+    const markup = renderToStaticMarkup(
+      <ContextWindowMeter
+        usage={usage}
+        providerUsage={{
+          providerLabel: "Codex",
+          usedPercent: 55,
+          usageLimits: {
+            source: "codexAppServer",
+            available: true,
+            checkedAt: "2026-08-16T00:00:00.000Z",
+            windows: [
+              { kind: "session", label: "Session", usedPercent: 20 },
+              { kind: "weekly", label: "Weekly", usedPercent: 55 },
+            ],
+          },
+        }}
+      />,
+    );
+
+    expect(markup).toContain("Context Window");
+    expect(markup).toContain("Usage");
+    expect(markup).toContain("Codex");
+    expect(markup).toContain("Session");
+    expect(markup).toContain("Weekly");
+    expect(markup).toContain("80% remaining");
+    expect(markup).toContain("45% remaining");
+    expect(markup).toContain('aria-label="Context window 10% used"');
+  });
 });
diff --git a/apps/web/src/components/chat/ContextWindowMeter.tsx b/apps/web/src/components/chat/ContextWindowMeter.tsx
index 93809c4f686c..65c2f0fc9781 100644
--- a/apps/web/src/components/chat/ContextWindowMeter.tsx
+++ b/apps/web/src/components/chat/ContextWindowMeter.tsx
@@ -1,6 +1,8 @@
 import { Button } from "../ui/button";
 import { type ContextWindowSnapshot, formatContextWindowTokens } from "~/lib/contextWindow";
 import { Popover, PopoverPopup, PopoverTrigger } from "../ui/popover";
+import { ComposerProviderUsageDetails } from "./ComposerUsageMeter";
+import type { ComposerUsageMeterModel } from "./ComposerUsageMeter.logic";
 import { formatContextWindowCompactionMessage } from "./ContextWindowMeter.logic";
 import { Minimize2Icon } from "lucide-react";
 
@@ -20,8 +22,16 @@ export function ContextWindowMeter(props: {
   onCompact?: (() => void) | undefined;
   compactDisabled?: boolean | undefined;
   compactDisabledReason?: string | null | undefined;
+  providerUsage?: ComposerUsageMeterModel | null | undefined;
 }) {
-  const { usage, modelDisplayName, onCompact, compactDisabled, compactDisabledReason } = props;
+  const {
+    usage,
+    modelDisplayName,
+    onCompact,
+    compactDisabled,
+    compactDisabledReason,
+    providerUsage,
+  } = props;
   const usedPercentage = formatPercentage(usage.usedPercentage);
   const normalizedPercentage = Math.max(0, Math.min(100, usage.usedPercentage ?? 0));
   const radius = 9.75;
@@ -135,6 +145,11 @@ export function ContextWindowMeter(props: {
               {formatContextWindowCompactionMessage(modelDisplayName, usage.autoCompactThreshold)}
             </div>
           ) : null}
+          {providerUsage ? (
+            <div className="mt-1 border-t border-border/60 pt-2">
+              <ComposerProviderUsageDetails usage={providerUsage} />
+            </div>
+          ) : null}
           {onCompact ? (
             <>
               <Button
diff --git a/apps/web/src/components/settings/SettingsPanels.tsx b/apps/web/src/components/settings/SettingsPanels.tsx
index e77c05549265..a9b202aa8451 100644
--- a/apps/web/src/components/settings/SettingsPanels.tsx
+++ b/apps/web/src/components/settings/SettingsPanels.tsx
@@ -510,6 +510,10 @@ export function useSettingsRestore(onRestored?: () => void) {
       ...(settings.showSkillsInSlashMenu !== DEFAULT_UNIFIED_SETTINGS.showSkillsInSlashMenu
         ? ["Show skills in slash menu"]
         : []),
+      ...(settings.showProviderUsageInComposer !==
+      DEFAULT_UNIFIED_SETTINGS.showProviderUsageInComposer
+        ? ["Show usage in chat"]
+        : []),
       ...(settings.enableLegacyTokenStreaming !==
       DEFAULT_UNIFIED_SETTINGS.enableLegacyTokenStreaming
         ? ["Stream token by token"]
@@ -577,6 +581,7 @@ export function useSettingsRestore(onRestored?: () => void) {
       settings.sidebarProjectGroupingMode,
       settings.sidebarThreadPreviewCount,
       settings.showSkillsInSlashMenu,
+      settings.showProviderUsageInComposer,
       settings.timestampFormat,
       settings.wordWrap,
       followSystem,
@@ -653,6 +658,7 @@ export function useSettingsRestore(onRestored?: () => void) {
       wordWrap: DEFAULT_UNIFIED_SETTINGS.wordWrap,
       diffIgnoreWhitespace: DEFAULT_UNIFIED_SETTINGS.diffIgnoreWhitespace,
       showSkillsInSlashMenu: DEFAULT_UNIFIED_SETTINGS.showSkillsInSlashMenu,
+      showProviderUsageInComposer: DEFAULT_UNIFIED_SETTINGS.showProviderUsageInComposer,
       environmentIdentificationMode: DEFAULT_UNIFIED_SETTINGS.environmentIdentificationMode,
       glassOpacity: DEFAULT_UNIFIED_SETTINGS.glassOpacity,
       sidebarThreadPreviewCount: DEFAULT_UNIFIED_SETTINGS.sidebarThreadPreviewCount,
@@ -2107,6 +2113,34 @@ export function GeneralSettingsPanel() {
           }
         />
 
+        <SettingsRow
+          {...searchableSetting("usage-in-chat")}
+          description="Show remaining session and weekly usage for the current provider next to the chat box, after the first message in a thread."
+          resetAction={
+            settings.showProviderUsageInComposer !==
+            DEFAULT_UNIFIED_SETTINGS.showProviderUsageInComposer ? (
+              <SettingResetButton
+                label="usage in chat"
+                onClick={() =>
+                  updateSettings({
+                    showProviderUsageInComposer:
+                      DEFAULT_UNIFIED_SETTINGS.showProviderUsageInComposer,
+                  })
+                }
+              />
+            ) : null
+          }
+          control={
+            <Switch
+              checked={settings.showProviderUsageInComposer}
+              onCheckedChange={(checked) =>
+                updateSettings({ showProviderUsageInComposer: Boolean(checked) })
+              }
+              aria-label="Show usage in chat"
+            />
+          }
+        />
+
         <SettingsRow
           {...searchableSetting("provider-update-checks")}
           description="Check installed provider CLIs for newer available versions."
diff --git a/apps/web/src/components/settings/settingsSearch.test.ts b/apps/web/src/components/settings/settingsSearch.test.ts
index 09fd7a9a6a0b..494968eccdc5 100644
--- a/apps/web/src/components/settings/settingsSearch.test.ts
+++ b/apps/web/src/components/settings/settingsSearch.test.ts
@@ -73,6 +73,10 @@ describe("searchSettings", () => {
   it("serves anchor props to panels from the catalog", () => {
     expect(searchableSetting("word-wrap")).toEqual({ id: "word-wrap", title: "Word wrap" });
     expect(searchableSetting("archive")).toEqual({ id: "archive", title: "Archived threads" });
+    expect(searchableSetting("usage-in-chat")).toEqual({
+      id: "usage-in-chat",
+      title: "Show usage in chat",
+    });
   });
 
   it("routes appearance settings to their current section", () => {
diff --git a/apps/web/src/components/settings/settingsSearch.ts b/apps/web/src/components/settings/settingsSearch.ts
index 5213cb55a503..a42c1efd6430 100644
--- a/apps/web/src/components/settings/settingsSearch.ts
+++ b/apps/web/src/components/settings/settingsSearch.ts
@@ -136,6 +136,11 @@ export const SETTINGS_SEARCH_ITEMS = [
     title: "Show skills in slash menu",
     to: "/settings/general",
   },
+  {
+    id: "usage-in-chat",
+    title: "Show usage in chat",
+    to: "/settings/general",
+  },
   {
     id: "provider-update-checks",
     title: "Provider update checks",
diff --git a/docs/user/composer.md b/docs/user/composer.md
index 35d634556d88..293c7a53f4be 100644
--- a/docs/user/composer.md
+++ b/docs/user/composer.md
@@ -21,6 +21,14 @@ same `$name` skill token to your message. The original skill name remains search
 also reports that skill as a native slash command, T3 Code hides the duplicate native entry and keeps
 the `/skill:Skill Name` label.
 
+The chat box can also show remaining session and weekly usage for the provider on the current
+thread. This stays off until you turn on **Show usage in chat** in **Settings → General**, and it
+stays hidden on a new thread until the first message is sent. A Codex thread shows Codex usage
+only; switching the thread to Claude Code switches the meter with it. When a context window ring is
+visible, those bars appear in that hover. If the ring is not available after a turn has started, a
+compact percent control appears next to send instead. Providers without a usable quota snapshot hide
+the meter instead of showing an error.
+
 On desktop, press `Cmd+Enter` on macOS or `Ctrl+Enter` on Windows and Linux from a new thread to
 start it in the background. T3 Code opens another new thread and shows an **Open** action for the
 thread that started. The new thread keeps the selected workspace mode and base branch. If **New
diff --git a/docs/user/usage.md b/docs/user/usage.md
index db8d67e5103b..c9668b336ade 100644
--- a/docs/user/usage.md
+++ b/docs/user/usage.md
@@ -12,6 +12,11 @@ completed-turn record will not appear.
 provider (session, weekly, included, and similar). Those bars are independent of the raw token
 cost below. Subscription billing is also separate from that token cost.
 
+On web and desktop, **Settings → General → Show usage in chat** puts the current thread's provider
+limits in the context-window hover next to the chat box. The bars stay hidden until that setting is
+on and the thread has sent its first message, and they only show the provider selected for that
+thread.
+
 Use **Past 24h** for an hourly chart covering the exact rolling 24-hour period. The **7 days**,
 **30 days**, and **90 days** ranges use daily resolution. Cost and token toggles update both the
 headline and chart, and refreshing rescans every connected environment.
diff --git a/packages/contracts/src/settings.test.ts b/packages/contracts/src/settings.test.ts
index d75b0b4ae798..0cb5cbc03dbf 100644
--- a/packages/contracts/src/settings.test.ts
+++ b/packages/contracts/src/settings.test.ts
@@ -49,6 +49,15 @@ describe("ClaudeSettings auto-compaction", () => {
   });
 });
 
+describe("ClientSettings composer usage", () => {
+  it("keeps provider usage out of the chat box until opted in", () => {
+    expect(decodeClientSettings({}).showProviderUsageInComposer).toBe(false);
+    expect(
+      decodeClientSettingsPatch({ showProviderUsageInComposer: true }).showProviderUsageInComposer,
+    ).toBe(true);
+  });
+});
+
 describe("ClientSettings word wrap", () => {
   it("defaults word wrap on", () => {
     expect(decodeClientSettings({}).wordWrap).toBe(true);
diff --git a/packages/contracts/src/settings.ts b/packages/contracts/src/settings.ts
index 76bb032c866e..4ca7ca921f3f 100644
--- a/packages/contracts/src/settings.ts
+++ b/packages/contracts/src/settings.ts
@@ -226,6 +226,11 @@ export const ClientSettingsSchema = Schema.Struct({
   // commands) for users who still rely on the old workflow.
   planModeEnabled: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),
   showSkillsInSlashMenu: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
+  // Composer chrome: remaining session/weekly usage for the thread's current
+  // provider only. Off by default so the chat box stays quiet unless opted in.
+  showProviderUsageInComposer: Schema.Boolean.pipe(
+    Schema.withDecodingDefault(Effect.succeed(false)),
+  ),
   // Legacy sidebar (the original per-project tree). Deliberately a fresh key
   // (was `sidebarV2Enabled` + `sidebarV2ConfiguredByUser`): decoding drops the
   // old keys, so everyone, including prior beta opt-outs, resets to the new
@@ -940,6 +945,7 @@ export const ClientSettingsPatch = Schema.Struct({
   ),
   planModeEnabled: Schema.optionalKey(Schema.Boolean),
   showSkillsInSlashMenu: Schema.optionalKey(Schema.Boolean),
+  showProviderUsageInComposer: Schema.optionalKey(Schema.Boolean),
   legacySidebarEnabled: Schema.optionalKey(Schema.Boolean),
   sidebarAutoSettleAfterDays: Schema.optionalKey(Schema.NullOr(SidebarAutoSettleAfterDays)),
   sidebarAutoSettleOnMerge: Schema.optionalKey(Schema.Boolean),