feat: add VSCode extension documentation and installation instructions

Signed-off-by: Nikolai Emil Damm <[email protected]>

Author: devantler

.github/workflows/cd.yaml

@@ -43,9 +43,6 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: 📚 Generate embedded docs
-        run: go generate ./pkg/svc/chat/...
-
       - name: 🏗️ Run GoReleaser
         uses: goreleaser/goreleaser-action@e435ccd777264be153ace6237001ef4d979d3a7a # v6.4.0
         with:
@@ -59,7 +56,6 @@ jobs:
   vscode-extension:
     name: 🧩 Release VSCode Extension
     runs-on: ubuntu-latest
-    needs: goreleaser
     permissions:
       contents: write
     defaults:

pkg/svc/chat/docs/features.mdx

@@ -234,6 +234,47 @@ ksail chat
 
 **Commands:** [`ksail chat`](/cli-flags/chat/chat-root/)
 
+## VSCode Extension
+
+Manage KSail clusters directly from Visual Studio Code with an integrated extension that provides cluster management, interactive wizards, and AI assistant integration.
+
+```bash
+# Install from VSCode Marketplace
+# Search for "KSail" in Extensions view
+```
+
+**Capabilities:**
+
+- **Clusters sidebar view** — View and manage clusters with status indicators (running/stopped)
+- **Interactive wizards** — Step-by-step configuration for cluster init and create operations
+- **Command palette** — Full access to all cluster lifecycle commands
+- **Keyboard shortcuts** — Quick access to common operations (`Cmd+Shift+K` prefix)
+- **Smart context menus** — Right-click actions based on cluster state
+- **MCP server provider** — Exposes KSail as an MCP server for AI assistants
+
+**Features:**
+
+| Feature              | Description                                           |
+| -------------------- | ----------------------------------------------------- |
+| Cluster tree view    | Shows all clusters with provider and status info      |
+| Init wizard          | Multi-step configuration for new clusters             |
+| Create wizard        | Guided cluster creation with component selection      |
+| Command shortcuts    | `Cmd+Shift+K I` (init), `C` (create), `D` (delete)   |
+| K9s integration      | Open cluster in K9s terminal UI                       |
+| MCP integration      | Use KSail with Copilot and other AI tools             |
+
+**Prerequisites:**
+
+- [KSail CLI](https://ksail.devantler.tech/installation/) installed and in PATH
+- [Docker](https://www.docker.com/get-started/) running (for cluster operations)
+- [K9s](https://k9scli.io/) (optional, for cluster connection)
+
+**Installation:** See [VSCode Extension Installation](/installation/#vscode-extension) for setup instructions.
+
+**Repository:** [vsce/](https://github.com/devantler-tech/ksail/tree/main/vsce)
+
+**Marketplace:** [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=devantler.ksail)
+
 ## Next Steps
 
 - **[Use Cases](/use-cases/)** – Workflows for learning, development, and CI/CD

pkg/svc/chat/docs/index.mdx

@@ -22,6 +22,58 @@ import { Card, CardGrid } from "@astrojs/starlight/components";
 import { Image } from "astro:assets";
 import mentalModel from "../../assets/mental-model.svg";
 
+## Why KSail?
+
+Setting up and operating Kubernetes clusters often requires juggling multiple CLI tools, writing bespoke scripts, and dealing with inconsistent workflows. KSail removes the tooling overhead so you can focus on your workloads.
+
+## Key Features
+
+- 📦 **One Binary** — Embeds cluster provisioning, GitOps engines, and deployment tooling. No tool sprawl.
+- ☸️ **Simple Clusters** — Spin up Vanilla, K3s, or Talos clusters with one command. Same workflow across distributions.
+- 📄 **Everything as Code** — Cluster settings, distribution configs, and workloads in version-controlled files.
+- 🔄 **GitOps Native** — Built-in Flux or ArgoCD support with bootstrap, push, and reconcile commands.
+- ⚙️ **Customizable Stack** — Select your CNI, CSI, policy engine, cert-manager, and mirror registries.
+- 🔐 **SOPS Built In** — Encrypt, decrypt, and edit secrets with integrated cipher commands.
+- 🤖 **AI Assistant** — Interactive chat powered by GitHub Copilot for configuration and troubleshooting.
+- 💻 **VSCode Extension** — Manage clusters from VSCode with wizards, sidebar views, and command palette.
+
+## Prerequisites
+
+KSail works on all major operating systems and CPU architectures:
+
+| OS | Architecture |
+|----|--------------|
+| 🐧 Linux | amd64, arm64 |
+| macOS | arm64 |
+| ⊞ Windows (untested) | amd64, arm64 |
+
+**Docker is required** for local clusters. Install Docker Desktop/Engine and ensure `docker ps` works.
+
+Supported distributions run on different infrastructure providers:
+
+| Provider | Vanilla | K3s | Talos |
+|----------|---------|-----|-------|
+| Docker | ✅ (Kind) | ✅ (K3d) | ✅ |
+| Hetzner | — | — | ✅ |
+
+## Quick Start
+
+``````bash
+# 1. Initialize a new project
+ksail cluster init --name my-cluster --distribution Vanilla
+
+# 2. Create and start the cluster
+ksail cluster create
+
+# 3. Add manifests to k8s/ directory
+
+# 4. Deploy workloads
+ksail workload apply -k ./k8s
+
+# 5. Connect with K9s
+ksail cluster connect
+``````
+
 ## How It Works
 
 <Image src={mentalModel} alt="KSail Mental Model" />
@@ -30,7 +82,7 @@ import mentalModel from "../../assets/mental-model.svg";
 
 <CardGrid>
   <Card title="Features" icon="rocket">
-    Cluster provisioning, GitOps, secret management, and more. [Learn more →](/features/)
+    Cluster provisioning, GitOps, secret management, VSCode extension, and more. [Learn more →](/features/)
   </Card>
   <Card title="Concepts" icon="open-book">
     Kubernetes, CNI, CSI, GitOps, and related technologies. [Learn more →](/concepts/)

pkg/svc/chat/docs/installation.mdx

@@ -125,6 +125,61 @@ To use the `ksail chat` AI assistant feature, you need the GitHub Copilot CLI:
 > [!NOTE]
 > GitHub Copilot requires an active subscription. The `ksail chat` command is optional and all other KSail features work without it.
 
+## VSCode Extension
+
+For Visual Studio Code users, install the KSail extension to manage clusters directly from your editor.
+
+<Tabs>
+  <TabItem label="Marketplace">
+    ### Install from Marketplace
+
+    1. Open VSCode
+    2. Press `Cmd+Shift+X` (macOS) or `Ctrl+Shift+X` (Windows/Linux) to open Extensions view
+    3. Search for "KSail"
+    4. Click **Install** on the extension by devantler
+
+    **Marketplace Link:** [KSail - Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=devantler.ksail)
+
+  </TabItem>
+
+  <TabItem label="VSIX File">
+    ### Install from VSIX
+
+    1. Download the latest `.vsix` file from [GitHub Releases](https://github.com/devantler-tech/ksail/releases)
+    2. Open VSCode
+    3. Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux)
+    4. Type `Extensions: Install from VSIX...`
+    5. Select the downloaded `.vsix` file
+
+  </TabItem>
+</Tabs>
+
+### Extension Prerequisites
+
+- **KSail CLI** installed and available in PATH (see [installation methods](#installation-methods) above)
+- **Docker** running (for cluster operations)
+- **K9s** (optional, for cluster connection via `Connect to Cluster` command)
+
+### Extension Features
+
+The extension provides:
+
+- **Cluster sidebar** with status indicators and context menus
+- **Interactive wizards** for cluster init and create
+- **Command palette** integration for all cluster operations
+- **Keyboard shortcuts** for common actions
+- **MCP server** integration for AI assistants
+
+See the [Features - VSCode Extension](/features/#vscode-extension) section for detailed capabilities.
+
+### Extension Settings
+
+Configure the extension in VSCode settings (`Cmd+,` / `Ctrl+,`):
+
+| Setting            | Description          | Default |
+| ------------------ | -------------------- | ------- |
+| `ksail.binaryPath` | Path to ksail binary | `ksail` |
+
 ## Verification
 
 After installation, verify that KSail is installed correctly: