Skip to main content

In this article

Installing HVE Core

HVE Core delivers one complete component set through the hve-core VS Code extension and Copilot CLI plugin. Choose a managed installation or copy selected components from a clone.

Managed Installation​

Install ise-hve-essentials.hve-core from the VS Code Marketplace, or register this repository as a Copilot CLI marketplace and install hve-core@hve-core.

The VS Code extension's Stable and PreRelease channels contain the same complete component set. They differ in source ownership, cadence, and version. The Copilot CLI plugin has one registration that tracks main. See HVE Core Identity and Channels for the release contract.

Selective Clone Adoption​

Teams that need a repository-owned subset can use hve-core-installer.

  1. Clone or pin the HVE Core version to adopt.
  2. Choose every component declared by root plugin.json, or select a subset.
  3. Review component kinds and collisions before writes.
  4. Choose automatic source updates or a controlled pinned version.

The installer can copy agents, instructions, and complete skill directories. It preserves repository-relative paths and records the result in .hve-tracking.json schema version 2. Hooks are not copied.

Decision Matrix​

EnvironmentTeamUpdatesRecommended Method
Any (simplest)AnyAutoVS Code Extension ⭐
Local (no container)SoloManualPeer Directory Clone
Local (no container)TeamControlledSubmodule
Local devcontainerSoloAutoGit-Ignored Folder
Local devcontainerTeamControlledSubmodule
Codespaces onlySoloAutoGitHub Codespaces
Codespaces onlyTeamControlledSubmodule
Both local + CodespacesAnyAnyMulti-Root Workspace
Advanced (shared install)SoloAutoMounted Directory
Any (CLI preferred)AnyManualCLI Plugins

⭐ VS Code Extension is the recommended method for most users who don't need customization.

NOTE

HVE Core uses one identity across the plugin and extension. Root plugin.json owns membership, and .github/plugin/marketplace.json contains one relative locator to the repository root. Plugin clients resolve root README and LICENSE; the VSIX keeps its extension-owned metadata.

Distribution Relationships​

Which Installation Should I Use?​

  • Use the VS Code extension for managed updates in Copilot Chat.
  • Use the hve-core plugin for Copilot CLI.
  • Use selective clone adoption when your repository should own only chosen files.

Distribution Identity and Channels​

The Copilot CLI plugin has one registration, microsoft/hve-core, which tracks main. There are no PreRelease or Stable plugin channels.

The VS Code extension is published as PreRelease and Stable from reviewed release branches that advance through main to release/prerelease to release/stable.

A published extension release is the assurance boundary for its immutable tag. The release workflow applies review and release gates, produces one VSIX and its SBOM and provenance sidecars, verifies provenance, and publishes through the configured release path. The plugin registration resolves main and does not carry that published-release assurance.

See HVE Core Identity and Channels for the lifecycle and source contract.

Copilot Plugin Registration​

Register the marketplace and install the plugin:

copilot plugin marketplace add microsoft/hve-core
copilot plugin install hve-core@hve-core

Refresh and Update​

Marketplace refresh and installed-plugin update are separate client actions. Refresh the catalog before requesting a plugin update:

copilot plugin marketplace update hve-core
copilot plugin update hve-core@hve-core

If you registered a release-channel or tag ref earlier, follow Replace an Earlier Registration.

Clone Methods​

The installer validates each selected component against root plugin.json. Schema version 2 stores selection.profile and selection.components without package identity. File records identify component ownership, and hooks remain plugin-only.

Developer Setup​

Contributors and advanced users who need to modify HVE Core source code should clone the repository directly.

  1. Fork and clone the repository:

    git clone https://github.com/<your-fork>/hve-core.git

  2. Install dependencies:

    cd hve-core && npm ci

  3. Open the workspace in VS Code. A devcontainer configuration is included for containerized development.

Detailed instructions for each clone-based approach:

Choosing a Method​

The three paths above cover the vast majority of scenarios. If your environment has specific constraints (Codespaces-only, mounted containers, multi-root workspaces), the Comparing Setup Methods page has a detailed decision matrix and decision tree. The Setup Methods Overview lists every available approach.

Validation​

After installing, verify artifacts declared by the HVE Core plugin:

  1. Open HVE Core Plugin and choose a declared agent, instruction, or skill to verify.
  2. Confirm that component is available through the installed extension or plugin client.
  3. Open Copilot Chat, type @ to find RPI Agent, then type / and verify its RPI entry points.

If a declared component is unavailable, check the Troubleshooting page for common solutions.

Post-Installation: Update Your .gitignore​

Add this line to your project's .gitignore:

.copilot-tracking/

IMPORTANT

This applies to all installation methods. The .copilot-tracking/ folder is created in your project directory, not in HVE Core itself.

The folder stores ephemeral workflow artifacts (research documents, implementation plans, PR review notes, and work item planning files) that help agents maintain context across sessions. These files are useful during your workflow but should not be committed to your repository.

MCP Server Configuration (Optional)​

Some HVE Core agents use MCP (Model Context Protocol) servers to integrate with Azure DevOps, GitHub, or documentation services. Agents work without MCP configuration; it is an optional enhancement.

See MCP Server Configuration for setup instructions covering server requirements, configuration templates, and troubleshooting.

Next Steps​

🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.