docs: refresh workshop content for current Copilot CLI behavior - #11
Open
jsburckhardt wants to merge 1 commit into
Open
docs: refresh workshop content for current Copilot CLI behavior#11jsburckhardt wants to merge 1 commit into
jsburckhardt wants to merge 1 commit into
Conversation
Refresh all 13 workshop modules and slide decks against the currently installed CLI, correcting inaccurate claims, closing coverage gaps, and fixing exercise commands that failed or misbehaved when executed. Accuracy corrections: - sandbox.gitAuth/ghAuth -> sandbox.auth.git/auth.gh (key was silently ignored) - --share/--share-gist documented as non-interactive-only; /share for live sessions - split --resume (session picker) from --continue (most recent session) - shell(git) -> shell(git:*); bare form never matched git subcommands - --available-tools/--excluded-tools take tool names, not permission rule kinds - /usage reports AI credits rather than premium requests - /plugins -> /plugin; --scope gains session and working-directory - add third built-in skill discover-resources - clarify that copilot mcp list omits built-in servers; /mcp shows them - note assisted mode requires experimental auto-approval - note /sandbox also registers under a managed policy - clarify inline hook locations (global config.json vs repo settings.json) - correct eight off-by-one module prerequisite references Coverage added: - flags: --sandbox, --assisted-approval, --usage-output-file, --enable-mcp-server, --extension-sdk-path, --no-eager-powershell-resolution, --remote, --remote-export - settings: bannerStyle, defaultMode, defaultPermissionMode - env vars: COPILOT_ASSISTED_APPROVAL, COPILOT_MULTIPLEXER, COPILOT_INLINE_IMAGES_HERDR - commands: copilot app, copilot init, /exit print, /model sub-options - add jq and gh to prerequisites Exercise fixes found by executing every module in the workshop container: - move a TIP callout out of a heredoc that corrupted a generated file - split blocking sessions and in-session ! lines out of bash fences - fix test-and-commit function syntax that ran npm test via BASH_ENV - start a session before listing COPILOT_HOME, which --version never creates - pair --sandbox with --experimental so the flag is not ignored - use github-mcp-server as the built-in MCP server name Also refresh eleven redirecting documentation URLs, sync all slide decks, and update the validated CLI version in the instructions, README badge, and landing page. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 04e10c63-8abf-4a9c-b149-158d2b829bb5
jamesmontemagno
approved these changes
Sep 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refreshes all 13 workshop modules and slide decks against the currently installed CLI. Every claim below was verified against live CLI output, and every module was then executed end-to-end in the workshop Docker container.
Accuracy corrections
sandbox.gitAuth/ghAuth→sandbox.auth.git/auth.gh— wrong key was silently ignored--share/--share-gistare non-interactive-only;/sharefor live sessions--resume(session picker) from--continue(most recent session)shell(git)→shell(git:*)— bare form never matched git subcommands--available-tools/--excluded-toolstake tool names, not permission rule kinds/usagereports AI credits, not premium requests/plugins→/plugin;--scopegainssession,working-directorydiscover-resourcescopilot mcp listomits built-in servers;/mcpshows themassistedmode requires experimental auto-approval/sandboxalso registers under a managed policyconfig.jsonvs reposettings.jsonCoverage added
--sandbox,--assisted-approval,--usage-output-file,--enable-mcp-server,--extension-sdk-path,--no-eager-powershell-resolution,--remote,--remote-exportbannerStyle,defaultMode,defaultPermissionModeCOPILOT_ASSISTED_APPROVAL,COPILOT_MULTIPLEXER,COPILOT_INLINE_IMAGES_HERDRcopilot app,copilot init,/exit print,/modelsub-optionsjqandghto prerequisitesExercise bugs found by actually running the workshop
These all passed a syntax check but broke or misbehaved when executed:
> [!TIP]callout was trapped inside a<< 'EOF'heredoc, so it was written verbatim into the instructions file the reader generatesbashfences contained blocking interactive sessions and in-session!lines — pasting them created stray files and rannpm installin the reader's own shelltest-and-commit {was invalid bash; because it loads viaBASH_ENV, it firednpm teston every shell command Copilot rancopilot --versionexits before config init, so thels $COPILOT_HOMEstep always failed--sandboxwas silently ignored without--experimentalgithub→github-mcp-serverValidation
copilot-workshopcontainer — 130 commands, 122 passed, 8 failed, 77 skipped (interactive-only; none auth-gated, nothing hung). All 8 failures are fixed in this PR.--shareproduced a valid transcript,--continuerecovered a seeded codeword,--available-tools 'bash,view'genuinely restricted the tool list, GitHub MCP tool counts moved 5 → 0 → 46 as documented, and destructiverm/overwrite prompts were correctly blocked under default permissions.Housekeeping
docs.github.comURLs