Add the Synthetic provider

README.md

@@ -125,6 +125,7 @@ See the full history in [CHANGELOG.md](CHANGELOG.md).
 | llmman | Local daemon / optional API Key | Memory in use, loaded and stored models |
 | DevPass | API Key | Plan credits, Premium weekly, API-key spend |
 | xKiro | API Key | Daily free tokens |
+| Synthetic | API Key | Five-hour quota, Weekly tokens, Hourly search, Plan |
 
 </details>
 

apps/desktop-tauri/src/components/providers/providerIcons.test.ts

@@ -164,6 +164,7 @@ describe("provider icon registry", () => {
       "elevenlabs",
       "manus",
       "replicate",
+      "synthetic",
       "typesafe",
       "v0",
     ]);

apps/desktop-tauri/src/components/providers/providerIcons.ts

@@ -64,6 +64,7 @@ import replicate from "./icons/ProviderIcon-replicate.svg?raw";
 import sakana from "./icons/ProviderIcon-sakana.svg?raw";
 import stepfun from "./icons/ProviderIcon-stepfun.svg?raw";
 import sub2api from "./icons/ProviderIcon-sub2api.svg?raw";
+import synthetic from "./icons/ProviderIcon-synthetic.svg?raw";
 import t3chat from "./icons/ProviderIcon-t3chat.svg?raw";
 import venice from "./icons/ProviderIcon-venice.svg?raw";
 import vercel from "./icons/ProviderIcon-vercel.svg?raw";
@@ -158,6 +159,7 @@ const RAW: Record<string, string> = {
   sakana: tint(sakana),
   stepfun: tint(stepfun),
   sub2api: tint(sub2api),
+  synthetic: tint(synthetic),
   t3chat: tint(t3chat),
   venice: tint(venice),
   vercel: tint(vercel),
@@ -251,6 +253,7 @@ export const PROVIDER_ICON_REGISTRY: Record<string, ProviderIcon> = {
   sub2api:     { id: "sub2api",     brandColor: "#14b8a6", fallbackLetter: "S", svgPath: RAW.sub2api },
   venice:      { id: "venice",      brandColor: "#3c8fdd", fallbackLetter: "V", svgPath: RAW.venice },
   vercel:      { id: "vercel",      brandColor: "#737373", fallbackLetter: "V", svgPath: RAW.vercel },
+  synthetic:   { id: "synthetic",   brandColor: "#141414", fallbackLetter: "S", svgPath: RAW.synthetic },
   openaiapi:   { id: "openaiapi",   brandColor: "#0f826e", fallbackLetter: "O" },
   chutes:      { id: "chutes",      brandColor: "#3184ff", fallbackLetter: "C" },
   litellm:     { id: "litellm",     brandColor: "#4c89f0", fallbackLetter: "L" },

apps/desktop-tauri/src/test/providerCatalog.ts

@@ -86,4 +86,5 @@ export const TEST_PROVIDER_CATALOG: Array<[string, string]> = [
   ["devpass", "DevPass"],
   ["xkiro", "xKiro"],
   ["raycast", "Raycast"],
+  ["synthetic", "Synthetic"],
 ];

docs/PROVIDERS.md

@@ -185,6 +185,25 @@ are never followed and response bodies are never echoed in errors.
   budget, inconsistent coverage, malformed amounts) is a parse error, not a
   partial balance.
 
+### Synthetic
+
+Synthetic reads `GET https://api.synthetic.new/v2/quotas` with
+`Authorization: Bearer <key>`. Configure the key in Settings → Providers →
+Synthetic (or `SYNTHETIC_API_KEY`); the CLI also accepts `synthetic.new`.
+
+- `rollingFiveHourLimit` is the "Five-hour quota" lane, `weeklyTokenLimit` the
+  "Weekly tokens" lane and `search.hourly` a "Search hourly" window. Other
+  payload shapes fall back to the first quota-like objects found under
+  `quotas`, `quota`, `limits`, `usage`, `entries`, `subscription` or `data`.
+- When the five-hour quota reports `tickPercent`, the lane resets at the next
+  regen tick and its detail line reads, for example,
+  "76% after next regen · Full in ~3 regens". The weekly lane does the same
+  when it carries `maxCredits` and `nextRegenCredits`. Like the Mac card, no
+  weekly USD cost is shown (on the card or in CLI JSON).
+- The plan name (`plan`, `planName`, `tier`, ...) is shown as the plan.
+- 401 and 403 report "Invalid Synthetic API credentials."; response bodies are
+  never echoed in errors.
+
 ## Listing what is enabled
 
 ```powershell

rust/src/core/provider.rs

@@ -103,6 +103,7 @@ pub enum ProviderId {
     XKiro,
     Raycast,
     Vercel,
+    Synthetic,
 }
 
 impl ProviderId {
@@ -198,6 +199,7 @@ impl ProviderId {
             ProviderId::XKiro,
             ProviderId::Raycast,
             ProviderId::Vercel,
+            ProviderId::Synthetic,
         ]
     }
 
@@ -254,6 +256,7 @@ impl ProviderId {
             ProviderId::XKiro => "xkiro",
             ProviderId::Raycast => "raycast",
             ProviderId::Vercel => "vercel",
+            ProviderId::Synthetic => "synthetic",
             ProviderId::AiAnd => "aiand",
             ProviderId::Windsurf => "windsurf",
             ProviderId::Manus => "manus",
@@ -350,6 +353,7 @@ impl ProviderId {
             ProviderId::XKiro => "xKiro",
             ProviderId::Raycast => "Raycast",
             ProviderId::Vercel => "Vercel AI Gateway",
+            ProviderId::Synthetic => "Synthetic",
             ProviderId::AiAnd => "ai&",
             ProviderId::Windsurf => "Windsurf",
             ProviderId::Manus => "Manus",
@@ -462,6 +466,7 @@ impl ProviderId {
             ProviderId::DevPass => None,
             ProviderId::XKiro => None,
             ProviderId::Vercel => None,
+            ProviderId::Synthetic => None,
             ProviderId::AiAnd => None,
             ProviderId::Windsurf => None,
             ProviderId::Doubao => None,
@@ -614,6 +619,7 @@ impl ProviderId {
             "replicate" | "r8" => Some(ProviderId::Replicate),
             "atlascloud" | "atlas-cloud" | "atlas cloud" => Some(ProviderId::AtlasCloud),
             "raycast" | "raycast-ai" => Some(ProviderId::Raycast),
+            "synthetic" | "synthetic.new" => Some(ProviderId::Synthetic),
             _ => None,
         }
     }
@@ -1142,6 +1148,7 @@ pub fn cli_name_map() -> HashMap<&'static str, ProviderId> {
     map.insert("vercel ai gateway", ProviderId::Vercel);
     map.insert("ai-gateway", ProviderId::Vercel);
     map.insert("ai gateway", ProviderId::Vercel);
+    map.insert("synthetic.new", ProviderId::Synthetic);
     map.insert("metaspark", ProviderId::Meta);
     map.insert("meta-spark", ProviderId::Meta);
     map.insert("muse-spark", ProviderId::Meta);
@@ -1309,6 +1316,7 @@ pub fn brand_color(id: ProviderId) -> &'static str {
         // neutral keeps contrast on light and dark surfaces (user decision
         // 2026-10-10, Mac-parity palette pass).
         ProviderId::Vercel => "#737373",
+        ProviderId::Synthetic => "#141414",
     }
 }
 
@@ -1323,7 +1331,7 @@ mod tests {
     #[test]
     fn test_provider_id_all() {
         let all = ProviderId::all();
-        assert_eq!(all.len(), 89);
+        assert_eq!(all.len(), 90);
         assert!(all.contains(&ProviderId::Claude));
         assert!(all.contains(&ProviderId::Codex));
         assert!(all.contains(&ProviderId::Pi));
@@ -1393,6 +1401,7 @@ mod tests {
         assert!(all.contains(&ProviderId::XKiro));
         assert!(all.contains(&ProviderId::Raycast));
         assert!(all.contains(&ProviderId::Vercel));
+        assert!(all.contains(&ProviderId::Synthetic));
     }
 
     #[test]

rust/src/core/provider_factory.rs

@@ -7,6 +7,7 @@
 
 use super::{Provider, ProviderId};
 use crate::providers::AtlasCloudProvider;
+use crate::providers::SyntheticProvider;
 use crate::providers::{
     AbacusProvider, AiAndProvider, AixyProvider, AlibabaProvider, AlibabaTokenPlanProvider,
     AmpProvider, AntigravityProvider, AugmentProvider, AzureOpenAIProvider, BedrockProvider,
@@ -41,6 +42,7 @@ pub fn instantiate(id: ProviderId) -> Box<dyn Provider> {
         ProviderId::Copilot => Box::new(CopilotProvider::new()),
         ProviderId::Antigravity => Box::new(AntigravityProvider::new()),
         ProviderId::AtlasCloud => Box::new(AtlasCloudProvider::new()),
+        ProviderId::Synthetic => Box::new(SyntheticProvider::new()),
         ProviderId::Factory => Box::new(FactoryProvider::new()),
         ProviderId::Zai => Box::new(ZaiProvider::new()),
         ProviderId::Kiro => Box::new(KiroProvider::new()),

rust/src/core/token_accounts.rs

@@ -431,7 +431,8 @@ impl TokenAccountSupport {
             | ProviderId::DevPass
             | ProviderId::XKiro
             | ProviderId::Raycast
-            | ProviderId::Vercel => None,
+            | ProviderId::Vercel
+            | ProviderId::Synthetic => None,
         }
     }
 

rust/src/providers/mod.rs

@@ -84,6 +84,7 @@ pub mod replicate;
 pub mod sakana;
 pub mod stepfun;
 pub mod sub2api;
+pub mod synthetic;
 pub mod t3chat;
 pub mod typesafe;
 pub mod v0;
@@ -175,6 +176,7 @@ pub use replicate::ReplicateProvider;
 pub use sakana::SakanaProvider;
 pub use stepfun::StepFunProvider;
 pub use sub2api::Sub2ApiProvider;
+pub use synthetic::SyntheticProvider;
 pub use t3chat::T3ChatProvider;
 pub use typesafe::TypeSafeProvider;
 pub use v0::V0Provider;