Skip to content

Commit 8256e31

Browse files
DanWahlinCopilot
andauthored
docs: add auto model, document attachment, and new command aliases
- Add 'auto' model option tip to the Switching Models section in Ch01: users can select 'auto' from /model to let Copilot choose the best model automatically (v1.0.32) - Update Session command table in Ch01 with /reset alias for /clear, /continue alias for /resume, and /export alias for /share (v1.0.33) - Update Help and Feedback table in Ch01 with /release-notes alias for /changelog and /bug alias for /feedback (v1.0.33) - Add Attaching Document Files section to Ch02 with examples and a tip showing how to use @ to attach PDFs and other supported documents to prompts for Copilot to read and reason about (v1.0.32) - Update Ch02 key takeaways to mention document file support - Add document files entry to the Ch02 optional topics navigation table Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 31099db commit 8256e31

2 files changed

Lines changed: 26 additions & 6 deletions

File tree

01-setup-and-first-steps/README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -433,16 +433,16 @@ That's it for getting started! As you become comfortable, you can explore additi
433433

434434
| Command | What It Does |
435435
|---------|--------------|
436-
| `/clear` | Abandons the current session (no history saved) and starts a fresh conversation |
436+
| `/clear` (or `/reset`) | Abandons the current session (no history saved) and starts a fresh conversation |
437437
| `/compact` | Summarize conversation to reduce context usage |
438438
| `/context` | Show context window token usage and visualization |
439439
| `/new` | Ends the current session (saving it to history for search/resume) and starts a fresh conversation. |
440-
| `/resume` | Switch to a different session (optionally specify session ID) |
440+
| `/resume` (or `/continue`) | Switch to a different session (optionally specify session ID) |
441441
| `/rename` | Rename the current session (omit the name to auto-generate one) |
442442
| `/rewind` | Open a timeline picker to roll back to any earlier point in the conversation |
443443
| `/usage` | Display session usage metrics and statistics |
444444
| `/session` | Show session info and workspace summary |
445-
| `/share` | Export session as a markdown file, GitHub gist, or self-contained HTML file |
445+
| `/share` (or `/export`) | Export session as a markdown file, GitHub gist, or self-contained HTML file |
446446

447447
### Display
448448

@@ -455,8 +455,8 @@ That's it for getting started! As you become comfortable, you can explore additi
455455

456456
| Command | What It Does |
457457
|---------|--------------|
458-
| `/changelog` | Display changelog for CLI versions |
459-
| `/feedback` | Submit feedback to GitHub |
458+
| `/changelog` (or `/release-notes`) | Display changelog for CLI versions |
459+
| `/feedback` (or `/bug`) | Submit feedback or report a bug to GitHub |
460460
| `/help` | Show all available commands |
461461

462462
### Quick Shell Commands
@@ -486,6 +486,8 @@ copilot
486486

487487
> 💡 **Tip**: Some models cost more "premium requests" than others. Models marked **1x** (like Claude Sonnet 4.5) are a great default. They're capable and efficient. Higher-multiplier models use your premium request quota faster, so save those for when you really need them.
488488
489+
> 💡 **New: `auto` model**: You can select `auto` from the `/model` picker to let Copilot automatically choose the best available model for each session. This is a great starting option if you're unsure which model to pick — Copilot will adapt based on what's available to you.
490+
489491
</details>
490492

491493
---

02-context-conversations/README.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -427,6 +427,7 @@ These topics build on the essentials above. **Pick what interests you, or skip a
427427
| Token limits and `/compact` | [Understanding Context Windows](#understanding-context-windows) |
428428
| How to pick the right files to reference | [Choosing What to Reference](#choosing-what-to-reference) |
429429
| Analyzing screenshots and mockups | [Working with Images](#working-with-images) |
430+
| Attaching PDFs and other documents | [Attaching Document Files](#attaching-document-files) |
430431
431432
<details>
432433
<summary><strong>Additional @ Patterns & Session Commands</strong></summary>
@@ -687,6 +688,22 @@ copilot
687688
688689
> 📖 **Learn more**: See [Additional Context Features](../appendices/additional-context.md#working-with-images) for supported formats, practical use cases, and tips for combining images with code.
689690
691+
<a id="attaching-document-files"></a>
692+
693+
### Attaching Document Files
694+
695+
You can also attach supported document files (such as PDFs) to your prompts using the same `@` syntax. This is handy for providing specs, design documents, or reference material that Copilot can read and reason about alongside your code.
696+
697+
```bash
698+
copilot
699+
700+
> @requirements.pdf Summarize the key requirements and check if @samples/book-app-project/book_app.py covers them
701+
702+
> @design-doc.pdf What features are described here that are missing from @samples/book-app-project/
703+
```
704+
705+
> 💡 **Tip**: Document attachment works great for onboarding — paste a spec or design doc and ask Copilot to map it to your existing code.
706+
690707
</details>
691708
692709
---
@@ -856,12 +873,13 @@ copilot --add-dir /path/to/directory
856873
857874
## 🔑 Key Takeaways
858875
859-
1. **`@` syntax** gives Copilot CLI context about files, directories, and images
876+
1. **`@` syntax** gives Copilot CLI context about files, directories, images, and documents
860877
2. **Multi-turn conversations** build on each other as context accumulates
861878
3. **Sessions auto-save**: use `--continue` or `--resume` to pick up where you left off
862879
4. **Context windows** have limits: manage them with `/clear`, `/compact`, `/context`, `/new`, and `/rewind`
863880
5. **Permission flags** (`--add-dir`, `--allow-all`) control multi-directory access. Use them wisely!
864881
6. **Image references** (`@screenshot.png`) help debug UI issues visually
882+
7. **Document files** (like PDFs) can be attached with `@` to give Copilot specs, designs, or reference material
865883
866884
> 📚 **Official Documentation**: [Use Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli/use-copilot-cli) for the complete reference on context, sessions, and working with files.
867885

0 commit comments

Comments
 (0)