auth command manages the GitHub accounts that Copilot API authenticates with. You can add accounts through the GitHub OAuth device flow, list registered accounts with optional quota information, and remove accounts by username or index. Copilot API supports multiple accounts simultaneously — premium-model requests use accounts in order and fall back on quota exhaustion, while free-model requests distribute across accounts in round-robin.
Subcommands
Running
auth without a subcommand defaults to auth add, which preserves backward compatibility with earlier versions.
auth add
Starts the GitHub OAuth device flow to register a new account. Your browser opens to a GitHub authorization page where you enter a one-time code. Once authorized, the token is saved to your local data directory.Usage
Options
Examples
auth ls
Lists all accounts registered in your local account registry. Use--show-quota to also fetch and display current quota information for each account.
Usage
Options
Examples
The index shown in
auth ls output is 1-based and corresponds to the <target> argument used by auth rm. The GET /usage/:accountIndex API endpoint uses a separate 0-based index.auth rm
Removes a registered account from the local account registry. Provide either the GitHub username (account ID) or the 1-based index shown byauth ls.