From 0ddfebd4396673b0aa340d93d782db60e6421140 Mon Sep 17 00:00:00 2001 From: Dan Wahlin Date: Mon, 4 May 2026 05:16:48 -0700 Subject: [PATCH 1/2] docs: update course content with Copilot CLI v1.0.37-v1.0.40 features - Add shell tab completion tip (copilot completion bash|zsh|fish) to Ch00 - Update Ch00 trust/permission wording: approvals now persist automatically by default - Add /chronicle command to Ch01 Session commands reference table Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- 00-quick-start/README.md | 17 ++++++++++++++++- 01-setup-and-first-steps/README.md | 1 + 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/00-quick-start/README.md b/00-quick-start/README.md index a0e1da61..a080bd1e 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -87,6 +87,21 @@ Follow these steps if you'd like to run Copilot CLI on your local machine with t curl -fsSL https://gh.io/copilot-install | bash ``` +> 💡 **Tip: Enable shell tab completion** — Once installed, you can set up tab completion so pressing **Tab** in your terminal auto-completes `copilot` commands and flags. Run the command for your shell: +> +> ```bash +> # Bash +> copilot completion bash >> ~/.bashrc && source ~/.bashrc +> +> # Zsh +> copilot completion zsh >> ~/.zshrc && source ~/.zshrc +> +> # Fish +> copilot completion fish > ~/.config/fish/completions/copilot.fish +> ``` +> +> After running this once, you can type `copilot ` and press **Tab** to see available subcommands, or start typing a flag like `--` and press **Tab** to auto-complete it. Entirely optional, but handy for beginners exploring the CLI. + --- ## Authentication @@ -97,7 +112,7 @@ Open a terminal window at the root of the `copilot-cli-for-beginners` repository copilot ``` -You'll be asked to trust the folder containing the repository (if you haven't already). You can trust it one time or across all future sessions. +You'll be asked to trust the folder containing the repository (if you haven't already). Once you approve it, that approval is automatically saved — you won't need to re-approve the same folder in future sessions. Trusting files in a folder with the Copilot CLI diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index b64046ef..61d8704b 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -435,6 +435,7 @@ That's it for getting started! As you become comfortable, you can explore additi | Command | What It Does | |---------|--------------| +| `/chronicle` | Browse your session history — view past sessions, which files you worked on, and what changed | | `/clear` | Abandons the current session (no history saved) and starts a fresh conversation | | `/compact` | Summarize conversation to reduce context usage | | `/context` | Show context window token usage and visualization | From af9965758d61a3221cb5486b2b5d3dd61d069e82 Mon Sep 17 00:00:00 2001 From: Dan Wahlin Date: Mon, 4 May 2026 11:22:09 -0700 Subject: [PATCH 2/2] Refine Copilot CLI course updates Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- 00-quick-start/README.md | 40 +++++++++++++++++++----------- 01-setup-and-first-steps/README.md | 1 - 2 files changed, 25 insertions(+), 16 deletions(-) diff --git a/00-quick-start/README.md b/00-quick-start/README.md index a080bd1e..dcc0f1c8 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -87,20 +87,30 @@ Follow these steps if you'd like to run Copilot CLI on your local machine with t curl -fsSL https://gh.io/copilot-install | bash ``` -> 💡 **Tip: Enable shell tab completion** — Once installed, you can set up tab completion so pressing **Tab** in your terminal auto-completes `copilot` commands and flags. Run the command for your shell: -> -> ```bash -> # Bash -> copilot completion bash >> ~/.bashrc && source ~/.bashrc -> -> # Zsh -> copilot completion zsh >> ~/.zshrc && source ~/.zshrc -> -> # Fish -> copilot completion fish > ~/.config/fish/completions/copilot.fish -> ``` -> -> After running this once, you can type `copilot ` and press **Tab** to see available subcommands, or start typing a flag like `--` and press **Tab** to auto-complete it. Entirely optional, but handy for beginners exploring the CLI. +
+Optional: Enable shell tab completion + +Shell tab completion lets you press **Tab** to complete `copilot` subcommands, command options, and some option values. This is optional, but it can be handy once you're comfortable using the CLI. + +Copilot CLI currently supports completion scripts for Bash, Zsh, and Fish: + +```shell +# Bash, current session only +source <(copilot completion bash) + +# Bash, persistent on Linux +copilot completion bash | sudo tee /etc/bash_completion.d/copilot + +# Zsh +copilot completion zsh > "${fpath[1]}/_copilot" + +# Fish +copilot completion fish > ~/.config/fish/completions/copilot.fish +``` + +Restart your shell after adding persistent completion. PowerShell is supported for running Copilot CLI on Windows, but `copilot completion` currently supports only Bash, Zsh, and Fish. + +
--- @@ -112,7 +122,7 @@ Open a terminal window at the root of the `copilot-cli-for-beginners` repository copilot ``` -You'll be asked to trust the folder containing the repository (if you haven't already). Once you approve it, that approval is automatically saved — you won't need to re-approve the same folder in future sessions. +You'll be asked to trust the folder containing the repository (if you haven't already). You can trust it one time or across all future sessions. Trusting files in a folder with the Copilot CLI diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index 61d8704b..b64046ef 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -435,7 +435,6 @@ That's it for getting started! As you become comfortable, you can explore additi | Command | What It Does | |---------|--------------| -| `/chronicle` | Browse your session history — view past sessions, which files you worked on, and what changed | | `/clear` | Abandons the current session (no history saved) and starts a fresh conversation | | `/compact` | Summarize conversation to reduce context usage | | `/context` | Show context window token usage and visualization |