feat(agent): Add automated installation via hve-core-installer agent #82
+630
−47
Conversation
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
- create hve-core-installer agent with cross-platform support (PowerShell and Bash) - add shell preference prompt for better user experience - implement direct clone/validate/edit workflow without external dependencies - add installation button badge to README linking to automated setup - consolidate installation and troubleshooting documentation in getting-started guide 🚀 - Generated by Copilot
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
Copilot finished reviewing on behalf of
WilliamBerryiii
November 22, 2025 01:47
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces an automated installation system for HVE Core that reduces setup time from 10-15 minutes to approximately 30 seconds. It adds a new installer agent (hve-core-installer.agent.md) that orchestrates the complete installation workflow including workspace detection, repository cloning, validation, and VS Code settings configuration. The documentation has been updated to prioritize automated installation while maintaining manual installation as a fallback option.
Key Changes:
- New installer agent with comprehensive workflow orchestration and error handling
- Updated documentation structure promoting automated installation as the primary method
- Cross-platform support with both PowerShell and Bash command alternatives
- Two-checkpoint authorization system requiring explicit user consent
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 14 comments.
| File | Description |
|---|---|
.github/agents/hve-core-installer.agent.md |
New automated installer agent with workflow steps, cross-platform commands, authorization checkpoints, and error recovery guidance |
docs/getting-started.md |
Restructured to feature automated installation first, added comprehensive troubleshooting section covering installation and configuration issues |
README.md |
Added installation badge, quick install section, and reorganized prerequisites to emphasize automated installation method |
- fix agent schema and add to schema mapping - fix prompt, instruction, and chatmode schemas - correct agent file tool names and bash commands - fix documentation badge and marketing text ✅ - Generated by Copilot
🔧 - Generated by Copilot
WilliamBerryiii
requested review from
ChrisRisner,
agreaves-ms,
auyidi1 and
mkcomer
Copilot finished reviewing on behalf of
WilliamBerryiii
November 22, 2025 03:22
- add .github/agents to PowerShell and Bash requiredPaths validation - fix PowerShell OS detection to use reliable automatic variables - add Windows PowerShell 5.1 fallback for missing $IsWindows - fix Bash Windows path handling with cygpath conversion - add cygwin OSTYPE detection for broader Git Bash support 🔧 - Generated by Copilot
- reorder Step 5 to detect OS path before creating backup - add timestamped backup instructions for settings.json - fix PowerShell OS detection using [System.Environment]::OSVersion.Platform - remove .github/agents from validation (no VS Code setting required) - fix agent schema: additionalProperties false for consistency 🔧 - Generated by Copilot
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.
Implemented a one-click automated installation system that reduces HVE Core setup time from 10-15 minutes to ~30 seconds, eliminating manual configuration steps and common setup errors through a guided agent workflow.
feat(agent): Created hve-core-installer agent with comprehensive installation orchestration workflow including workspace detection, repository cloning to sibling directory, structure validation, and direct VS Code settings.json modification using agent tools
feat(agent): Added cross-platform support with both PowerShell and Bash command alternatives for all operations (workspace detection, cloning, validation, settings path resolution) and intelligent shell preference prompt at workflow start that accepts multiple response formats with OS-based fallback detection
feat(agent): Implemented two authorization checkpoints requiring explicit user consent before starting installation and before modifying settings.json, with detailed change previews and ability to cancel at any point
feat(agent): Added comprehensive error handling and troubleshooting guidance for six failure scenarios including git detection issues, clone failures, validation errors, settings update failures, permission problems, and network connectivity issues
feat(docs): Added installation button badge to README with VS Code blue styling linking to automated installation section, restructured Quick Start with automated installation as primary method and manual installation as fallback
feat(docs): Consolidated installation and troubleshooting documentation in getting-started guide with automated installation section at top and expanded troubleshooting covering all common installation issues (git errors, clone failures, settings permissions, agent availability) plus configuration issues
feat(agent): Implemented safe settings.json merge logic that creates timestamped backups, parses existing configuration, adds three array paths without duplicates (chat.modeFilesLocations, chat.promptFilesLocations, chat.instructionsFilesLocations), and preserves all existing settings
Notes
Important
Closes #81
Closes #85
🚀 - Generated by Copilot