Poe Provider
June 15, 2026 · View on GitHub
CodexBar reads Poe's official usage API with a manually configured API key. It does not perform OAuth login or import browser cookies.
Authentication
Create or copy an API key from Poe API Keys, then add it in CodexBar Settings → Providers → Poe.
You can also set the environment variable:
export POE_API_KEY="..."
Or configure it through the CLI:
printf '%s' "$POE_API_KEY" | codexbar config set-api-key --provider poe --stdin
Data Source
CodexBar requests:
GET https://api.poe.com/usage/current_balanceGET https://api.poe.com/usage/points_history
The current balance request is required. Recent points history is best-effort, so a history error does not hide a valid balance.
Display
The provider shows the current point balance in the menu and menu bar. When available, recent history is grouped by day and shown in the usage detail.
CLI Usage
codexbar --provider poe