Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 13 additions & 10 deletions 00-quick-start/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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!

<img src="assets/auth-device-flow.png" alt="Device Authorization Flow - showing the 5-step process from terminal login to signed-in confirmation" width="800"/>

*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`.
>
> <img src="assets/auth-device-flow.png" alt="Device Authorization Flow - showing the 5-step process from terminal login to signed-in confirmation" width="800"/>
>

*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.

Expand Down Expand Up @@ -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

Expand Down
2 changes: 2 additions & 0 deletions 01-setup-and-first-steps/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |

Expand Down Expand Up @@ -440,6 +441,7 @@ That's it for getting started! As you become comfortable, you can explore additi
|---------|--------------|
| `/add-dir <directory>` | 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 |
Expand Down
Loading