mirrord-quickstart

1# Mirrord Quickstart Skill
2 
3## Purpose
4 
5Help new users get mirrord running quickly:
6- **Check** system requirements
7- **Install** mirrord (CLI, VS Code, or IntelliJ)
8- **Connect** to their first Kubernetes target
9- **Verify** the connection works
10 
11Go one step at a time — don't overwhelm a new user with all options at once, and when they first connect, explain what just happened.
12 
13## Critical First Steps
14 
15**Step 1: Detect user's environment**
16Ask or detect:
17- Operating system (macOS, Linux, Windows)
18- Preferred workflow (CLI, VS Code, IntelliJ)
19- Do they have kubectl configured?
20 
21**Step 2: Verify requirements**
22```bash
23# Check kubectl access
24kubectl cluster-info
25kubectl get pods -A | head -5
26```
27 
28If kubectl fails, help them configure it first.
29 
30**Cluster requirements:** Kubernetes `1.22` or later, with nodes on Linux kernel `5.4`+ and a containerd, CRI-O, or Docker runtime. Some features need a newer Kubernetes version (for example, the agent as an ephemeral container needs `1.23`); point users at [Cluster Requirements](https://metalbear.com/mirrord/docs/installing-mirrord#cluster-requirements) if a specific feature fails on an older cluster.
31 
32## Installation Paths
33 
34### CLI (recommended for getting started)
35 
36**Do not** run remote install scripts that pipe a network download into a shell interpreter. Use only methods your organization approves.
37…