diff --git a/00-quick-start/README.md b/00-quick-start/README.md index 3891c9a9..0a41e6a0 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -143,17 +143,20 @@ After trusting the folder, you can sign in with your GitHub account. > /login ``` -**What happens next:** +**What happens next (local terminal):** -1. Copilot CLI displays a one-time code (like `ABCD-1234`) -2. Your browser opens to GitHub's device authorization page. Sign in to GitHub if you haven't already. -3. Enter the code when prompted -4. Select "Authorize" to grant GitHub Copilot CLI access -5. Return to your terminal - you're now signed in! +1. Choose to sign into your GitHub.com account or an enterprise account. +2. Select `Sign in with your browser (recommended)` +3. Your browser opens automatically to GitHub's authorization page. Sign in to GitHub if you haven't already. +4. Select "Authorize" to grant GitHub Copilot CLI access. +5. Return to your terminal — you're now signed in! -Device Authorization Flow - showing the 5-step process from terminal login to signed-in confirmation - -*The device authorization flow: your terminal generates a code, you verify it in the browser, and Copilot CLI is authenticated.* +> 💡 **Remote or headless terminals**: If you're on a remote server or a terminal without a browser (such as SSH), Copilot CLI falls back to the **device code flow** instead. You'll see a one-time code like `ABCD-1234`. Visit [github.com/login/device](https://github.com/login/device) in a browser on another machine and enter the code to complete sign-in. To force a specific flow, use `copilot login --web-flow` to use the browser popup or `copilot login --device-code` to use the code-based flow. You can also pick interactively with `/login`. +> +> Device Authorization Flow - showing the 5-step process from terminal login to signed-in confirmation +> + +*The browser-based flow: your browser opens automatically and you authorize in one click. On remote/headless terminals, a device code is shown instead.* **Tip**: The sign-in persists across sessions. You only need to do this once unless your token expires or you explicitly sign out. @@ -267,7 +270,7 @@ copilot ### Browser doesn't open automatically -Manually visit [github.com/login/device](https://github.com/login/device) and enter the code shown in your terminal. +On remote or headless terminals, the device code flow is used instead. Your terminal will display a one-time code. Visit [github.com/login/device](https://github.com/login/device) and enter the code, then authorize access. ### Token expired diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index 13afdafe..18b36e51 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -410,6 +410,7 @@ That's it for getting started! As you become comfortable, you can explore additi | `/env` | Show loaded environment details — what instructions, MCP servers, skills, agents, and plugins are active | | `/init` | Initialize Copilot instructions for your repository | | `/mcp` | Manage MCP server configuration | +| `/plugins` | Enable or disable plugins, instructions, agents, LSP servers, and hooks without restarting the session | | `/settings` | Open an interactive dialog to browse and edit all user settings in one place | | `/skills` | Manage skills for enhanced capabilities | @@ -440,6 +441,7 @@ That's it for getting started! As you become comfortable, you can explore additi |---------|--------------| | `/add-dir ` | Add a directory to allowed list | | `/allow-all [on\|off\|show]` | Auto-approve all permission prompts; use `on` to enable, `off` to disable, `show` to check current status | +| `/permissions` | Switch between approval modes (interactive, plan, autopilot) for controlling how much Copilot can do without asking | | `/yolo` | Quick alias for `/allow-all on` — auto-approves all permission prompts. | | `/cwd`, `/cd [directory]` | View or change working directory | | `/list-dirs` | Show all allowed directories |