Skip to content

docs: expand --resume session guidance in Chapter 02#15

Merged
DanWahlin merged 1 commit intomainfrom
docs/expand-resume-session-guidance
Mar 10, 2026
Merged

docs: expand --resume session guidance in Chapter 02#15
DanWahlin merged 1 commit intomainfrom
docs/expand-resume-session-guidance

Conversation

@DanWahlin
Copy link
Collaborator

Summary

Expands the --resume / --continue session management section in Chapter 02 based on reader feedback asking for more clarity on:

  • How to find session IDs — explains that copilot --resume shows an interactive list (no memorization needed)
  • Multiple terminals — clarifies that each terminal is its own session, and --resume browses all saved sessions across terminals
  • Switching mid-session — documents the /resume slash command for switching without restarting

Also removes the now-redundant "Switch Sessions While Working" subsection from the optional deeper section to avoid duplication.

Feedback addressed

"Might be helpful to explain how the resume of a copilot session works when you have multiple terminals and copilot sessions. And when you mention resuming by id, might be helpful to say how they know that id."

Add detailed tips explaining how to find session IDs, how sessions
work across multiple terminals, and how to switch sessions from
inside an active session using /resume.

Remove redundant 'Switch Sessions While Working' section that is
now covered by the expanded tip.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 10, 2026 19:43
@DanWahlin DanWahlin merged commit 30432a0 into main Mar 10, 2026
3 checks passed
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves Chapter 02’s documentation for Copilot CLI session management by clarifying how --resume/--continue behave in real workflows (session IDs, multiple terminals, and switching sessions mid-session), and removes redundant content in the optional section.

Changes:

  • Adds an FAQ-style callout explaining how to discover session IDs via the interactive copilot --resume picker.
  • Documents multi-terminal behavior and introduces /resume for switching sessions without restarting.
  • Removes the duplicated “Switch Sessions While Working” subsection from the optional/deeper section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

> **What about multiple terminals?** Each terminal window is its own session with its own context. If you have Copilot CLI open in three terminals, that's three separate sessions. Running `--resume` from any terminal lets you browse all of them. The `--continue` flag grabs whichever session was closed most recently, no matter which terminal it was in.
>
> **Can I switch sessions without restarting?** Yes. Use the `/resume` slash command from inside an active session:
> ```
Copy link

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The fenced code block inside this callout doesn’t specify a language (elsewhere in this README, blockquoted examples use bash for consistency and syntax highlighting). Consider changing this fence to bash to match the other CLI examples.

Suggested change
> ```
> ```bash

Copilot uses AI. Check for mistakes.
@DanWahlin DanWahlin deleted the docs/expand-resume-session-guidance branch March 10, 2026 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants