From cf49a04048b7a17a63d7298ec48411a286cbb232 Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 6 Apr 2026 09:39:34 -0400 Subject: [PATCH 1/6] update readme with explaination of intended use of this branch. content edits to follow --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index ffd5ed26..0d1e699e 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,9 @@ 🎯 [What You'll Learn](#what-youll-learn)   ✅ [Prerequisites](#prerequisites)   🤖 [Copilot Family](#understanding-the-github-copilot-family)   📚 [Course Structure](#course-structure)   📋 [Command Reference](#-github-copilot-cli-command-reference) +# About this branch +The `urban-version-for-traning` branch is modified from `main` for Urban-recommended set up steps as of April 2026. + # GitHub Copilot CLI for Beginners > **✨ Learn to supercharge your development workflow with AI-powered command-line assistance.** From d493c3024905d884b556706b0965e6c9c3754f2e Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 6 Apr 2026 13:45:40 -0400 Subject: [PATCH 2/6] update quick start for Urban preferences and workflow --- 00-quick-start/README.md | 39 +++++---------------------------------- 1 file changed, 5 insertions(+), 34 deletions(-) diff --git a/00-quick-start/README.md b/00-quick-start/README.md index a0e1da61..3e48d018 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -21,14 +21,11 @@ By the end of this chapter, you'll have: ### What "Copilot Access" Means -GitHub Copilot CLI requires an active Copilot subscription. You can check your status at [github.com/settings/copilot](https://github.com/settings/copilot). You should see one of: +GitHub Copilot CLI requires an active Copilot subscription. You can check your status at [github.com/settings/copilot](https://github.com/settings/copilot). You should see: -- **Copilot Individual** - Personal subscription -- **Copilot Business** - Through your organization -- **Copilot Enterprise** - Through your enterprise -- **GitHub Education** - Free for verified students/teachers +- **Copilot Business** - Through your membership via the UI-Research organization -If you see "You don't have access to GitHub Copilot," you'll need to use the free option, subscribe to a plan, or join an organization that provides access. +If you see "You don't have access to GitHub Copilot," you'll need to use the free option, or request to join the group with access to Copilot via UI-Research. Email jkelly@urban.org for more information about use at Urban. --- @@ -36,20 +33,9 @@ If you see "You don't have access to GitHub Copilot," you'll need to use the fre > ⏱️ **Time estimate**: Installation takes 2-5 minutes. Authentication adds another 1-2 minutes. -### GitHub Codespaces (Zero Setup) - -If you don't want to install any of the prerequisites you can use GitHub Codespaces, which has the GitHub Copilot CLI ready to go (you'll need to sign in), and pre-installs Python and pytest. - -1. [Fork this repository](https://github.com/github/copilot-cli-for-beginners/fork) to your GitHub account -2. Select **Code** > **Codespaces** > **Create codespace on main** -3. Wait a few minutes for the container to build -4. You're ready to go! The terminal will open automatically in the Codespace environment. - -> 💡 **Verify in Codespace**: Run `cd samples/book-app-project && python book_app.py help` to confirm Python and the sample app are working. - ### Local Installation -Follow these steps if you'd like to run Copilot CLI on your local machine with the course samples. +Follow these steps to run Copilot CLI on your local machine with the course samples. 1. Clone the repo to get the course samples on your machine: @@ -60,14 +46,7 @@ Follow these steps if you'd like to run Copilot CLI on your local machine with t 2. Install Copilot CLI using one of the following options. - > 💡 **Not sure which to pick?** Use `npm` if you have Node.js installed. Otherwise, choose the option that matches your system. - - ### All Platforms (npm) - - ```bash - # If you have Node.js installed, this is a quick way to get the CLI - npm install -g @github/copilot - ``` + > If you have Windows, you will need to contact helpdesk to schedule installation. ### macOS/Linux (Homebrew) @@ -81,14 +60,6 @@ Follow these steps if you'd like to run Copilot CLI on your local machine with t winget install GitHub.Copilot ``` - ### macOS/Linux (Install Script) - - ```bash - curl -fsSL https://gh.io/copilot-install | bash - ``` - ---- - ## Authentication Open a terminal window at the root of the `copilot-cli-for-beginners` repository, start the CLI and allow access to the folder. From cc3b81d10c4142cc77dec3b7b5b6bf1cdbd59e39 Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 6 Apr 2026 13:52:00 -0400 Subject: [PATCH 3/6] update references to repository to this version --- 00-quick-start/README.md | 2 +- 01-setup-and-first-steps/README.md | 2 +- 04-agents-custom-instructions/README.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/00-quick-start/README.md b/00-quick-start/README.md index 3e48d018..ea4e0002 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -40,7 +40,7 @@ Follow these steps to run Copilot CLI on your local machine with the course samp 1. Clone the repo to get the course samples on your machine: ```bash - git clone https://github.com/github/copilot-cli-for-beginners + git clone https://github.com/UI-Research/copilot-cli-for-beginners cd copilot-cli-for-beginners ``` diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index ac39eddd..4383ebc7 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -66,7 +66,7 @@ The course includes sample files with intentional code quality issues. If you're ```bash # Clone the course repository if you're working locally and haven't already -git clone https://github.com/github/copilot-cli-for-beginners +git clone https://github.com/UI-Research/copilot-cli-for-beginners cd copilot-cli-for-beginners # Start Copilot diff --git a/04-agents-custom-instructions/README.md b/04-agents-custom-instructions/README.md index a84d8894..ceb9da75 100644 --- a/04-agents-custom-instructions/README.md +++ b/04-agents-custom-instructions/README.md @@ -677,7 +677,7 @@ You are a technical writer who creates clear Python documentation. **Testing your agents:** > 💡 **Note:** You should already have `samples/book-app-project/data.json` in your local copy of this repo. If it is missing, download the original version from the source repo: -> [data.json](https://github.com/github/copilot-cli-for-beginners/blob/main/samples/book-app-project/data.json) +> [data.json](https://github.com/UI-Research/copilot-cli-for-beginners/blob/main/samples/book-app-project/data.json) ```bash copilot From 60194cedb9530867865d82e9e068518b3ee5a069 Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 6 Apr 2026 14:50:51 -0400 Subject: [PATCH 4/6] add note on security and not using copilot at a root directory --- 01-setup-and-first-steps/README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index 4383ebc7..66e5acdf 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -10,6 +10,7 @@ This chapter is where the magic starts! You'll experience firsthand why develope By the end of this chapter, you'll be able to: +- Know some basic rules of the road for securely using GitHub Copilot CLI at Urban. - Experience the productivity boost GitHub Copilot CLI provides through hands-on demos - Choose the right mode (Interactive, Plan, or Programmatic) for any task - Use slash commands to control your sessions @@ -28,7 +29,9 @@ Jump right in and see what Copilot CLI can do. ## Getting Comfortable: Your First Prompts -Before diving into the impressive demos, let's start with some simple prompts you can try right now. **No code repository needed**! Just open a terminal and start Copilot CLI: +> ⚠️ **Important note on security**: When you run the CLI tool, Copilot will have access to files _at and below_ the directory level you are in. **NEVER run the CLI from your top-level directory** (i.e. `C:\`, `D:\` or `Home`). And you should also **NEVER run the CLI from a directory that contains sensitive or confidential information** as you might then expose those files to risk. + +Before diving into the impressive demos, let's start with some simple prompts you can try right now. **No code repository needed**! Just open a terminal from an appropriate folder not at the root level, and start Copilot CLI: ```bash copilot From 021b2490c4ad5e3650cdddd5abb0ceaa0a0db8c4 Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 6 Apr 2026 19:41:27 -0400 Subject: [PATCH 5/6] add note on context and security --- 02-context-conversations/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/02-context-conversations/README.md b/02-context-conversations/README.md index 81bfe7a9..f4202c02 100644 --- a/02-context-conversations/README.md +++ b/02-context-conversations/README.md @@ -50,7 +50,7 @@ The `@` symbol references files and directories in your prompts. It's how you te ### Try It Now (No Setup Required) -You can try this with any file on your computer: +You can try this with any file on your computer from an appropriate folder not at the root level, that does not contain confidential data: ```bash copilot From 83d4ade39c8d4aee738537d738045a16d294c221 Mon Sep 17 00:00:00 2001 From: Jessica Kelly Date: Mon, 11 May 2026 09:12:14 -0400 Subject: [PATCH 6/6] update with additional details on windows install --- 00-quick-start/README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/00-quick-start/README.md b/00-quick-start/README.md index ea4e0002..d5c84b67 100644 --- a/00-quick-start/README.md +++ b/00-quick-start/README.md @@ -55,10 +55,10 @@ Follow these steps to run Copilot CLI on your local machine with the course samp ``` ### Windows (WinGet) - - ```bash - winget install GitHub.Copilot - ``` + + - contact helpdesk to schedule install. + - frequently requires a Powershell update first. + ## Authentication @@ -68,6 +68,8 @@ Open a terminal window at the root of the `copilot-cli-for-beginners` repository copilot ``` +> Windows users may need to run `gh copilot` at the command line. + 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