codex-lb 0.2.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

app/static/index.js

@@ -16,6 +16,7 @@
 		oauthStart: "/api/oauth/start",
 		oauthStatus: "/api/oauth/status",
 		oauthComplete: "/api/oauth/complete",
+		settings: "/api/settings",
 	};
 
 	const PAGES = [
@@ -33,6 +34,13 @@
 			title: "Codex Load Balancer - Accounts",
 			path: "/accounts",
 		},
+		{
+			id: "settings",
+			tabId: "tab-settings",
+			label: "Settings",
+			title: "Codex Load Balancer - Settings",
+			path: "/settings",
+		},
 	];
 
 	const BASE_PATH = "/dashboard";
@@ -187,6 +195,7 @@
 		metrics: {
 			requests7d: 0,
 			tokensSecondaryWindow: null,
+			cachedTokensSecondaryWindow: null,
 			cost7d: 0,
 			errorRate7d: null,
 			topError: "",
@@ -242,6 +251,40 @@
 		return compactFormatter.format(numeric);
 	};
 
+	const formatTokensWithCached = (totalTokens, cachedInputTokens) => {
+		const total = toNumber(totalTokens);
+		if (total === null) {
+			return "--";
+		}
+		const cached = toNumber(cachedInputTokens);
+		if (cached === null || cached <= 0) {
+			return formatCompactNumber(total);
+		}
+		return `${formatCompactNumber(total)} (${formatCompactNumber(cached)} Cached)`;
+	};
+
+	const formatCachedTokensMeta = (totalTokens, cachedInputTokens) => {
+		const total = toNumber(totalTokens);
+		const cached = toNumber(cachedInputTokens);
+		if (total === null || total <= 0 || cached === null || cached <= 0) {
+			return "Cached: --";
+		}
+		const percent = Math.min(100, Math.max(0, (cached / total) * 100));
+		return `Cached: ${formatCompactNumber(cached)} (${Math.round(percent)}%)`;
+	};
+
+	const formatModelLabel = (model, reasoningEffort) => {
+		const base = (model || "").trim();
+		if (!base) {
+			return "--";
+		}
+		const effort = (reasoningEffort || "").trim();
+		if (!effort) {
+			return base;
+		}
+		return `${base} (${effort})`;
+	};
+
 	const formatCurrency = (value) => {
 		const numeric = toNumber(value);
 		if (numeric === null) {
@@ -463,6 +506,33 @@
 	};
 	const routingLabel = (strategy) => ROUTING_LABELS[strategy] || "unknown";
 	const errorLabel = (code) => ERROR_LABELS[code] || "--";
+	const calculateProgressClass = (status, remainingPercent) => {
+		if (status === "exceeded") return "error";
+		if (status === "paused" || status === "deactivated") return "";
+		const percent = toNumber(remainingPercent) || 0;
+		if (percent <= 20) return "error";
+		if (percent <= 50) return "limited";
+		return "success";
+	};
+	const calculateProgressTextClass = (status, remainingPercent) => {
+		const cls = calculateProgressClass(status, remainingPercent);
+		return cls ? `text-${cls}` : "";
+	};
+
+	const calculateTextUsageClass = (status, remainingPercent) => {
+		if (status === "exceeded") return "error";
+		// For text, we show usage color even if paused. Only deactivated is plain.
+		if (status === "deactivated") return "";
+		const percent = toNumber(remainingPercent) || 0;
+		if (percent <= 20) return "error";
+		if (percent <= 50) return "limited";
+		return "success";
+	};
+
+	const calculateTextUsageTextClass = (status, remainingPercent) => {
+		const cls = calculateTextUsageClass(status, remainingPercent);
+		return cls ? `text-${cls}` : "";
+	};
 	const progressClass = (status) => PROGRESS_CLASS_BY_STATUS[status] || "";
 
 	const normalizeSearchInput = (value) =>
@@ -565,8 +635,10 @@
 			accountId: entry.accountId,
 			requestId: entry.requestId,
 			model: entry.model,
+			reasoningEffort: entry.reasoningEffort ?? null,
 			status: entry.status,
 			tokens: toNumber(entry.tokens),
+			cachedInputTokens: toNumber(entry.cachedInputTokens),
 			cost: toNumber(entry.costUsd),
 			errorCode: entry.errorCode ?? null,
 			errorMessage: entry.errorMessage ?? null,
@@ -595,17 +667,21 @@
 			const secondaryRemainingPercent = toNumber(
 				secondaryRow?.remainingPercentAvg,
 			);
+			const mergedSecondaryRemaining =
+				secondaryRemainingPercent ??
+				account.usage?.secondaryRemainingPercent ??
+				0;
+			const mergedPrimaryRemaining =
+				primaryRemainingPercent ??
+				account.usage?.primaryRemainingPercent ??
+				0;
+			const effectivePrimaryRemaining =
+				mergedSecondaryRemaining <= 0 ? 0 : mergedPrimaryRemaining;
 			return {
 				...account,
 				usage: {
-					primaryRemainingPercent:
-						primaryRemainingPercent ??
-						account.usage?.primaryRemainingPercent ??
-						0,
-					secondaryRemainingPercent:
-						secondaryRemainingPercent ??
-						account.usage?.secondaryRemainingPercent ??
-						0,
+					primaryRemainingPercent: effectivePrimaryRemaining,
+					secondaryRemainingPercent: mergedSecondaryRemaining,
 				},
 				resetAtPrimary: account.resetAtPrimary ?? null,
 				resetAtSecondary: account.resetAtSecondary ?? null,
@@ -641,6 +717,7 @@
 				accountId: entry.accountId,
 				capacityCredits: toNumber(entry.capacityCredits) || 0,
 				remainingCredits: toNumber(entry.remainingCredits) || 0,
+				remainingPercentAvg: toNumber(entry.remainingPercentAvg),
 			})),
 		};
 	};
@@ -654,6 +731,7 @@
 		const metrics = summary?.metrics || {};
 		const requests7d = toNumber(metrics.requests7d) ?? 0;
 		const tokensSecondaryWindow = toNumber(metrics.tokensSecondaryWindow);
+		const cachedTokensSecondaryWindow = toNumber(metrics.cachedTokensSecondaryWindow);
 		const errorRate7d = toNumber(metrics.errorRate7d);
 		const topError = metrics.topError || "";
 		return {
@@ -665,6 +743,7 @@
 			metrics: {
 				requests7d,
 				tokensSecondaryWindow,
+				cachedTokensSecondaryWindow,
 				cost7d: toNumber(summary?.cost?.totalUsd7d) || 0,
 				errorRate7d,
 				topError,
@@ -699,7 +778,7 @@
 			return acc;
 		}, {});
 
-	const buildRemainingItems = (entries, accounts, capacity) => {
+	const buildRemainingItems = (entries, accounts, capacity, windowKey) => {
 		const accountMap = new Map(
 			(accounts || []).map((account) => [account.id, account]),
 		);
@@ -707,7 +786,23 @@
 			const account = accountMap.get(entry.accountId);
 			const label = account ? account.email : entry.accountId;
 			const value = toNumber(entry.remainingCredits) || 0;
-			const rawPercent = capacity > 0 ? (value / capacity) * 100 : 0;
+			const percentFromApi = toNumber(entry.remainingPercentAvg);
+			const percentFromAccount =
+				windowKey === "primary"
+					? toNumber(account?.usage?.primaryRemainingPercent)
+					: windowKey === "secondary"
+						? toNumber(account?.usage?.secondaryRemainingPercent)
+						: null;
+			const entryCapacity = toNumber(entry.capacityCredits) || 0;
+			const denominator = entryCapacity > 0 ? entryCapacity : capacity;
+			const rawPercent =
+				percentFromApi !== null
+					? percentFromApi
+					: percentFromAccount !== null
+						? percentFromAccount
+						: denominator > 0
+							? (value / denominator) * 100
+							: 0;
 			const remainingPercent = Math.min(100, Math.max(0, rawPercent));
 			return {
 				accountId: entry.accountId,
@@ -734,6 +829,38 @@
 		}));
 	};
 
+	const buildSecondaryExhaustedIndex = (accounts) => {
+		const exhausted = new Set();
+		(accounts || []).forEach((account) => {
+			const remaining = toNumber(account?.usage?.secondaryRemainingPercent);
+			if (remaining !== null && remaining <= 0 && account?.id) {
+				exhausted.add(account.id);
+			}
+		});
+		return exhausted;
+	};
+
+	const applySecondaryExhaustedToPrimary = (entries, exhaustedIds) => {
+		if (!entries?.length || !exhaustedIds?.size) {
+			return entries || [];
+		}
+		return entries.map((entry) => {
+			if (entry?.accountId && exhaustedIds.has(entry.accountId)) {
+				return {
+					...entry,
+					remainingCredits: 0,
+				};
+			}
+			return entry;
+		});
+	};
+
+	const sumRemainingCredits = (entries) =>
+		(entries || []).reduce(
+			(acc, entry) => acc + (toNumber(entry?.remainingCredits) || 0),
+			0,
+		);
+
 	const buildDonutGradient = (items, total) => {
 		if (!items.length || total <= 0) {
 			return `conic-gradient(${CONSUMED_COLOR} 0 100%)`;
@@ -776,6 +903,7 @@
 		const statusCounts = countByStatus(accounts);
 		const secondaryWindowMinutes =
 			state.dashboardData.usage?.secondary?.windowMinutes ?? null;
+		const secondaryExhaustedAccounts = buildSecondaryExhaustedIndex(accounts);
 
 		const badges = ["active", "paused", "limited", "exceeded", "deactivated"]
 			.map((status) => {
@@ -795,7 +923,10 @@
 			{
 				title: `Tokens (${formatWindowLabel("secondary", secondaryWindowMinutes)})`,
 				value: formatCompactNumber(metrics.tokensSecondaryWindow),
-				meta: "Scope: responses",
+				meta: formatCachedTokensMeta(
+					metrics.tokensSecondaryWindow,
+					metrics.cachedTokensSecondaryWindow,
+				),
 			},
 			{
 				title: "Cost (7d)",
@@ -823,28 +954,67 @@
 				resetAt: null,
 				byAccount: [],
 			};
-			const remaining = toNumber(usage.remaining) || 0;
+			const rawEntries = usage.byAccount || [];
+			const hasPrimaryAdjustments =
+				window.key === "primary" &&
+				rawEntries.some(
+					(entry) =>
+						entry?.accountId && secondaryExhaustedAccounts.has(entry.accountId),
+				);
+			const entries =
+				window.key === "primary"
+					? applySecondaryExhaustedToPrimary(
+						rawEntries,
+						secondaryExhaustedAccounts,
+					)
+					: rawEntries;
+			const remaining =
+				hasPrimaryAdjustments
+					? sumRemainingCredits(entries)
+					: toNumber(usage.remaining) || 0;
 			const capacity = Math.max(remaining, toNumber(usage.capacity) || 0);
 			const consumed = Math.max(0, capacity - remaining);
 			const items = buildRemainingItems(
-				usage.byAccount || [],
+				entries,
 				accounts,
 				capacity,
+				window.key,
 			);
 			const gradient = buildDonutGradient(items, capacity);
-			const legendItems = items.map((item) => ({
-				label: item.label,
-				detail: `Remaining ${formatPercent(item.remainingPercent)}`,
-				color: item.color,
-			}));
-			if (capacity > 0 && consumed > 0) {
+			const legendItems = items.map((item) => {
+				const percent = item.remainingPercent;
+				let valueClass = "success";
+				if (percent <= 20) {
+					valueClass = "error";
+				} else if (percent <= 50) {
+					valueClass = "limited";
+				}
+				return {
+					label: truncateText(item.label, 28),
+					fullLabel: item.label,
+					detailLabel: "Remaining",
+					detailValue: formatPercent(item.remainingPercent),
+					valueClass,
+					color: item.color,
+				};
+			});
+			if (capacity > 0) {
 				const consumedPercent = Math.min(
 					100,
 					Math.max(0, (consumed / capacity) * 100),
 				);
+				let consumedClass = "success";
+				if (consumedPercent >= 80) {
+					consumedClass = "error";
+				} else if (consumedPercent >= 50) {
+					consumedClass = "limited";
+				}
 				legendItems.push({
 					label: "Consumed",
-					detail: `${formatPercent(consumedPercent)}`,
+					fullLabel: "Consumed",
+					detailLabel: "",
+					detailValue: formatPercent(consumedPercent),
+					valueClass: consumedClass,
 					color: CONSUMED_COLOR,
 				});
 			}
@@ -871,7 +1041,7 @@
 				},
 				remaining: remainingRounded,
 				remainingText: formatPercent(secondaryRemaining),
-				progressClass: progressClass(account.status),
+				progressClass: calculateProgressClass(account.status, secondaryRemaining),
 				marquee: account.status === "deactivated",
 				meta: formatQuotaResetMeta(
 					account.resetAtSecondary,
@@ -884,17 +1054,18 @@
 		const requests = state.dashboardData.recentRequests.map((request) => {
 			const rawError = request.errorMessage || request.errorCode || "";
 			const accountLabel = formatAccountLabel(request.accountId, accounts);
+			const modelLabel = formatModelLabel(request.model, request.reasoningEffort);
 			return {
 				key: `${request.requestId}-${request.timestamp}`,
 				requestId: request.requestId,
 				time: formatTimeLong(request.timestamp),
 				account: accountLabel,
-				model: request.model,
+				model: modelLabel,
 				status: {
 					class: requestStatusClass(request.status),
 					label: requestStatusLabel(request.status),
 				},
-				tokens: formatNumber(request.tokens),
+				tokens: formatTokensWithCached(request.tokens, request.cachedInputTokens),
 				cost: formatCurrency(request.cost),
 				error: rawError ? truncateText(rawError, 80) : "--",
 				errorTitle: rawError,
@@ -1031,6 +1202,20 @@
 		return responsePayload;
 	};
 
+	const putJson = async (url, payload, label) => {
+		const response = await fetch(url, {
+			method: "PUT",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(payload || {}),
+		});
+		const responsePayload = await readResponsePayload(response);
+		if (!response.ok) {
+			const message = extractErrorMessage(responsePayload);
+			throw new Error(message || `Failed to ${label} (${response.status})`);
+		}
+		return responsePayload;
+	};
+
 	const deleteJson = async (url, label) => {
 		const response = await fetch(url, { method: "DELETE" });
 		const responsePayload = await readResponsePayload(response);
@@ -1055,6 +1240,16 @@
 	const fetchRequestLogs = async (limit) =>
 		fetchJson(API_ENDPOINTS.requestLogs(limit), "request logs");
 
+	const normalizeSettingsPayload = (payload) => ({
+		stickyThreadsEnabled: Boolean(payload?.stickyThreadsEnabled),
+		preferEarlierResetAccounts: Boolean(payload?.preferEarlierResetAccounts),
+	});
+
+	const fetchSettings = async () => {
+		const payload = await fetchJson(API_ENDPOINTS.settings, "settings");
+		return normalizeSettingsPayload(payload);
+	};
+
 	const registerApp = () => {
 		Alpine.data("feApp", () => ({
 			view: "dashboard",
@@ -1063,6 +1258,11 @@
 			ui: createUiConfig(),
 			dashboardData: createEmptyDashboardData(),
 			dashboard: createEmptyDashboardView(),
+			settings: {
+				stickyThreadsEnabled: false,
+				preferEarlierResetAccounts: false,
+				isSaving: false,
+			},
 			accounts: {
 				selectedId: "",
 				rows: [],
@@ -1158,12 +1358,14 @@
 						primaryResult,
 						secondaryResult,
 						requestLogsResult,
+						settingsResult,
 					] = await Promise.allSettled([
 						fetchAccounts(),
 						fetchUsageSummary(),
 						fetchUsageWindow("primary"),
 						fetchUsageWindow("secondary"),
 						fetchRequestLogs(50),
+						fetchSettings(),
 					]);
 					const errors = [];
 					if (accountsResult.status !== "fulfilled") {
@@ -1196,6 +1398,12 @@
 						errors.push(requestLogsResult.reason);
 					}
 
+					const settings =
+						settingsResult.status === "fulfilled" ? settingsResult.value : null;
+					if (settingsResult.status === "rejected") {
+						errors.push(settingsResult.reason);
+					}
+
 					const mergedAccounts = mergeUsageIntoAccounts(
 						accountsResult.value,
 						primaryUsage,
@@ -1208,6 +1416,7 @@
 							primaryUsage,
 							secondaryUsage,
 							requestLogs,
+							settings,
 						},
 						preferredId,
 					);
@@ -1252,11 +1461,54 @@
 					primaryUsage: data.primaryUsage,
 					secondaryUsage: data.secondaryUsage,
 					requestLogs: data.requestLogs,
+					settings: data.settings,
 				});
+				if (data.settings) {
+					this.settings.stickyThreadsEnabled = Boolean(
+						data.settings.stickyThreadsEnabled,
+					);
+					this.settings.preferEarlierResetAccounts = Boolean(
+						data.settings.preferEarlierResetAccounts,
+					);
+				}
 				this.ui.usageWindows = buildUsageWindowConfig(data.summary);
 				this.dashboard = buildDashboardView(this);
 				this.syncAccountSearchSelection();
 			},
+			async saveSettings() {
+				if (this.settings.isSaving) {
+					return;
+				}
+				this.settings.isSaving = true;
+				try {
+					const payload = {
+						stickyThreadsEnabled: this.settings.stickyThreadsEnabled,
+						preferEarlierResetAccounts: this.settings.preferEarlierResetAccounts,
+					};
+					const updated = await putJson(
+						API_ENDPOINTS.settings,
+						payload,
+						"save settings",
+					);
+					const normalized = normalizeSettingsPayload(updated);
+					this.settings.stickyThreadsEnabled = normalized.stickyThreadsEnabled;
+					this.settings.preferEarlierResetAccounts =
+						normalized.preferEarlierResetAccounts;
+					this.openMessageBox({
+						tone: "success",
+						title: "Settings saved",
+						message: "Routing settings updated.",
+					});
+				} catch (error) {
+					this.openMessageBox({
+						tone: "error",
+						title: "Settings save failed",
+						message: error.message || "Failed to save settings.",
+					});
+				} finally {
+					this.settings.isSaving = false;
+				}
+			},
 			focusAccountSearch() {
 				this.$refs.accountSearch?.focus();
 			},
@@ -1494,12 +1746,33 @@
 					window.open(this.authDialog.verificationUrl, "_blank", "noopener");
 				}
 			},
-			async copyToClipboard(value, label) {
-				if (!value) {
-					return;
+			calculateProgressClass(status, remainingPercent) {
+				return calculateProgressClass(status, remainingPercent);
+			},
+			calculateProgressTextClass(status, remainingPercent) {
+				return calculateProgressTextClass(status, remainingPercent);
+			},
+			async copyToClipboard(value, label, e) {
+				if (!value) return;
+
+				// Localized feedback in the button
+				let btn = null;
+				let originalText = "";
+				if (e && e.target) {
+					btn = e.target.tagName === "BUTTON" ? e.target : e.target.closest("button");
+					if (btn) {
+						originalText = btn.textContent;
+						btn.textContent = "Copied!";
+						btn.classList.add("copy-success");
+						window.setTimeout(() => {
+							btn.textContent = originalText;
+							btn.classList.remove("copy-success");
+						}, 4000);
+					}
 				}
+
 				try {
-					if (navigator.clipboard?.writeText) {
+					if (navigator.clipboard && navigator.clipboard.writeText) {
 						await navigator.clipboard.writeText(value);
 					} else {
 						const textarea = document.createElement("textarea");
@@ -1512,29 +1785,26 @@
 						document.execCommand("copy");
 						document.body.removeChild(textarea);
 					}
-					if (this.authDialog.open) {
-						const previousLabel = this.authDialog.statusLabel;
-						this.authDialog.statusLabel = `${label} copied.`;
-						window.setTimeout(() => {
-							if (this.authDialog.statusLabel === `${label} copied.`) {
-								this.authDialog.statusLabel = previousLabel;
-							}
-						}, 2000);
-					} else {
+
+					// Only show message box if auth dialog is not open and button feedback wasn't possible
+					if (!this.authDialog.open && !btn) {
 						this.openMessageBox({
 							tone: "success",
 							title: "Copied",
 							message: `${label} copied to clipboard.`,
 						});
 					}
-				} catch (error) {
-					if (this.authDialog.open) {
-						this.authDialog.statusLabel = "Copy failed.";
-					} else {
+				} catch (err) {
+					console.error("Clipboard error:", err);
+					if (btn) {
+						btn.textContent = "Failed";
+						btn.classList.remove("copy-success");
+						window.setTimeout(() => { btn.textContent = originalText; }, 2000);
+					} else if (!this.authDialog.open) {
 						this.openMessageBox({
 							tone: "error",
 							title: "Copy failed",
-							message: "Unable to copy to clipboard.",
+							message: `Could not copy ${label}.`,
 						});
 					}
 				}
@@ -1693,15 +1963,15 @@
 				const items =
 					this.view === "accounts"
 						? [
-								`Selection: ${this.accounts.selectedId || "--"}`,
-								`Rotation: ${this.dashboardData.routing?.rotationEnabled ? "enabled" : "disabled"}`,
-								`Last sync: ${lastSync}`,
-							]
+							`Selection: ${this.accounts.selectedId || "--"}`,
+							`Rotation: ${this.dashboardData.routing?.rotationEnabled ? "enabled" : "disabled"}`,
+							`Last sync: ${lastSync}`,
+						]
 						: [
-								`Last sync: ${lastSync}`,
-								`Routing: ${routingLabel(this.dashboardData.routing?.strategy)}`,
-								`Backend: ${this.backendPath}`,
-							];
+							`Last sync: ${lastSync}`,
+							`Routing: ${routingLabel(this.dashboardData.routing?.strategy)}`,
+							`Backend: ${this.backendPath}`,
+						];
 				if (this.importState.isLoading) {
 					items.unshift(
 						`Importing ${this.importState.fileName || "auth.json"}...`,
@@ -1878,6 +2148,7 @@
 			statusLabel,
 			requestStatusLabel,
 			requestStatusClass,
+			calculateTextUsageTextClass,
 			progressClass,
 			planLabel,
 			routingLabel,
@@ -1894,7 +2165,14 @@
 			formatQuotaResetLabel,
 			formatAccessTokenLabel,
 			formatRefreshTokenLabel,
+			formatAccessTokenLabel,
+			formatRefreshTokenLabel,
 			formatIdTokenLabel,
+			theme: localStorage.getItem('theme') || 'dark',
+			toggleTheme() {
+				this.theme = this.theme === 'dark' ? 'light' : 'dark';
+				localStorage.setItem('theme', this.theme);
+			},
 		}));
 	};
 

{codex_lb-0.2.0.dist-info → codex_lb-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-lb
-Version: 0.2.0
+Version: 0.3.1
 Summary: Codex load balancer and proxy for ChatGPT accounts with usage dashboard
 Author-email: Soju06 <qlskssk@gmail.com>
 Maintainer-email: Soju06 <qlskssk@gmail.com>
@@ -39,7 +39,7 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: System :: Networking
 Requires-Python: >=3.13
 Requires-Dist: aiohttp-retry>=2.9.1
-Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: aiohttp>=3.13.3
 Requires-Dist: aiosqlite>=0.22.1
 Requires-Dist: cryptography>=46.0.3
 Requires-Dist: fastapi[standard]>=0.128.0
@@ -55,9 +55,13 @@ Description-Content-Type: text/markdown
 
 Load balancer for ChatGPT accounts. Pool multiple accounts, track usage, view everything in a dashboard.
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/Soju06/codex-lb/main/docs/screenshots/dashboard.jpeg" alt="Codex Load Balancer dashboard" width="100%">
-</p>
+### Main Dashboard View
+
+![main dashboard view](docs/screenshots/dashboard.jpg)
+
+### Accounts View
+
+![Accounts list and details](docs/screenshots/accounts.jpg)
 
 ## Quick Start
 
@@ -78,9 +82,7 @@ uvx codex-lb
 
 Open [localhost:2455](http://localhost:2455) → Add account → Done.
 
-## Accounts view
 
-![Accounts list and details](https://raw.githubusercontent.com/Soju06/codex-lb/main/docs/screenshots/accounts.jpeg)
 
 ## Codex CLI & Extension Setup
 
@@ -102,7 +104,31 @@ requires_openai_auth = true  # Required: enables model selection in Codex IDE ex
 ## Data
 
 All data stored in `~/.codex-lb/`:
+
 - `store.db` – accounts, usage logs
 - `encryption.key` – encrypts tokens (auto-generated)
 
 Backup this directory to preserve your accounts.
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Soju06"><img src="https://avatars.githubusercontent.com/u/34199905?v=4?s=100" width="100px;" alt="Soju06"/><br /><sub><b>Soju06</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Tests">⚠️</a> <a href="#maintenance-Soju06" title="Maintenance">🚧</a> <a href="#infra-Soju06" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://jonas.kamsker.at/"><img src="https://avatars.githubusercontent.com/u/11245306?v=4?s=100" width="100px;" alt="Jonas Kamsker"/><br /><sub><b>Jonas Kamsker</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=JKamsker" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AJKamsker" title="Bug reports">🐛</a> <a href="#maintenance-JKamsker" title="Maintenance">🚧</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Quack6765"><img src="https://avatars.githubusercontent.com/u/5446230?v=4?s=100" width="100px;" alt="Quack"/><br /><sub><b>Quack</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Quack6765" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AQuack6765" title="Bug reports">🐛</a> <a href="#maintenance-Quack6765" title="Maintenance">🚧</a> <a href="#design-Quack6765" title="Design">🎨</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!