---
title: Git-Ignored Folder Installation
description: Install HVE Core in a git-ignored folder for devcontainer environments
sidebar_position: 3
author: Microsoft
ms.date: 2026-06-11
ms.topic: how-to
keywords:
- git-ignored
- installation
- github copilot
- devcontainer
estimated_reading_time: 6
---
Git-Ignored Folder installation places HVE Core inside your project in a `.hve-core/` folder that's excluded from version control. This is ideal for solo developers using devcontainers who want a self-contained setup.
## When to Use This Method
✅ **Use this when:**
* You use local devcontainers (Docker Desktop)
* You're working solo
* You want HVE Core auto-updated with container rebuilds
* You want a self-contained project (no external dependencies)
❌ **Consider alternatives when:**
* Your team needs version control → [Submodule](submodule.md)
* You use Codespaces → [GitHub Codespaces](codespaces.md)
* You want to share HVE Core across projects → [Mounted Directory](mounted.md)
* You need paths that work everywhere → [Multi-Root Workspace](multi-root.md)
## How It Works
HVE Core is cloned into a `.hve-core/` folder inside your project. The folder is added to `.gitignore` so it doesn't pollute your repository.
```text
my-project/
├── .devcontainer/
│ └── devcontainer.json # postCreateCommand clones HVE Core
├── .hve-core/ # Git-ignored, contains HVE Core
│ └── .github/
│ ├── agents/
│ ├── prompts/
│ └── instructions/
├── .gitignore # Includes .hve-core/
├── .vscode/
│ └── settings.json # Points to .hve-core paths
└── src/
```
## Quick Start
Install the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-core) for the fastest setup. For guided setup with installation method selection and MCP configuration, install the [HVE Core Installer](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-installer) extension and ask any agent "help me customize hve-core installation". Use the manual steps below for direct configuration.
## Manual Setup
### Step 1: Update .gitignore
Add the HVE Core folder to your `.gitignore`:
```text
# HVE Core installation (local only)
.hve-core/
```
### Step 2: Clone HVE Core
#### PowerShell
```powershell
# Create folder and clone
$hveCoreFolder = ".hve-core"
if (-not (Test-Path $hveCoreFolder)) {
git clone https://github.com/microsoft/hve-core.git $hveCoreFolder
Write-Host "✅ Cloned HVE Core to $hveCoreFolder"
}
```
#### Bash
```bash
HVE_CORE_FOLDER=".hve-core"
if [ ! -d "$HVE_CORE_FOLDER" ]; then
git clone https://github.com/microsoft/hve-core.git "$HVE_CORE_FOLDER"
echo "✅ Cloned HVE Core to $HVE_CORE_FOLDER"
fi
```
### Step 3: Update VS Code Settings
Create or update `.vscode/settings.json`:
```json
{
"chat.agentFilesLocations": {
".hve-core/.github/agents/ado": true,
".hve-core/.github/agents/data-science": true,
".hve-core/.github/agents/design-thinking": true,
".hve-core/.github/agents/github": true,
".hve-core/.github/agents/project-planning": true,
".hve-core/.github/agents/hve-core": true,
".hve-core/.github/agents/hve-core/subagents": true,
".hve-core/.github/agents/security": true
},
"chat.promptFilesLocations": {
".hve-core/.github/prompts/ado": true,
".hve-core/.github/prompts/design-thinking": true,
".hve-core/.github/prompts/github": true,
".hve-core/.github/prompts/hve-core": true,
".hve-core/.github/prompts/security": true
},
"chat.instructionsFilesLocations": {
".hve-core/.github/instructions/ado": true,
".hve-core/.github/instructions/coding-standards": true,
".hve-core/.github/instructions/github": true,
".hve-core/.github/instructions/hve-core": true,
".hve-core/.github/instructions/shared": true
},
"chat.agentSkillsLocations": {
".hve-core/.github/skills": true,
".hve-core/.github/skills/shared": true,
".hve-core/.github/skills/coding-standards": true,
".hve-core/.github/skills/design-thinking": true
}
}
```
### Step 4: Automate with Devcontainer
Add to `.devcontainer/devcontainer.json` so HVE Core is cloned on container creation:
```jsonc
{
// ... existing configuration ...
"postCreateCommand": "[ -d .hve-core ] || git clone --depth 1 https://github.com/microsoft/hve-core.git .hve-core"
}
```
### Step 5: Validate Installation
1. Rebuild your devcontainer (`Ctrl+Shift+P` → "Dev Containers: Rebuild Container")
2. Open GitHub Copilot Chat (`Ctrl+Alt+I`)
3. Click the agent picker dropdown
4. Verify HVE Core agents appear (task-planner, task-researcher, prompt-builder)
## Complete Devcontainer Example
```jsonc
{
"name": "My Project with HVE Core",
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"postCreateCommand": "[ -d .hve-core ] || git clone --depth 1 https://github.com/microsoft/hve-core.git .hve-core",
"customizations": {
"vscode": {
"settings": {
"chat.agentFilesLocations": {
".hve-core/.github/agents/ado": true,
".hve-core/.github/agents/data-science": true,
".hve-core/.github/agents/design-thinking": true,
".hve-core/.github/agents/github": true,
".hve-core/.github/agents/project-planning": true,
".hve-core/.github/agents/hve-core": true,
".hve-core/.github/agents/hve-core/subagents": true,
".hve-core/.github/agents/security": true
},
"chat.promptFilesLocations": {
".hve-core/.github/prompts/ado": true,
".hve-core/.github/prompts/design-thinking": true,
".hve-core/.github/prompts/github": true,
".hve-core/.github/prompts/hve-core": true,
".hve-core/.github/prompts/security": true
},
"chat.instructionsFilesLocations": {
".hve-core/.github/instructions/ado": true,
".hve-core/.github/instructions/coding-standards": true,
".hve-core/.github/instructions/github": true,
".hve-core/.github/instructions/hve-core": true,
".hve-core/.github/instructions/shared": true
},
"chat.agentSkillsLocations": {
".hve-core/.github/skills": true,
".hve-core/.github/skills/shared": true,
".hve-core/.github/skills/coding-standards": true,
".hve-core/.github/skills/design-thinking": true
}
}
}
}
}
```
## Updating HVE Core
### Manual update
```bash
cd .hve-core
git pull
```
### Auto-update on container rebuild
The `postCreateCommand` re-clones on each container creation. To update, rebuild the container.
### Auto-update with version check
```jsonc
{
"postCreateCommand": {
"clone-or-update": "[ -d .hve-core ] && (cd .hve-core && git pull) || git clone --depth 1 https://github.com/microsoft/hve-core.git .hve-core"
}
}
```
## Troubleshooting
### Agents Not Appearing
#### Check the folder exists
```bash
ls .hve-core/.github/agents
```
#### Check settings are applied
1. Open Command Palette (`Ctrl+Shift+P`)
2. Type "Preferences: Open Workspace Settings (JSON)"
3. Verify the paths are correct
### Folder Not Ignored by Git
Check your `.gitignore` includes `.hve-core/`:
```bash
cat .gitignore | grep hve-core
```
If missing, add it:
```bash
echo ".hve-core/" >> .gitignore
```
### Clone Fails in Devcontainer
If `postCreateCommand` fails, check:
1. Network connectivity in the container
2. Git is available (`git --version`)
3. GitHub is accessible (`curl -I https://github.com`)
### Container Rebuild Doesn't Update
The clone only happens if the folder doesn't exist. To force update:
```jsonc
{
"postCreateCommand": "rm -rf .hve-core && git clone --depth 1 https://github.com/microsoft/hve-core.git .hve-core"
}
```
**Warning:** This deletes any local changes to HVE Core on every rebuild.
## Limitations
| Aspect | Status |
|------------------|--------------------------------------------------------------------|
| Devcontainers | ✅ Designed for this |
| Codespaces | ⚠️ Works but not optimal (use [Codespaces method](codespaces.md)) |
| Team sharing | ⚠️ Each developer clones separately |
| Portable paths | ✅ Relative paths work |
| Version pinning | ⚠️ Manual (modify clone command) |
| Disk usage | ⚠️ Per-project copy |
| Setup complexity | ✅ Simple |
## Next Steps
* [Your First Workflow](../first-workflow.md) - Try HVE Core with a real task
* [Multi-Root Workspace](multi-root.md) - Share across local + Codespaces
* [Submodule](submodule.md) - Add version control for teams
---
<!-- markdownlint-disable MD036 -->
*🤖 Crafted with precision by ✨Copilot following brilliant human instruction,
then carefully refined by our team of discerning human reviewers.*
<!-- markdownlint-enable MD036 -->microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/getting-started/methods/git-ignored.md
294lines · modepreview