Skip to content

install.md

Latest commit

 

History

History
181 lines (124 loc) · 8.42 KB

install.md

File metadata and controls

181 lines (124 loc) · 8.42 KB
Raw
title Installing HVE Core
description Install the HVE Core extension or plugin, or adopt selected components from a clone
sidebar_position 2
author Microsoft
ms.date 2026-10-07
ms.topic how-to
keywords
installation
setup
github copilot
marketplace
selective clone
estimated_reading_time 4

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

Environment Team Updates Recommended Method
Any (simplest) Any Auto VS Code Extension ⭐
Local (no container) Solo Manual Peer Directory Clone
Local (no container) Team Controlled Submodule
Local devcontainer Solo Auto Git-Ignored Folder
Local devcontainer Team Controlled Submodule
Codespaces only Solo Auto GitHub Codespaces
Codespaces only Team Controlled Submodule
Both local + Codespaces Any Any Multi-Root Workspace
Advanced (shared install) Solo Auto Mounted Directory
Any (CLI preferred) Any Manual CLI 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

graph LR
   accTitle: HVE Core distribution relationships
   accDescr: The repository contains the marketplace locator and plugin manifest. The locator resolves the plugin root, while the manifest supplies membership to both the Copilot plugin and VS Code extension.
   REPO["microsoft/hve-core<br/>(plugin root)"] --> MANIFEST["plugin.json<br/>(complete membership)"]
   REPO --> CATALOG[".github/plugin/marketplace.json<br/>(one relative locator)"]
   CATALOG --> ROOT["repository root<br/>(README and LICENSE)"]
   MANIFEST --> PLUGIN["hve-core plugin"]
   MANIFEST --> EXT["hve-core VSIX"]
   ROOT --> PLUGIN
Loading

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.