install-devcontainer

name	install-devcontainer
description	Install and configure the copilot-devcontainer setup in a target project. Use when asked to: set up a devcontainer, configure GitHub Copilot CLI, bootstrap an AI-assisted development environment, install Copilot CLI plugins, or add devcontainer files to an existing repo. Keywords: devcontainer setup, copilot CLI install, GitHub Copilot configure, AI dev environment, MCP servers.

install-devcontainer

This skill installs the yldgio/copilot-devcontainer template into a target project and walks through all post-install configuration steps, including the interactive Copilot setup wizard, authentication, and optional legacy plugin-only setup.

---

Step 1 — Detect Environment

# OS
uname -s 2>/dev/null || echo "Windows — use PowerShell installer"

# Docker
docker info 2>/dev/null | head -1 || echo "WARN: Docker not running — start it before proceeding"

# Node.js (for npx installer, requires v18+)
node --version 2>/dev/null || echo "Node.js unavailable"

# Conflict check
test -d .devcontainer \
  && echo "CONFLICT: .devcontainer/ exists — use --force if intentional" \
  || echo "OK: no conflict"

Decision rules:

• uname returns Linux or Darwin and Node.js 18+ is present → use npx (Option A)
• uname returns Linux or Darwin and Node.js is absent → use bash (Option B)
• On Windows → use PowerShell (Option C)
• .devcontainer/ exists and replacement is intended → add --force

---

Step 2 — Run the Installer

Pick one option based on Step 1:

# Option A: npx (preferred, Node.js 18+ required)
npx github:yldgio/copilot-devcontainer

# Option B: bash (Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/yldgio/copilot-devcontainer/main/install.sh | bash

# Option C: PowerShell (Windows)
irm https://raw.githubusercontent.com/yldgio/copilot-devcontainer/main/install.ps1 | iex

Force overwrite variants (when .devcontainer/ already exists):

npx github:yldgio/copilot-devcontainer -- --force
curl -fsSL https://raw.githubusercontent.com/yldgio/copilot-devcontainer/main/install.sh | bash -s -- --force

$env:DEVCONTAINER_FORCE = "1"; irm https://raw.githubusercontent.com/yldgio/copilot-devcontainer/main/install.ps1 | iex

Expected: ✅ Dev container files installed successfully.

---

Step 3 — Open in Dev Container

Notify the user:

Installer complete. Open this folder in VS Code, then use the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run Dev Containers: Reopen in Container. The postCreateCommand will run setup.sh automatically — wait for it to complete before proceeding.

Expected final line from setup.sh:

✅ Setup complete.

---

Step 4 — Run the Copilot Setup Wizard

Inside the container terminal:

bash .devcontainer/scripts/setup-copilot.sh

Explain to the user that the wizard supports:

• new container first-run customization
• existing container reconfiguration
• opt-in plugin management, BYOK, and offline mode

If plugin actions are deferred, the wizard will tell the user to complete login and rerun it.

---

Step 5 — Authenticate Copilot CLI

Inside the container terminal:

copilot

At the TUI prompt:

/login

Instruct the user: "A browser OAuth flow will open. Complete the GitHub authorization to continue."

Verify after OAuth:

copilot --version

---

Step 6 — Install Plugins (optional, legacy path)

Requires authentication from Step 5.

bash .devcontainer/scripts/install-plugins.sh

Installs: microsoft/azure-skills, github/awesome-copilot, microsoft/work-iq.

Verify inside the TUI: type /plugins.

---

Step 7 — Verify the Full Setup

Run inside the container:

command -v copilot && copilot --version
uv --version
uv run python --version
gh --version
docker info 2>/dev/null | grep "Server Version"

All five commands should return version strings.

---

Quick Troubleshooting

Problem	Fix
copilot: command not found	export PATH="$HOME/.local/bin:$PATH"
uv: command not found	source ~/.bashrc then retry
Docker not running	Start Docker Desktop before running the installer
.devcontainer/ already exists	Re-run installer with --force

For full troubleshooting, see AUTO-INSTALL.md §8.