Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

fix(apps): say usage limits are the share used

leepokaibd7027ec8b92
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/CodyncWidgets.kt b/apps/android/app/src/main/kotlin/com/codync/android/CodyncWidgets.kt
index c7852c1d..b15eb2e8 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/CodyncWidgets.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/CodyncWidgets.kt
@@ -283,7 +283,7 @@ private const val WARNING = 0xFFF0A030.toInt()
@Composable private fun Ticks(context: Context, percent: Double, tint: Int, height: Dp) {
val red = danger.getColor(context).toArgb()
val bitmap = remember(percent, tint, red) { ticks(percent, tint, red) }
- Image(ImageProvider(bitmap), "${percent.roundToInt()} percent", GlanceModifier.fillMaxWidth().height(height), contentScale = ContentScale.FillBounds)
+ Image(ImageProvider(bitmap), "${percent.roundToInt()} percent used", GlanceModifier.fillMaxWidth().height(height), contentScale = ContentScale.FillBounds)
}
private fun ticks(percent: Double, tint: Int, red: Int): Bitmap {
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/UsageScreen.kt b/apps/android/app/src/main/kotlin/com/codync/android/UsageScreen.kt
index 4568851a..9b808ebb 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/UsageScreen.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/UsageScreen.kt
@@ -96,7 +96,7 @@ import kotlin.math.roundToInt
Column(verticalArrangement = Arrangement.spacedBy(6.dp)) {
Row {
Text(tr(top.title), Modifier.weight(1f), style = Type.subheadline, color = Palette.text)
- Text(percent(top.percent), style = Type.subheadline.monospacedDigit, color = Palette.text)
+ Text(usedText(top.percent), style = Type.subheadline.monospacedDigit, color = Palette.text)
}
UsageTicks(top.percent ?: 0.0, tint, 15.dp)
val reset = top.resetsShort()
@@ -118,9 +118,11 @@ import kotlin.math.roundToInt
}
}
-private fun reading(window: UsageWindow) = window.text?.takeIf { it.isNotBlank() } ?: percent(window.percent)
+@Composable private fun reading(window: UsageWindow) = window.text?.takeIf { it.isNotBlank() } ?: usedText(window.percent)
-private fun percent(value: Double?) = value?.takeIf { it.isFinite() }?.let { "${it.roundToInt()}%" } ?: "—"
+/** "62% used": the share of the cap already spent, said so (a bare percent reads as what's left). */
+@Composable private fun usedText(value: Double?) =
+ value?.takeIf { it.isFinite() }?.let { tr("{percent}% used").replace("{percent}", "${it.roundToInt()}") } ?: "—"
/** "Oct 17, 2026 at 10:20 PM", as iOS formats an abbreviated date with a short time. */
private fun updatedAt(milliseconds: Long): String {
diff --git a/apps/desktop/src/renderer/views/island/IslandUsage.tsx b/apps/desktop/src/renderer/views/island/IslandUsage.tsx
index c555c3cd..96f286fd 100644
--- a/apps/desktop/src/renderer/views/island/IslandUsage.tsx
+++ b/apps/desktop/src/renderer/views/island/IslandUsage.tsx
@@ -4,7 +4,7 @@ import { usePixelRatio } from '../../lib/theme'
import { useResetLine, useTr } from '../../lib/use-language'
import { UsageBar } from '../usage/UsageBar'
import { mascotDataURL } from '../usage/ProviderMascot'
-import { providerTintCSS, resetDescription, tightest, windowReading, windowTitle } from '../usage/usage-model'
+import { providerTintCSS, resetDescription, tightest, usedText, windowReading, windowTitle } from '../usage/usage-model'
import type { IslandModel } from './island-model'
// Codync's own part of the island: the plan limits the menu bar already tracks (local usage
@@ -30,19 +30,20 @@ function tightestOverall(usage: UsageProvider[]): { provider: UsageProvider; win
/** Header: the tightest limit as its provider's character, a short bar and the percent; opens Usage. */
export function UsageMeter({ model }: { model: IslandModel }) {
+ const tr = useTr()
+ const line = useResetLine()
const top = tightestOverall(model.summary.usage)
if (!top) return null
const { provider, window } = top
- const tr = useTr()
- const line = useResetLine()
const title = tr(windowTitle(window))
const reset = resetDescription(window)
const spoken = reset ? line(reset) : ''
+ const used = usedText(window.percent, tr)
return (
<button
className="island-meter"
- title={`${provider.name} · ${title} · ${Math.round(window.percent)}%${spoken ? ` · ${spoken}` : ''}`}
- aria-label={`Usage: ${provider.name} ${title} ${Math.round(window.percent)} percent`}
+ title={`${provider.name} · ${title} · ${used}${spoken ? ` · ${spoken}` : ''}`}
+ aria-label={`${tr('Usage')}: ${provider.name} ${title} ${used}`}
onClick={() => model.setTab('usage')}
>
<Mascot provider={provider} size={15} />
@@ -88,7 +89,7 @@ export function UsageView({ model }: { model: IslandModel }) {
) : (
<>
<UsageBar percent={w.percent} tint={providerTintCSS(provider.id)} />
- <span className="island-usage-value">{windowReading(w)}</span>
+ <span className="island-usage-value">{windowReading(w, tr)}</span>
<span className="island-usage-reset">{line(resetDescription(w) ?? '')}</span>
</>
)}
diff --git a/apps/desktop/src/renderer/views/island/island-views.css b/apps/desktop/src/renderer/views/island/island-views.css
index 8a82d79d..0ff242b7 100644
--- a/apps/desktop/src/renderer/views/island/island-views.css
+++ b/apps/desktop/src/renderer/views/island/island-views.css
@@ -314,7 +314,8 @@
text-overflow: ellipsis;
}
.island-usage-value {
- width: 34px;
+ /* Grows past this for longer translations (de, fr); the bar gives way. */
+ min-width: 64px;
flex: none;
text-align: right;
font-variant-numeric: tabular-nums;
@@ -327,7 +328,7 @@
text-align: right;
}
.island-usage-reset {
- width: 66px;
+ width: 76px;
flex: none;
text-align: right;
color: var(--secondary);
diff --git a/apps/desktop/src/renderer/views/settings/UsageLimits.tsx b/apps/desktop/src/renderer/views/settings/UsageLimits.tsx
index 95f01c6c..c1530862 100644
--- a/apps/desktop/src/renderer/views/settings/UsageLimits.tsx
+++ b/apps/desktop/src/renderer/views/settings/UsageLimits.tsx
@@ -2,7 +2,7 @@ import type { Usage } from '@shared/models'
import { HStack, VStack } from '../../components/Stack'
import { Text } from '../../components/Text'
import { prefs, usePref } from '../../lib/prefs'
-import { useResetLine } from '../../lib/use-language'
+import { useResetLine, useTr } from '../../lib/use-language'
import { ProviderMascot } from '../usage/ProviderMascot'
import { UsageBar } from '../usage/UsageBar'
import { providerTintCSS, resetDescription, windowReading, windowTitle } from '../usage/usage-model'
@@ -12,6 +12,7 @@ import './settings.css'
export function UsageLimits({ usage }: { usage: Usage }) {
const [style] = usePref(prefs.usageIconStyle)
const resetLine = useResetLine()
+ const tr = useTr()
return (
<VStack gap={18}>
{usage.providers.map((provider) => (
@@ -22,13 +23,13 @@ export function UsageLimits({ usage }: { usage: Usage }) {
</HStack>
{provider.windows.map((w) => (
<HStack key={w.id} gap={10} className="settings-usage-row">
- <Text tone="text" truncate className="settings-usage-title">{windowTitle(w)}</Text>
+ <Text tone="text" truncate className="settings-usage-title">{tr(windowTitle(w))}</Text>
{w.text ? (
<Text tone="text" truncate className="settings-usage-note">{w.text}</Text>
) : (
<>
<UsageBar percent={w.percent} tint={providerTintCSS(provider.id)} />
- <Text tone="text" tabular className="settings-usage-percent">{windowReading(w)}</Text>
+ <Text tone="text" tabular className="settings-usage-percent">{windowReading(w, tr)}</Text>
<Text tone="secondary" truncate className="settings-usage-reset">{resetLine(resetDescription(w) ?? '')}</Text>
</>
)}
diff --git a/apps/desktop/src/renderer/views/settings/settings.css b/apps/desktop/src/renderer/views/settings/settings.css
index be43d0e7..d8c993d0 100644
--- a/apps/desktop/src/renderer/views/settings/settings.css
+++ b/apps/desktop/src/renderer/views/settings/settings.css
@@ -144,7 +144,8 @@
flex: none;
}
.settings-usage-percent {
- width: 36px;
+ /* Grows past this for longer translations (de, fr); the bar gives way. */
+ min-width: 76px;
flex: none;
text-align: right;
}
diff --git a/apps/desktop/src/renderer/views/tray-summary.ts b/apps/desktop/src/renderer/views/tray-summary.ts
index be498c86..ed1af54e 100644
--- a/apps/desktop/src/renderer/views/tray-summary.ts
+++ b/apps/desktop/src/renderer/views/tray-summary.ts
@@ -117,10 +117,13 @@ function symbolIcons(): TraySummary['symbols'] {
return icons
}
+/** The menu's language: the app's setting, else the system's. */
+const systemLanguage = () => (typeof navigator === 'undefined' ? 'en' : navigator.language)
+const tr = (text: string) => translate(text, prefs.appLanguage.get(), systemLanguage())
+
/** "home · Owner" and "desk · Online · 3 bots" per network; null on hosts without networks. */
function networkLines(view: NetworkView | null | undefined): TraySummary['networks'] {
if (!view) return null
- const tr = (text: string) => translate(text, prefs.appLanguage.get(), typeof navigator === 'undefined' ? 'en' : navigator.language)
return view.networks.map((net) => ({
title: `${net.name} · ${tr(roleTitle(net.role))}`,
computers: net.computers.map((c) => ({
@@ -131,13 +134,9 @@ function networkLines(view: NetworkView | null | undefined): TraySummary['networ
}
function usageLine(w: UsageWindow) {
- const preference = prefs.appLanguage.get()
- const system = typeof navigator === 'undefined' ? 'en' : navigator.language
- const title = translate(windowTitle(w), preference, system)
const reset = resetDate(w)
- const spoken = reset ? resetLine(`resets in ${untilText(reset)}`, preference, system) : ''
- const reading = windowReading(w)
- return `${title} · ${reading}${spoken ? ` · ${spoken}` : ''}`
+ const spoken = reset ? resetLine(`resets in ${untilText(reset)}`, prefs.appLanguage.get(), systemLanguage()) : ''
+ return `${tr(windowTitle(w))} · ${windowReading(w, tr)}${spoken ? ` · ${spoken}` : ''}`
}
/** Sends what the menu bar shows whenever the stores change. */
@@ -194,7 +193,7 @@ export function useTraySummary(app: AppModel) {
needsAttention: app.needsAttention,
textSize,
usageIconStyle: iconStyle,
- language: resolvedLanguage(language, typeof navigator === 'undefined' ? 'en' : navigator.language),
+ language: resolvedLanguage(language, systemLanguage()),
}
window.codync.app.setTraySummary(summary)
}, 150)
diff --git a/apps/desktop/src/renderer/views/usage/usage-model.ts b/apps/desktop/src/renderer/views/usage/usage-model.ts
index 8887d709..bdd3fae2 100644
--- a/apps/desktop/src/renderer/views/usage/usage-model.ts
+++ b/apps/desktop/src/renderer/views/usage/usage-model.ts
@@ -21,9 +21,13 @@ export const isLimit = (w: UsageWindow) => !w.text
export const tightest = (p: UsageProvider) =>
p.windows.filter(isLimit).reduce<UsageWindow | null>((a, w) => (!a || w.percent > a.percent ? w : a), null)
-/** The percent, or the note when this window isn't a share of a cap. */
-export function windowReading(w: UsageWindow) {
- return w.text || `${Math.round(w.percent)}%`
+/** "62% used": the share of the cap already spent, said so (a bare percent reads as what's left). */
+export const usedText = (percent: number, tr: (text: string) => string) =>
+ tr('{percent}% used').replace('{percent}', String(Math.round(percent)))
+
+/** The used percent, or the note when this window isn't a share of a cap. */
+export function windowReading(w: UsageWindow, tr: (text: string) => string) {
+ return w.text || usedText(w.percent, tr)
}
/** "Session" for the 5-hour window, "Opus" for "Weekly · Opus", else the label. */
diff --git a/apps/ios/Kit/Sources/CodyncKit/Design/ProviderMascot.swift b/apps/ios/Kit/Sources/CodyncKit/Design/ProviderMascot.swift
index 5dbcd9be..5bcc2784 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Design/ProviderMascot.swift
+++ b/apps/ios/Kit/Sources/CodyncKit/Design/ProviderMascot.swift
@@ -48,6 +48,14 @@ public extension UsageWindow {
return label
}
+ /// "62% used": the share of the cap already spent, said so (a bare percent reads as what's left).
+ var usedText: String {
+ L10n.tr("{percent}% used").replacingOccurrences(of: "{percent}", with: "\(Int(percent.rounded()))")
+ }
+
+ /// The used percent, or the note when this window isn't a share of a cap.
+ var reading: String { text ?? usedText }
+
/// "resets 3h 20m" / "resets Sep 26 at 12pm", compact for widgets and cards.
func resetsShort(now: Date = .now) -> String? {
if let d = resetDate { return d > now ? "resets \(RelativeTime.until(d, now: now))" : nil }
diff --git a/apps/ios/Kit/Sources/CodyncKit/Design/WidgetCards.swift b/apps/ios/Kit/Sources/CodyncKit/Design/WidgetCards.swift
index 04a2f87f..f258f843 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Design/WidgetCards.swift
+++ b/apps/ios/Kit/Sources/CodyncKit/Design/WidgetCards.swift
@@ -97,7 +97,7 @@ public struct ProviderWidgetCard: View {
private var accessibleUsage: String {
let windows = layout == .small ? provider.tightest.map { [$0] } ?? [] : Array(provider.limits.prefix(layout == .large ? 4 : 2))
return windows.map { window in
- "\(window.title), \(Int(window.percent.rounded())) percent" +
+ "\(window.title), \(Int(window.percent.rounded())) percent used" +
(window.resetsShort(now: date).map { ", \($0)" } ?? "")
}.joined(separator: "; ")
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
index c4cef7c2..a32898c5 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
@@ -824,6 +824,7 @@
"hour unit": "Std.",
"minute unit": "Min.",
"Resets": "Zurücksetzung",
+ "{percent}% used": "{percent} % verbraucht",
"5-hour": "5 Stunden",
"Ready": "Bereit",
"Review changes": "Änderungen prüfen",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
index 99ba481c..67e34832 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
@@ -824,6 +824,7 @@
"hour unit": "h",
"minute unit": "min",
"Resets": "Restablecimiento",
+ "{percent}% used": "{percent} % usado",
"5-hour": "5 horas",
"Ready": "Listo",
"Review changes": "Revisar cambios",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
index d708dd55..28e36d8e 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
@@ -824,6 +824,7 @@
"hour unit": "h",
"minute unit": "min",
"Resets": "Réinitialisation",
+ "{percent}% used": "{percent} % utilisé",
"5-hour": "5 heures",
"Ready": "Prêt",
"Review changes": "Examiner les modifications",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
index 86294b11..eae4f1cd 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
@@ -824,6 +824,7 @@
"hour unit": "時間単位",
"minute unit": "分単位",
"Resets": "リセット",
+ "{percent}% used": "{percent}% 使用済み",
"5-hour": "5時間",
"Ready": "準備完了",
"Review changes": "変更を確認する",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
index fe97438b..aa00393b 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
@@ -824,6 +824,7 @@
"hour unit": "시간",
"minute unit": "분",
"Resets": "초기화",
+ "{percent}% used": "{percent}% 사용됨",
"5-hour": "5시간",
"Ready": "준비됨",
"Review changes": "변경 사항 검토",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
index 191a29ee..f8b29ec4 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
@@ -824,6 +824,7 @@
"hour unit": "小时",
"minute unit": "分",
"Resets": "重置",
+ "{percent}% used": "已用 {percent}%",
"5-hour": "5 小时",
"Ready": "就绪",
"Review changes": "审阅改动",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
index 88ff39e3..eb65595c 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
@@ -824,6 +824,7 @@
"hour unit": "小時",
"minute unit": "分",
"Resets": "重置",
+ "{percent}% used": "已用 {percent}%",
"5-hour": "5 小時",
"Ready": "就緒",
"Review changes": "審閱改動",
diff --git a/apps/ios/Views/UsageView.swift b/apps/ios/Views/UsageView.swift
index 4a9393f4..6c3975f9 100644
--- a/apps/ios/Views/UsageView.swift
+++ b/apps/ios/Views/UsageView.swift
@@ -61,7 +61,7 @@ private struct ProviderCard: View {
HStack {
Text(L10n.tr(top.title))
Spacer()
- Text(L10n.tr("\(Int(top.percent.rounded()))%")).monospacedDigit()
+ Text(top.usedText).monospacedDigit()
}
.font(.subheadline)
.foregroundStyle(Palette.text)
@@ -76,7 +76,7 @@ private struct ProviderCard: View {
if !collapsed {
VStack(spacing: 8) {
ForEach(provider.windows) { w in
- row(L10n.tr(w.title), w.text ?? "\(Int(w.percent.rounded()))%")
+ row(L10n.tr(w.title), w.reading)
if let reset = w.resetsShort() { row(L10n.tr("Resets"), L10n.resetLine(reset)) }
}
row("Source", source)
diff --git a/docs/design/ui-conventions.md b/docs/design/ui-conventions.md
index b1383645..a97ae7b0 100644
--- a/docs/design/ui-conventions.md
+++ b/docs/design/ui-conventions.md
@@ -43,7 +43,7 @@ The tray menu is Electron's native `Menu` (`apps/desktop/src/main/tray.ts`), the
The menu retains host installation/restart, bot conversation/stop actions, approval review, usage limits, remote-screen permissions, open-at-login and quit. Pairing opens a separate titled window because its QR needs a persistent scanning surface. The chat window retains its own UI conventions.
-Usage limits appear directly in the top-level menu, grouped by provider with native section headers. Show each window's percentage, reset time when available, and the provider's last update; do not hide them in submenus. The account menu's
+Usage limits appear directly in the top-level menu, grouped by provider with native section headers. Show each window's used percentage (`{percent}% used`), reset time when available, and the provider's last update; do not hide them in submenus. The account menu's
Usage row shows no number; it opens Settings' Usage page with the same per-provider bars.
## Account menu and Settings (desktop)
diff --git a/host/src/tui/view/usage.rs b/host/src/tui/view/usage.rs
index c4c0e9e4..e8b416d9 100644
--- a/host/src/tui/view/usage.rs
+++ b/host/src/tui/view/usage.rs
@@ -93,7 +93,9 @@ fn window(buf: &mut Buffer, inner: Rect, y: u16, win: &Value) {
if pct >= 80.0 { t.amber } else { t.text }.patch(t.panel),
);
x = put(buf, x, y, 16, &"▱".repeat(16 - on.min(16)), t.line.patch(t.panel));
- put(buf, x + 1, y, 5, &format!("{pct:>3.0}%"), t.text.patch(t.panel));
+ // Said as used: a bare percent reads as what's left.
+ let used = tr("{percent}% used").replace("{percent}", &format!("{pct:.0}"));
+ let end = put(buf, x + 1, y, 16, &used, t.text.patch(t.panel));
let reset = win["resetsAt"]
.as_i64()
.map(|ms| format!("resets {}", when_future(ms)))
@@ -102,7 +104,9 @@ fn window(buf: &mut Buffer, inner: Rect, y: u16, win: &Value) {
win["resetsText"].as_str().map(|s| truncate(s.split(" (").next().unwrap_or(s), 24))
})
.unwrap_or_default();
- let reset = crate::tui::l10n::reset_line(&reset);
+ // Only in what the reading leaves, so a longer translation never runs into it.
+ let room = usize::from(inner.right().saturating_sub(end + 1));
+ let reset = truncate(&crate::tui::l10n::reset_line(&reset), room);
rput(buf, inner.right(), y, &reset, t.dim.patch(t.panel));
}
diff --git a/host/src/usage/antigravity.rs b/host/src/usage/antigravity.rs
index c17104dd..9aa37a40 100644
--- a/host/src/usage/antigravity.rs
+++ b/host/src/usage/antigravity.rs
@@ -192,8 +192,8 @@ fn summary(groups: &[Value]) -> Vec<Window> {
}
}
[
- ("gemini-5h", "five_hour", "5-hour"),
- ("gemini-weekly", "seven_day", "Weekly"),
+ ("gemini-5h", "five_hour", "Gemini 5h"),
+ ("gemini-weekly", "seven_day", "Gemini 7d"),
("3p-5h", "claude_five_hour", "Claude 5h"),
("3p-weekly", "claude_seven_day", "Claude 7d"),
("gemini-argon-wtu-weekly", "argon", "Argon Weekly"),
@@ -251,7 +251,8 @@ mod tests {
{"bucketId":"3p-weekly","remainingFraction":0.5}
]}]}});
let w = parse(&body);
- assert_eq!(w[0].label, "5-hour");
+ // Named for its model, like the Claude rows: clients show a bare "5-hour" as Claude's "Session".
+ assert_eq!(w[0].label, "Gemini 5h");
assert!((w[0].percent - 80.0).abs() < 1e-9);
assert!(w[0].resets_at.is_some());
assert_eq!(w[1].label, "Claude 7d");
diff --git a/web/content/docs/agents.mdx b/web/content/docs/agents.mdx
index d6439565..504af873 100644
--- a/web/content/docs/agents.mdx
+++ b/web/content/docs/agents.mdx
@@ -8,6 +8,8 @@ If an agent's login stops working (for example, signing in somewhere else revoke
On desktop, open **Settings > Usage** to see the limits reported by your connected computers. The host refreshes usage every five minutes.
+Each limit here shows how much of it is already used, such as **62% used**, and its bar fills up as you use it, turning amber and then red near the limit. Some agents' own screens show what's left instead, so 99% used in Codync is 1% left there. Antigravity's Gemini limits are labeled **Gemini 5h** and **Gemini 7d**, next to its Claude ones.
+
Codex needs its CLI installed and signed in on the computer. The host reads current account limits without starting a conversation or using a model. If the login stops working or the current limits are unavailable, old session-file readings are not shown. Sign in again from **Extensions** or run `codex login --device-auth` on that computer.
## Agents Codync knows by name
diff --git a/web/content/docs/conversations.mdx b/web/content/docs/conversations.mdx
index 3c716a45..9af9f5c3 100644
--- a/web/content/docs/conversations.mdx
+++ b/web/content/docs/conversations.mdx
@@ -156,6 +156,8 @@ Codync reads plan limits from the agents installed on your computer. Claude Code
- **Desktop:** the menu bar or tray menu, or **Usage** in the account menu at the bottom of the sidebar.
- **Terminal UI:** press `U`.
+Each limit reads as the share already used, such as **62% used**. Widgets and the small meters in the island and the terminal UI's status bar show just the number, which is also the share used.
+
## From a script
`codync-host send` messages a bot from a terminal or a script on the computer the host runs on: