Skip to content

Commit 9c985c5

Browse files
calebwilson706Copilot
calebwilson706
and
Copilot
committed
feat: add Lesson 24 (Remote Control) for CLI remote access
Add new Lesson 24 covering the remote control feature introduced in v1.0.25-1.0.32. This teaches users how to monitor and control CLI sessions from GitHub.com or GitHub Mobile. Changes: - Added tutorial/lessons/24-remote-control.md as optional capstone lesson - Positioned after Lesson 23 (Graduation) before specialist tracks - Covers /remote enable, --remote flag, and --connect flag - Exercise: finish tutorial from mobile/browser (optional) - Shifted QA track from lessons 24-28 to 25-29 - Shifted Design track from lessons 29-34 to 30-35 Decision: - Made this a standalone lesson (not a section in Session Management) as it represents a distinct workflow and deserves full coverage - Positioned as last core lesson to let users optionally finish on mobile - Kept content focused on practical use cases (long-running tasks, mobile check-ins, cross-device workflows) - No slide deck updates needed (tutorial-only feature) Closes #66 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent c2218bb commit 9c985c5

12 files changed

Lines changed: 99 additions & 11 deletions

‎tutorial/lessons/24-remote-control.md‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
# Lesson 24: Remote Control
2+
3+
## What You'll Learn
4+
5+
How to monitor and control a running Copilot CLI session from GitHub.com or GitHub Mobile. Perfect for long-running tasks, checking progress away from your desk, or finishing the tutorial on your phone.
6+
7+
## Concepts
8+
9+
---
10+
11+
### What is remote control?
12+
13+
Remote control lets you access a running CLI session from anywhere — GitHub.com in your browser, or the GitHub Mobile app on your phone. You can:
14+
15+
- Monitor the session in real-time as Copilot works
16+
- Respond to permission requests remotely
17+
- Provide input or answer questions
18+
- Review changes and approve tool calls
19+
20+
This is valuable when you kick off a complex task and need to step away. Instead of waiting at your desk, you can check in from anywhere and keep the work moving.
21+
22+
---
23+
24+
### Starting a remote session
25+
26+
**From an interactive session**, enable remote control with:
27+
28+
```
29+
/remote enable
30+
```
31+
32+
This generates a link to view the session on GitHub.com. The link appears in your terminal — click it or copy it to your browser or GitHub Mobile app.
33+
34+
**When starting a new session**, use the `--remote` flag:
35+
36+
```
37+
copilot --remote
38+
```
39+
40+
The CLI displays the remote access link immediately. Open it on any device.
41+
42+
### Viewing from GitHub.com or Mobile
43+
44+
Once you open the remote link:
45+
46+
- **On GitHub.com**: You see the conversation in real-time. Copilot's responses appear as they're generated. Permission requests show up as interactive prompts you can approve or deny.
47+
48+
- **On GitHub Mobile**: The mobile app provides the same interface, optimized for touch. You can read, respond, and approve from your phone.
49+
50+
The remote view is **live** — it updates as the session progresses. If Copilot asks a question or requests permission, you'll see it immediately.
51+
52+
---
53+
54+
### Use cases
55+
56+
Remote control shines in these scenarios:
57+
58+
- **Long-running tasks**: Start a large refactoring or test generation task, enable remote control, and step away. Check in periodically from your phone.
59+
- **Collaborative debugging**: Share the remote link with a teammate so they can follow along or provide input.
60+
- **Mobile check-ins**: Quickly approve a permission request or answer a question from GitHub Mobile while you're away from your desk.
61+
- **Cross-device workflows**: Start a session on your workstation, continue it on your laptop, finish it on your phone.
62+
63+
---
64+
65+
## Exercise
66+
67+
**Finish this tutorial from GitHub.com or GitHub Mobile.**
68+
69+
This is an optional capstone experience — you can complete this lesson from your terminal as usual, or try the remote control feature and finish the tutorial from a different device.
70+
71+
**If you want to try remote control:**
72+
73+
1. Enable remote control for this session:
74+
```
75+
/remote enable
76+
```
77+
78+
2. Open github another device:
79+
- **GitHub.com in a browser**
80+
- **GitHub Mobile app** on your phone
81+
82+
3. Navigate to the agents tab and find your remote session.
83+
84+
4. Prompt to finish the tutorial from there
85+
86+
**If you prefer to stay in the terminal:**
87+
88+
That's completely fine — remote control is an optional advanced feature. Just say **"next"** when you're ready to continue.

tutorial/lessons/24-test-planning.md renamed to tutorial/lessons/25-test-planning.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 24: Test Planning from Requirements
1+
# Lesson 25: Test Planning from Requirements
22

33
## What You'll Learn
44

tutorial/lessons/25-test-case-design.md renamed to tutorial/lessons/26-test-case-design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 25: Test Case Design & Coverage
1+
# Lesson 26: Test Case Design & Coverage
22

33
## What You'll Learn
44

tutorial/lessons/26-automated-test-generation.md renamed to tutorial/lessons/27-automated-test-generation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 26: Automated Test Generation
1+
# Lesson 27: Automated Test Generation
22

33
## What You'll Learn
44

tutorial/lessons/27-e2e-testing-playwright.md renamed to tutorial/lessons/28-e2e-testing-playwright.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 27: E2E Testing with Playwright
1+
# Lesson 28: E2E Testing with Playwright
22

33
## What You'll Learn
44

tutorial/lessons/28-qa-track-graduation.md renamed to tutorial/lessons/29-qa-track-graduation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 28: QA Track Graduation
1+
# Lesson 29: QA Track Graduation
22

33
## You Did It
44

tutorial/lessons/29-translating-mockups.md renamed to tutorial/lessons/30-translating-mockups.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 29: Translating Mockups to Specs
1+
# Lesson 30: Translating Mockups to Specs
22

33
## What You'll Learn
44

tutorial/lessons/30-accessibility-review.md renamed to tutorial/lessons/31-accessibility-review.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 30: Accessibility & Design Review
1+
# Lesson 31: Accessibility & Design Review
22

33
## What You'll Learn
44

tutorial/lessons/31-design-system-instructions.md renamed to tutorial/lessons/32-design-system-instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 31: Design System Instructions
1+
# Lesson 32: Design System Instructions
22

33
## What You'll Learn
44

tutorial/lessons/32-designer-developer-handoff.md renamed to tutorial/lessons/33-designer-developer-handoff.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Lesson 32: Designer ↔ Developer Handoff
1+
# Lesson 33: Designer ↔ Developer Handoff
22

33
## What You'll Learn
44

0 commit comments

Comments
 (0)