Troubleshooting

Start with the symptom that matches. Most extension issues are “app not running” or “wrong page.” In the app, Settings → About links back here and to feedback.

Usage not updating

  • Click Refresh on the dashboard.
  • Confirm the provider still shows as connected (not Disabled) in Settings → Providers.
  • Re-test the connection; sessions expire and may need a reconnect via the extension or Reauthenticate.
  • Provider APIs change — if one provider fails while others work, wait for an app update or try reconnecting.

Undocumented API breaks

  • Most providers (except OpenRouter’s credits API) use undocumented endpoints. Sites can change without notice.
  • If refresh fails with auth or parse errors after a provider redesign, reconnect or wait for a Vale update.
  • Check Settings → About for per-provider Stable vs Undocumented badges, Check for updates, and Changelog on this site.
  • Report a break via feedback (include Vale version from About, provider, and the error you saw).

Sign-in and connection sync

  • Email sign-in is required — there is no local-only guest mode.
  • No code? Check spam, use Resend code or Open email app on the OTP screen, or open the magic link from the same email.
  • If sync seems stuck, sign out from the sidebar account menu (or Settings → Account) and sign back in.
  • Usage history never syncs — only provider connection metadata does.
  • Antigravity OAuth: complete the Google flow in-app; do not expect the browser extension to connect it.

Billing and subscription

  • After starting a trial or checkout, open Settings → Billing and use Refresh status if Power features stay locked.
  • Update payment method, view invoices, or cancel from Settings → Billing — actions route to Stripe or Paymob based on how you subscribed.
  • Payment Provider preference (Auto / Stripe / Paymob) affects the next paid checkout; it does not move an existing subscription between processors.
  • Lifetime complimentary grants show as Power without update-payment / cancel actions — use feedback or email support if status looks wrong.
  • See Billing for plan limits.

Free account limit

  • Free allows up to five active accounts (provider connections). Two Cursor accounts count as two. Disable or remove one in Settings → Providers to add another, or upgrade to Power.
  • Hitting the limit shows an error and opens Billing so you can upgrade.
  • After a Power plan ends, Vale may keep extra connections but disable all except the five oldest — re-enable only within the Free cap, or subscribe again.

Extension won’t connect

  • Vale desktop must be running (it owns port 3456 on localhost).
  • Extension enabled; reload it from the browser’s extensions page after updates.
  • You must be on the matching provider URL (see Extension).
  • Sign in on the provider site first, then open the popup and Connect.
  • In Vale, start Add Provider with Browser Extension first — the extension needs Vale to be waiting.
  • Refresh the tab and try again.

Vale doesn’t receive credentials

  • Firewall or security software blocking localhost HTTP to 127.0.0.1:3456.
  • Another process using port 3456 — quit other Vale instances.
  • In Add Provider, stay on Browser Extension / waiting until Connect succeeds.

Notifications

  • Allow notifications for Vale in system settings.
  • Confirm Enable notifications is on in Settings → Notifications.
  • Custom quota/credit thresholds and Notify on limit reset require Power.

Still stuck?

Use the feedback form (also linked from Settings → About → Feedback) — include your Vale version, provider, and what you saw. Or email support@valeapp.app. The product repo is private — there is no public GitHub issues tracker.