Skip to content

Commit 7e161cb

Browse files
fix: update tutorial lessons with Copilot CLI v1.0.40-v1.0.43 changes
Agent-Logs-Url: https://github.com/instil/github-copilot-tutorial/sessions/a7e38ee4-b042-45f3-b120-a688c0609276 Co-authored-by: calebwilson706 <71669491+calebwilson706@users.noreply.github.com>
1 parent 27198d7 commit 7e161cb

5 files changed

Lines changed: 51 additions & 12 deletions

File tree

tutorial/lessons/08-planning-mode.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,12 @@ There are two ways:
3636

3737
Look at the bottom of your terminal to see which mode you're in. Just keep pressing Shift+Tab until you see the plan mode indicator.
3838

39+
> **Note on Autopilot Mode:** When using Autopilot Mode, Copilot limits itself to 5 continuation messages by default to prevent unbounded autonomous execution. You can adjust this limit with the `--max-autopilot-continues` flag when launching Copilot:
40+
> ```
41+
> copilot --max-autopilot-continues 10
42+
> ```
43+
> This safety default means Autopilot Mode will pause and wait for your input after 5 steps in a longer task.
44+
3945
**`/plan` command** — You can also type `/plan` followed by your prompt:
4046
4147
```

tutorial/lessons/14-session-management.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,18 @@ Each session has a unique ID. You can resume a specific session by ID:
2929

3030
---
3131

32+
### Session history with `/chronicle`
33+
34+
**`/chronicle`** — Review a structured history of your session, including which files were read or edited and when:
35+
36+
```
37+
/chronicle
38+
```
39+
40+
This shows a timeline of file interactions during your session — useful for understanding what Copilot accessed and in what order. It's especially helpful when you want to audit a long session or hand off context to a colleague.
41+
42+
---
43+
3244
### Context compression
3345

3446
As conversations grow, the context window fills up. Copilot handles this automatically — at 95% token capacity, it auto-compacts the conversation to make room. But you can also manage it manually:
@@ -115,20 +127,22 @@ Sometimes it's better to start over than to correct course:
115127

116128
1. Try `/context` to see your token usage visualisation
117129
2. Try `/usage` to see your session statistics
118-
3. Think about when you'd use `--continue` vs `/resume`:
130+
3. Try `/chronicle` to see a timeline of files accessed in this session
131+
4. Think about when you'd use `--continue` vs `/resume`:
119132
- `--continue`: "I closed my terminal but want to pick up exactly where I left off"
120133
- `/resume`: "I have several ongoing sessions and want to choose which one to revisit"
121-
4. If your context feels long, try `/compact "Focus on the current lesson"`
134+
5. If your context feels long, try `/compact "Focus on the current lesson"`
122135

123136
---
124137

125138
## Hints
126139

127140
1. `/context` shows a visual breakdown — it's the quickest way to understand your token budget
128141
2. `/usage` gives you raw session stats
129-
3. `/compact` is your friend for long sessions — it summarises without losing the thread
130-
4. `/restart` reloads the CLI without clearing your conversation — useful when the CLI feels buggy or after changing config
131-
5. This is about building habits: use `/clear` between tasks, `/compact` when sessions get long, `/restart` when the CLI misbehaves, and `/resume` to pick up where you left off
142+
3. `/chronicle` shows a timeline of files accessed in this session — useful for auditing what Copilot read or wrote
143+
4. `/compact` is your friend for long sessions — it summarises without losing the thread
144+
5. `/restart` reloads the CLI without clearing your conversation — useful when the CLI feels buggy or after changing config
145+
6. This is about building habits: use `/clear` between tasks, `/compact` when sessions get long, `/restart` when the CLI misbehaves, and `/resume` to pick up where you left off
132146

133147
---
134148

tutorial/lessons/15-programmatic-mode.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,20 @@ cat error.log | copilot -p "explain this error and suggest a fix" > summary.txt
2828
git diff main | copilot -p "review these changes for bugs"
2929
```
3030

31+
### Attaching files and images
32+
33+
In non-interactive mode, use `--attachment` to pass images or documents alongside your prompt:
34+
35+
```bash
36+
copilot -p "describe the UI shown in this screenshot" --attachment screenshot.png
37+
```
38+
39+
```bash
40+
copilot -p "review the architecture described in this diagram" --attachment architecture.pdf
41+
```
42+
43+
This enables CI/automation workflows that include visual content — for example, screenshot regression checks or automated design review pipelines. You can include multiple `--attachment` flags in a single command.
44+
3145
### Scoping permissions
3246

3347
When running in automation, lock down what Copilot can do:

tutorial/lessons/16-model-selection.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,11 @@ Copilot CLI supports multiple AI models, each with different strengths:
1212

1313
| Model | Best for |
1414
|-------|----------|
15-
| **Claude Sonnet 4.6** (default) | Daily coding tasks, good balance of speed and quality |
16-
| **Claude Opus 4.6** | Complex reasoning, architectural work, thorough analysis |
17-
| **GPT-5** | Code generation, broad knowledge |
15+
| **Claude Opus 4.5** (default) | Complex reasoning, architectural work, thorough analysis |
16+
| **Claude Sonnet 4.5** | Daily coding tasks, good balance of speed and quality |
17+
| **GPT-5.2 Codex** | Code generation, broad knowledge |
18+
19+
In addition to specific models, Copilot CLI offers an **Auto** mode that uses server-side model routing to automatically select the best model for each request in real time. This can give you better results without you having to manually switch models.
1820

1921
### Switching models
2022

@@ -75,9 +77,10 @@ This creates a `.github/copilot-instructions.md` file with sensible defaults bas
7577
1. Try `/model` to see what models are available and how to switch between them
7678
2. Try `/theme` to see available visual themes
7779
3. Think about when you'd switch models:
78-
- Working on a quick bug fix? Stay on Sonnet 4.6
79-
- Designing a complex architecture? Switch to Opus 4.6
80-
- Want a different perspective on an approach? Try GPT-5.3 Codex
80+
- Working on a quick bug fix? Stay on Sonnet 4.5
81+
- Designing a complex architecture? Switch to Opus 4.5
82+
- Want a different perspective on an approach? Try GPT-5.2 Codex
83+
- Not sure which model to use? Try **Auto** mode and let Copilot decide
8184

8285
## Hints
8386

tutorial/lessons/18-working-with-images.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ How to use images with Copilot CLI — debugging from screenshots, implementing
1313
| **Drag and drop** | Drag an image file into the terminal | Quick one-off references |
1414
| **Paste** | `Ctrl+V` (or `Cmd+V` on Mac) | Screenshots you just captured |
1515
| **File path** | Reference the image path with `@` in your prompt | Images already in your project |
16+
| **`--attachment` flag** | `copilot -p "..." --attachment image.png` | CI/automation and non-interactive mode |
1617

1718
### Common use cases
1819

@@ -48,7 +49,8 @@ Option C — Just read:
4849

4950
1. The easiest approach: take a screenshot of this terminal right now (`Cmd+Shift+4` on Mac, `Win+Shift+S` on Windows), then paste it into Copilot and ask "what do you see?"
5051
2. Copilot can read most common image formats: PNG, JPG, GIF, WebP
51-
3. This is about knowing the capability exists — you'll use it naturally when you encounter a visual debugging situation
52+
3. For CI/automation scripts, use `--attachment` with the `-p` flag: `copilot -p "describe this" --attachment image.png`
53+
4. This is about knowing the capability exists — you'll use it naturally when you encounter a visual debugging situation
5254

5355
## Completion Criteria
5456

0 commit comments

Comments
 (0)