From 1b98d45c7720ce1e11a0d1bdefb8118e6acf7a2e Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Sun, 25 Jan 2026 21:45:50 +0100 Subject: [PATCH] docs(coding-agent): simplify resolution order, remove troubleshooting --- packages/coding-agent/docs/authentication.md | 20 ++++---------------- 1 file changed, 4 insertions(+), 16 deletions(-) diff --git a/packages/coding-agent/docs/authentication.md b/packages/coding-agent/docs/authentication.md index 9ea238c4..ba7b0fe6 100644 --- a/packages/coding-agent/docs/authentication.md +++ b/packages/coding-agent/docs/authentication.md @@ -9,7 +9,6 @@ Pi supports subscription-based providers via OAuth and API key providers via env - [Auth File](#auth-file) - [Cloud Providers](#cloud-providers) - [Resolution Order](#resolution-order) -- [Troubleshooting](#troubleshooting) ## Subscriptions @@ -135,18 +134,7 @@ Or set `GOOGLE_APPLICATION_CREDENTIALS` to a service account key file. When resolving credentials for a provider: -1. CLI `--api-key` flag (runtime override) -2. API key from `auth.json` -3. OAuth token from `auth.json` (auto-refreshed) -4. Environment variable -5. Custom provider keys from `models.json` - -## Troubleshooting - -**Port 1455 in use:** OAuth callback server can't start. Close the conflicting process or paste the auth URL manually when prompted. - -**Token expired / refresh failed:** Run `/login` again to re-authenticate. - -**Rate limits (429):** Wait for the reset window. Pi shows the approximate retry time. - -**"model not supported" (GitHub Copilot):** Enable the model in VS Code first. +1. CLI `--api-key` flag +2. `auth.json` entry (API key or OAuth token) +3. Environment variable +4. Custom provider keys from `models.json`