Skip to content

Commit 4c9acfb

Browse files
GitHub Workshop BotCopilot
andcommitted
docs: update Appendix K/L with current Copilot/VS Code research findings
- Fix billing date: usage-based billing launched June 18, 2025 (not June 1, 2026) - Fix Free plan limits: 2,000 completions + 50 premium requests/month (not 50 completions) - Add #codebase as preferred alternative to superseded @workspace participant - Add #githubRepo variable (added VS Code v1.100) - Fix Chat modes description: unified view since v1.99, Edit mode is NOT deprecated - Update Plan mode: remove '(Public preview)' label - it is now GA - Fix Appendix L authoritative source: Copilot Extensions docs redirect to MCP - Strip 1,782 template phrase lines from 75 podcast scripts (chapters, challenges, appendices) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent b25daad commit 4c9acfb

77 files changed

Lines changed: 8830 additions & 10609 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/appendix-k-copilot-reference.md‎

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> **Reference companion to:** [Chapter 16: GitHub Copilot](16-github-copilot.md)
44
>
5-
> **Authoritative sources:** [GitHub Docs: Copilot](https://docs.github.com/en/copilot) | [VS Code Docs: Agents window](https://code.visualstudio.com/docs/copilot/agents/agents-window) | [VS Code 1.120 release notes](https://code.visualstudio.com/updates/v1_120)
5+
> **Authoritative sources:** [GitHub Docs: Copilot](https://docs.github.com/en/copilot) | [VS Code Docs: Copilot Chat](https://code.visualstudio.com/docs/copilot/chat/copilot-chat) | [VS Code 1.99 release notes (unified Chat view)](https://code.visualstudio.com/updates/v1_99)
66
77
> This appendix consolidates Copilot reference tables and Copilot model-selection guidance into one complete reference.
88
@@ -88,7 +88,7 @@ Type these in the Copilot Chat input to give Copilot context from a specific sou
8888

8989
| Participant | What It Does |
9090
| ------------- | ------------- |
91-
| `@workspace` | Searches your entire VS Code workspace for relevant context |
91+
| `@workspace` | Searches your entire VS Code workspace for relevant context. **Superseded by `#codebase`** (works in all modes, not just Ask). Prefer `#codebase` for new prompts. |
9292
| `@github` | Accesses GitHub.com data - search issues, PRs, code across the platform |
9393
| `@terminal` | Provides context from the VS Code integrated terminal |
9494

@@ -108,7 +108,8 @@ Type these in the Copilot Chat input to give Copilot context from a specific sou
108108
| ---------- | ----------------- |
109109
| `#file` | Opens a file picker - attach any file from your workspace |
110110
| `#selection` | Attaches your currently selected text |
111-
| `#codebase` | Searches the full codebase for relevant snippets |
111+
| `#codebase` | Searches the full codebase for relevant snippets (preferred over `@workspace`) |
112+
| `#githubRepo` | Search any GitHub repo you have access to: `how to implement X #githubRepo org/repo` (added v1.100) |
112113
| `#terminalLastCommand` | Attaches the last terminal command and its output |
113114

114115
#### Example prompts
@@ -161,14 +162,14 @@ Select a broken YAML template → /fix
161162

162163
## 4. Chat Modes
163164

164-
Copilot Chat has four modes. Select the current mode from the dropdown at the bottom of the Chat input area.
165+
Copilot Chat has four modes, unified into a single Chat view since VS Code v1.99 (March 2025). Select the current mode from the dropdown at the bottom of the Chat input area.
165166

166167
| Mode | What It Does | Best For |
167168
| ------ | ------------- | ---------- |
168169
| **Ask** | Conversational Q&A. Copilot explains, suggests, and answers but does not directly edit files. | Questions, explanations, discussion, exploring ideas |
169170
| **Edit** | You define a working set of files; Copilot proposes edits as a diff that you approve or reject. | Targeted, controlled multi-file edits |
170-
| **Agent** | Copilot works autonomously - it decides which files to touch, reads/writes code, runs terminal commands. | Larger end-to-end tasks |
171-
| **Plan** | Copilot writes an implementation plan first; no code is written until you approve the plan. (Public preview) | Complex features where you want to validate the approach first |
171+
| **Agent** | Copilot works autonomously - it decides which files to touch, reads/writes code, runs terminal commands. Uses MCP tools. | Larger end-to-end tasks |
172+
| **Plan** | Copilot writes an implementation plan first; no code is written until you approve the plan. | Complex features where you want to validate the approach first |
172173

173174
**Screen reader note:** The mode selector is in the Chat panel toolbar at the bottom. Tab through the bottom of the Chat view to find it. The current mode name is its accessible label. Press `Space` or `Enter` to open the dropdown.
174175

@@ -190,7 +191,7 @@ Copilot Chat has four modes. Select the current mode from the dropdown at the bo
190191

191192
- Chat responses appear in the panel with syntax highlighting -- increase the Chat panel font size via `editor.fontSize` in settings
192193
- The `@` and `/` trigger characters are small but the autocomplete popup that follows is large and themed to your current color scheme
193-
- Use Ask mode for reading explanations, Agent mode for controlled multi-file changes and autonomous tasks (Edit mode is being deprecated into Agent mode as of VS Code 1.118)
194+
- Use Ask mode for reading explanations, Agent mode for controlled multi-file changes and autonomous tasks. Edit mode is a distinct mode for scoped diff-based edits. All three modes are present in the unified Chat view since VS Code v1.99.
194195

195196
</details>
196197

@@ -2006,7 +2007,7 @@ GitHub Copilot offers access to AI models from multiple providers including Open
20062007

20072008
**Models are updated frequently.** This appendix no longer keeps a static model roster because the April-May 2026 changelog includes multiple additions, removals, and deprecations. For the latest additions and retirements, see the [GitHub Copilot changelog](https://github.blog/changelog/2026/?label=copilot) and [GitHub's official supported models documentation](https://docs.github.com/en/copilot/reference/ai-models/supported-models).
20082009

2009-
> **Workshop note, verified May 12, 2026:** GitHub Copilot is moving to usage-based billing on June 1, 2026. Check [GitHub Copilot settings](https://github.com/settings/copilot), the [GitHub Copilot plans page](https://github.com/features/copilot/plans), and the [usage-based billing documentation](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals) before the workshop.
2010+
> **Workshop note, verified May 2026:** GitHub Copilot usage-based billing via premium requests launched **June 18, 2025** for paid GitHub.com plans. Starting June 1, 2026, billing transitioned from Premium Request Units (PRUs) to **GitHub AI Credits**. Verify current plan limits at [GitHub Copilot settings](https://github.com/settings/copilot), the [GitHub Copilot plans page](https://github.com/features/copilot/plans), and the [usage-based billing documentation](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals) before the workshop.
20102011
20112012
## 2. How to Choose a Model
20122013

@@ -2044,14 +2045,14 @@ The following table lists the official sources to use instead of static model ta
20442045
| Usage-based billing details | [Usage-based billing for individuals](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals) |
20452046
| Billing transition announcement | [GitHub Copilot usage-based billing announcement](https://github.blog/news-insights/company-news/github-copilot-is-moving-to-usage-based-billing/) |
20462047

2047-
### Source-backed facts verified May 12, 2026
2048+
### Source-backed facts verified May 2026
20482049

2049-
- GitHub Copilot moves to usage-based billing on June 1, 2026.
2050-
- Premium request units are being replaced by GitHub AI Credits.
2050+
- GitHub Copilot usage-based billing (premium requests) launched **June 18, 2025** for paid GitHub.com plans.
2051+
- Starting June 1, 2026, Premium Request Units (PRUs) transitioned to GitHub AI Credits.
20512052
- One GitHub AI Credit equals $0.01 USD in the usage-based billing documentation.
20522053
- Copilot Chat, Copilot CLI, Copilot cloud agent, Copilot Spaces, Spark, and third-party coding agents consume AI Credits.
20532054
- Code completions and next edit suggestions are not billed in AI Credits for paid plans.
2054-
- Copilot code review is expected to consume GitHub Actions minutes in addition to GitHub AI Credits starting June 1, 2026.
2055+
- Copilot code review consumes GitHub Actions minutes in addition to GitHub AI Credits.
20552056
- Model availability changes frequently, and multiple models were deprecated or retired in the April-May 2026 changelog.
20562057

20572058
## 4. Model Availability by Plan
@@ -2063,7 +2064,7 @@ Plan names, included usage, and model access can change by date, account type, o
20632064
- **Copilot Free** can support short, focused workshop prompts, but it has monthly limits.
20642065
- **Verified students** may have access to GitHub Copilot Student plan benefits.
20652066
- **Organization and enterprise users** may have Copilot access managed by an administrator.
2066-
- **Paid plans** include more usage and broader feature access, but the billing unit changes to GitHub AI Credits on June 1, 2026.
2067+
- **Paid plans** include more usage and broader feature access. GitHub AI Credits are the billing unit since June 1, 2026.
20672068
- **Annual individual plans** may follow transition rules that differ from monthly plans.
20682069

20692070
Check [GitHub Copilot settings](https://github.com/settings/copilot) for your account and the [GitHub Copilot plans page](https://github.com/features/copilot/plans) for current public plan details.
@@ -2143,7 +2144,7 @@ To stay current, watch the [GitHub Copilot changelog](https://github.blog/change
21432144

21442145
| Plan | Monthly Cost | Included Usage | Features | Best For |
21452146
|------|--------------|----------------|----------|----------|
2146-
| **Free** | $0 | 50 completions, 2K chat tokens/month | Basic Copilot Chat, inline suggestions, limited chat | Getting started, light workshops |
2147+
| **Free** | $0 | 2,000 inline suggestions, 50 premium requests/month | Basic Copilot Chat, inline suggestions, limited chat | Getting started, light workshops |
21472148
| **Pro** | $10 / month | Unlimited completions, higher chat limits | Full Chat, Copilot CLI, custom instructions | Individual developers |
21482149
| **Pro+** | $39 / month | Unlimited all features | All Pro + agents, Copilot Cloud, Codex models | Complex workflows, agentic development |
21492150
| **Team** | $35 / seat / month (min 2 seats) | Org-managed limits | Team governance, Copilot Spaces, audit logging | Teams and organizations |
@@ -2159,16 +2160,16 @@ To stay current, watch the [GitHub Copilot changelog](https://github.blog/change
21592160

21602161
| Feature | Limit |
21612162
|---------|-------|
2162-
| Completions (ghost text suggestions) | 50 per month |
2163-
| Chat messages (Copilot Chat) | 2,000 context tokens total per month |
2164-
| Inline Chat (`Ctrl+I`) | Counts against chat limit |
2165-
| Agent requests | Not included - Free plan cannot run agents |
2163+
| Completions (ghost text / inline suggestions) | **2,000 per month** |
2164+
| Premium requests (Copilot Chat, agents, premium features) | **50 per month** |
2165+
| Inline Chat (`Ctrl+I`) | Counts against premium request limit |
2166+
| Copilot cloud agent | Not available on Free plan |
21662167
| Custom instructions | Available, but limited context |
2167-
| Models | Auto selection only; cannot manually choose models |
2168+
| Models | Auto selection only; cannot manually choose premium models |
21682169

21692170
#### Free Plan Restrictions
21702171

2171-
- **No agent support:** If your workshop uses agents (e.g., `@web-accessibility-wizard`), Free plan users cannot participate in those exercises
2172+
- **No Copilot cloud agent:** Free plan users cannot use the async cloud agent (GitHub Actions-powered). Local VS Code agent mode may work within the 50 premium request limit.
21722173
- **Chat limits can be reached quickly:** 2K tokens is roughly 3-5 multi-turn chat conversations depending on context size
21732174
- **No Copilot CLI:** Free plan users cannot use the Copilot CLI for command-line assistance
21742175
- **No Copilot Cloud:** Cannot run cloud-based agentic workflows

‎docs/appendix-l-agents-reference.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@
44
55
> **Reference companion to:** [Chapter 19: Accessibility Agents](19-accessibility-agents.md) | Also relevant: [Chapter 20](20-build-your-agent.md)
66
>
7-
> **Authoritative source:** [GitHub Docs: Building Copilot extensions](https://docs.github.com/en/copilot/building-copilot-extensions/about-building-copilot-extensions)
7+
> **Authoritative source:** [GitHub Docs: MCP overview](https://docs.github.com/en/copilot/building-copilot-extensions/about-building-copilot-extensions) | [VS Code: Custom Agents](https://code.visualstudio.com/docs/copilot/customization/custom-agents)
8+
>
9+
> **Note:** The "Building Copilot Extensions" docs now redirect to MCP documentation. The GitHub App-based Copilot Extensions model has been superseded by MCP servers as the standard extensibility mechanism. Custom `.agent.md` files remain the primary agent persona format.
810
911
## Complete Reference - Agents, Slash Commands, Instructions, Configuration Levels, and All File Formats
1012

0 commit comments

Comments
 (0)