feat: default to stable version and resolve aliases in install-gh-aw.sh by Copilot · Pull Request #23628 · github/gh-aw

Copilot · 2026-03-31T03:43:10Z

Summary

Updates install-gh-aw.sh to:

Default to "stable" instead of "latest" when no version is specified
Resolve version aliases from .github/aw/releases.json before constructing the download URL — so stable → v0.64.5, latest → latest, and any future aliases are resolved transparently

Changes

install-gh-aw.sh:
- Default version changed from "latest" to "stable"
- Added alias resolution block: fetches https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/releases.json and resolves the version through the aliases map
- Supports both jq (preferred) and a grep/sed fallback for environments without jq
- Regex-special characters in VERSION are escaped before using in the grep fallback
- jq parse failures are surfaced with a print_info message rather than silently ignored
- Self-referential aliases (e.g. "latest": "latest") emit a print_warning
- Updated header comments and examples

…n in install-gh-aw.sh Agent-Logs-Url: https://github.com/github/gh-aw/sessions/6a54af1b-4489-41f8-b650-cdc87dfdb9ed Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/6a54af1b-4489-41f8-b650-cdc87dfdb9ed Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot

Pull request overview

Updates the install-gh-aw.sh installer to default to a “stable” release channel and to resolve version aliases from the repository’s .github/aw/releases.json before computing download URLs.

Changes:

Change default install version from latest to stable.
Add alias-resolution logic by fetching .github/aw/releases.json, using jq when available and a grep/sed fallback otherwise.
Add logging around alias resolution outcomes (resolved, self-referential, not found, fetch failure).

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

Copilot · 2026-03-31T03:52:22Z

install-gh-aw.sh

+if [ -n "$releases_json" ]; then
+    resolved_version=""
+    if [ "$HAS_JQ" = true ]; then
+        resolved_version=$(echo "$releases_json" | jq -r ".aliases[\"$VERSION\"] // empty" 2>/dev/null) || {


jq filter is built by interpolating $VERSION directly into the jq program (".aliases["$VERSION"]"), which can break parsing for versions containing quotes/backslashes and allows user-controlled content to alter the jq query. Prefer passing VERSION via --arg and indexing .aliases[$arg] so alias lookup is safe and robust.

Suggested change

resolved_version=$(echo "$releases_json" | jq -r ".aliases[\"$VERSION\"] // empty" 2>/dev/null) || {

resolved_version=$(echo "$releases_json" | jq -r --arg ver "$VERSION" '.aliases[$ver] // empty' 2>/dev/null) || {

Copilot · 2026-03-31T03:52:23Z

install-gh-aw.sh

+        resolved_version=$(echo "$releases_json" | jq -r ".aliases[\"$VERSION\"] // empty" 2>/dev/null) || {
+            print_info "jq failed to parse releases.json; alias resolution skipped"
+        }


If jq parsing fails in this block, resolved_version stays empty and the script later reports "No alias found" (even though alias resolution was skipped due to a parse error). Consider tracking a jq-parse-failed flag (or falling back to the grep/sed path on jq failure) so the resulting log/message reflects the actual error condition.

Copilot · 2026-03-31T03:52:23Z

install-gh-aw.sh

+    else
+        # Fallback: extract alias value using grep/sed
+        # Escape regex special characters in VERSION to avoid unintended matches
+        version_escaped=$(printf '%s' "$VERSION" | sed 's/[.[\*^$]/\\&/g')


The sed character class used to escape regex metacharacters (s/[.[\*^$]/.../) is not portable: including [ inside a bracket expression without placing it first (or escaping it) can be a syntax error on BSD/macOS sed. That would cause the script to exit under set -e on systems without jq. Use a portable character class (e.g., place ]/[ first and also consider escaping \).

Suggested change

version_escaped=$(printf '%s' "$VERSION" | sed 's/[.[\*^$]/\\&/g')

version_escaped=$(printf '%s' "$VERSION" | sed 's/[][.[\*^$\\]/\\&/g')

Copilot · 2026-03-31T03:52:23Z

install-gh-aw.sh

+        print_info "Resolved alias '$VERSION' -> '$resolved_version'"
+        VERSION="$resolved_version"
+    elif [ -n "$resolved_version" ]; then
+        print_warning "Version '$VERSION' is an alias for itself in releases.json (no change); this may indicate a misconfiguration"


Given the current .github/aw/releases.json includes a self-referential alias ("latest": "latest"), this branch will emit a WARNING for the common latest case and says it "may indicate a misconfiguration". If self-referential aliases are expected/intentional (at least for latest), consider downgrading this to an info message or special-casing known intentional self-aliases to avoid noisy/misleading warnings.

Suggested change

print_warning "Version '$VERSION' is an alias for itself in releases.json (no change); this may indicate a misconfiguration"

if [ "$VERSION" = "latest" ]; then

print_info "Version 'latest' is a self-referential alias in releases.json; using 'latest' as-is"

else

print_warning "Version '$VERSION' is an alias for itself in releases.json (no change); this may indicate a misconfiguration"

fi

Copilot AI and others added 2 commits March 31, 2026 03:42

feat: default to stable version and resolve aliases from releases.jso…

61f7c46

…n in install-gh-aw.sh Agent-Logs-Url: https://github.com/github/gh-aw/sessions/6a54af1b-4489-41f8-b650-cdc87dfdb9ed Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

fix: address code review feedback in alias resolution logic

26b4ece

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/6a54af1b-4489-41f8-b650-cdc87dfdb9ed Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI assigned Copilot and pelikhan Mar 31, 2026

Copilot created this pull request from a session on behalf of pelikhan March 31, 2026 03:43 View session

Copilot AI requested a review from pelikhan March 31, 2026 03:43

Copilot finished work on behalf of pelikhan March 31, 2026 03:43

pelikhan marked this pull request as ready for review March 31, 2026 03:49

Copilot AI review requested due to automatic review settings March 31, 2026 03:49

Copilot started reviewing on behalf of pelikhan March 31, 2026 03:49 View session

pelikhan merged commit 6bf3f5b into main Mar 31, 2026
9 checks passed

pelikhan deleted the copilot/update-install-gh-aw-script branch March 31, 2026 03:50

Copilot AI reviewed Mar 31, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: default to stable version and resolve aliases in install-gh-aw.sh#23628

feat: default to stable version and resolve aliases in install-gh-aw.sh#23628
pelikhan merged 2 commits intomainfrom
copilot/update-install-gh-aw-script

Copilot AI commented Mar 31, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 31, 2026

Uh oh!

Copilot AI Mar 31, 2026

Uh oh!

Copilot AI Mar 31, 2026

Uh oh!

Copilot AI Mar 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	resolved_version=$(echo "$releases_json" \| jq -r ".aliases[\"$VERSION\"] // empty" 2>/dev/null) \|\| {
	resolved_version=$(echo "$releases_json" \| jq -r --arg ver "$VERSION" '.aliases[$ver] // empty' 2>/dev/null) \|\| {

	version_escaped=$(printf '%s' "$VERSION" \| sed 's/[.[\*^$]/\\&/g')
	version_escaped=$(printf '%s' "$VERSION" \| sed 's/[][.[\*^$\\]/\\&/g')

Conversation

Copilot AI commented Mar 31, 2026

Summary

Changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants