Skip to content

perplexity.md

Latest commit

 

History

History
98 lines (68 loc) · 4.28 KB

perplexity.md

File metadata and controls

98 lines (68 loc) · 4.28 KB
Raw
summary Perplexity provider: browser cookie setup, credits API, recurring/bonus/purchased credit display.
read_when
Configuring Perplexity usage
Debugging Perplexity browser cookie import or manual session tokens
Adjusting Perplexity credit display

Perplexity Provider

CodexBar reads Perplexity account credit data with a Perplexity web session cookie. It does not use a Perplexity API key and does not support token-cost history.

Setup

  1. Open Settings -> Providers.
  2. Enable Perplexity.
  3. Sign in to perplexity.ai in a supported browser.
  4. Leave Cookie source on Automatic, or switch to Manual and paste a full Cookie: header or a bare Perplexity session-token value.

Manual mode accepts these session cookie names:

  • __Secure-authjs.session-token
  • authjs.session-token
  • __Secure-next-auth.session-token
  • next-auth.session-token

You can also provide credentials through the environment:

export PERPLEXITY_SESSION_TOKEN="..."
export PERPLEXITY_COOKIE="__Secure-next-auth.session-token=..."

Data Source

CodexBar requests:

  • GET https://www.perplexity.ai/rest/billing/credits?version=2.18&source=default

The request sends the resolved Perplexity session cookie, Origin: https://www.perplexity.ai, and Referer: https://www.perplexity.ai/account/usage.

Automatic mode tries any cached Perplexity cookie first, then imports browser cookies, then falls back to environment variables. Browser-imported cookies are cached and invalid cached cookies are cleared after a rejected request. The bundled JavaScript provider owns fetching and credit parsing on QuickJS and JavaScriptCore. It retries the four supported cookie names for a bare token, assembles numbered session-cookie chunks, and advances through browser profiles after rejected credentials. Manual mode stays exclusive and never falls back to an environment token.

Display

  • Credits: recurring account credits when Perplexity reports them.
  • Bonus credits: promotional or bonus credits.
  • Purchased: on-demand purchased credits.
  • Organization: organization pool credits, shown when the API reports org_pool_draws_cents or org_user_cap_cents. Used is org_pool_draws_cents; available is the part of balance_cents not covered by the member's own credits, or zero when is_org_pool_depleted is true. The member's cap is not counted as available.
  • Renewal: recurring credits use the renewal timestamp when the API returns one.

The menu-bar percent picker can explicitly show Credits or Bonus credits, including when the API reports no duration. These choices use the actual credit pools without inventing a session or weekly cadence. Automatic keeps the existing recurring → purchased → bonus consumption order, then falls back to org credits.

When an org pool is reported, Organization is also available as a named percent window. With window labels enabled, Auto identifies that pool as Organization.

Purchased, bonus, and org credits do not reset, so their balances remain details in menus and CLI output. Layout reset-time tokens require an actual reset date for credit-detail windows; amounts never stand in for a reset clock.

Large finite credit counts retain their whole-number descriptions; nonfinite aggregate counts omit the description.

CLI Usage

codexbar usage --provider perplexity --verbose

Troubleshooting

"Perplexity session token is missing"

Sign in to perplexity.ai and refresh CodexBar, or paste a fresh cookie/session token in manual mode.

"Perplexity session token is invalid or expired"

Log out and back in to Perplexity. If manual mode is enabled, paste a new Cookie: header or session-token value.

Credits do not appear

Open Perplexity account usage in the same browser profile and confirm the account has visible credit data.

Related Files

  • Sources/CodexBarCore/Providers/Perplexity/PerplexityProviderDescriptor.swift
  • Sources/CodexBarCore/Resources/Plugins/perplexity.js
  • Sources/CodexBarCore/Plugins/ProviderPluginCookieBroker.swift
  • Sources/CodexBarCore/Providers/Perplexity/PerplexityCookieHeader.swift
  • Sources/CodexBar/Providers/Shared/PluginCookieProviderImplementation.swift