Skip to content

feat(install): add checksum-verified one-line first-time installers#942

Merged
jamesadevine merged 3 commits into
mainfrom
copilot/add-installer-scripts
Jun 10, 2026
Merged

feat(install): add checksum-verified one-line first-time installers#942
jamesadevine merged 3 commits into
mainfrom
copilot/add-installer-scripts

Conversation

Copilot AI commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds first-time install support for Linux, macOS, and Windows with one-line commands, checksum verification, and automatic PATH handling. Also aligns user-facing docs and agent templates to the same install flow.

  • Cross-platform installer scripts

    • Added:
      • scripts/install/install-linux.sh
      • scripts/install/install-macos.sh
      • scripts/install/install-windows.ps1
    • Each script downloads the platform asset + checksums.txt, verifies SHA-256, installs to a standard writable location, and updates user PATH when needed.
  • One-line install pattern in docs

    • Replaced manual binary download snippets with script-based one-liners in:
      • README.md
      • site/src/content/docs/setup/quick-start.mdx
      • site/public/ai/faq.json
  • Agent-facing install guidance

    • Updated installer instructions in:
      • .github/agents/ado-aw.agent.md
      • src/data/init-agent.md
    • Agent guidance now references the same one-line install flow and ado-aw --version post-check.
# Linux
curl -fsSL https://raw.githubusercontent.com/githubnext/ado-aw/main/scripts/install/install-linux.sh | sh

# macOS (Apple Silicon)
curl -fsSL https://raw.githubusercontent.com/githubnext/ado-aw/main/scripts/install/install-macos.sh | sh

Test plan

Covered by standard PR CI checks.

Copilot AI and others added 2 commits June 10, 2026 06:00
Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>
Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>
…rtial downloads

Shrinks the install supply-chain trust boundary and removes the partial-download
execution hazard from the curl|sh / iwr|iex one-liners introduced in this PR.

* Ship `install-{linux,macos}.sh` and `install-windows.ps1` as release assets
  in release.yml and include them in `checksums.txt`. Compromising the installer
  now requires cutting a release, not just pushing to `main`.
* Rewrite all documented one-liners (README, quick-start.mdx, faq.json,
  ado-aw.agent.md, init-agent.md) from
  `raw.githubusercontent.com/.../main/scripts/install/...` to
  `github.com/githubnext/ado-aw/releases/latest/download/install-*.{sh,ps1}`.
* Wrap each shell installer body in a `main` function called on the final line.
  If the curl|sh stream is truncated, sh fails to parse the script before
  invoking `main` and nothing runs.
* Wrap the PowerShell installer body in `Install-AdoAw` invoked on the final
  line for the same reason.
* Pin `scripts/install/*.{sh,ps1}` to `eol=lf` so they don't ship with CRLF
  when committed from Windows.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@jamesadevine jamesadevine marked this pull request as ready for review June 10, 2026 13:02
@jamesadevine jamesadevine merged commit 040cdad into main Jun 10, 2026
8 checks passed
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