copilot.md

summary	read_when
Copilot provider data sources: GitHub device flow + Copilot internal usage API.	Debugging Copilot login or usage parsing Updating GitHub OAuth device flow behavior

Copilot provider

Copilot uses GitHub OAuth device flow and the Copilot internal usage API. No browser cookies.

Data sources + fallback order

1. GitHub OAuth device flow (user initiated)

   • Device code request:
     • POST https://github.com/login/device/code
   • Token polling:
     • POST https://github.com/login/oauth/access_token
   • Scope: read:user.
   • Token stored in config:
     • ~/.codexbar/config.json → providers[].apiKey for copilot

2. Usage fetch

   • GET https://api.github.com/copilot_internal/user
   • Headers:
     • Authorization: token <github_oauth_token>
     • Accept: application/json
     • Editor-Version: vscode/1.96.2
     • Editor-Plugin-Version: copilot-chat/0.26.7
     • User-Agent: GitHubCopilotChat/0.26.7
     • X-Github-Api-Version: 2025-04-01

Snapshot mapping

• Primary: quotaSnapshots.premiumInteractions percent remaining → used percent.
• Secondary: quotaSnapshots.chat percent remaining → used percent.
• Reset dates are not provided by the API.
• Plan label from copilotPlan.

Key files

• Sources/CodexBarCore/Providers/Copilot/CopilotUsageFetcher.swift
• Sources/CodexBarCore/Providers/Copilot/CopilotDeviceFlow.swift
• Sources/CodexBar/Providers/Copilot/CopilotLoginFlow.swift
• Sources/CodexBar/CopilotTokenStore.swift (legacy migration helper)