{
  "markdown": "<!-- mcp-name: io.github.devantler-tech/ksail -->\n[![GitHub Stars](https://img.shields.io/github/stars/devantler-tech/ksail?style=flat)](https://github.com/devantler-tech/ksail/stargazers)\n[![Latest Release](https://img.shields.io/github/v/release/devantler-tech/ksail)](https://github.com/devantler-tech/ksail/releases/latest)\n[![License](https://img.shields.io/badge/License-PolyForm--Shield--1.0.0-blue.svg)](https://polyformproject.org/licenses/shield/1.0.0)\n[![Go Reference](https://pkg.go.dev/badge/github.com/devantler-tech/ksail/v7.svg)](https://pkg.go.dev/github.com/devantler-tech/ksail/v7)\n[![CI - KSail](https://github.com/devantler-tech/ksail/actions/workflows/ci.yaml/badge.svg)](https://github.com/devantler-tech/ksail/actions/workflows/ci.yaml)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.devantler--tech/ksail-blue?logo=github)](https://github.com/mcp)\n\n# 🛥️🐳 KSail\n\n![ksail](./docs/src/assets/ksail-cli-dark.png)\n\nKSail bundles common Kubernetes tooling into a single binary. Spin up local clusters, deploy workloads, and operate cloud-native stacks across distributions and providers through a CLI, VS Code extension, AI chat TUI, or MCP server — with **only Docker or access to a Cloud Provider required**.\n\n📖 **Full documentation:** <https://ksail.devantler.tech>\n\n## Quick Install\n\n```bash\n# Linux / macOS (checksum-verified release)\ncurl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh\n\n# macOS (Homebrew)\nbrew install --cask devantler-tech/tap/ksail\n```\n\nSee the [Installation Guide](https://ksail.devantler.tech/installation/) for binary downloads and more options.\n\n## AI Assistant Plugins\n\nInstall the ksail plugin for [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) or [Claude Code](https://code.claude.com/docs/en/discover-plugins) to auto-register ksail's MCP server and a ksail expertise skill.\n\n**Copilot CLI:**\n\n```bash\ncopilot plugin marketplace add devantler-tech/ksail\ncopilot plugin install ksail\n```\n\n**Claude Code:**\n\n```text\n/plugin marketplace add devantler-tech/ksail\n/plugin install ksail@ksail\n```\n\nRequires `ksail` on `PATH`.\n\n## Quick Start\n\n```bash\nksail project init --name my-app   # scaffold project + native configs\nksail cluster create               # spin up the cluster (Docker only)\nksail cluster connect              # open K9s\n```\n\nContinue with the [Getting Started guide](https://ksail.devantler.tech/) for GitOps, workloads, and multi-tenancy.\n\n## What KSail Bundles\n\n| Category                 | Built-in Capabilities                                                |\n|--------------------------|----------------------------------------------------------------------|\n| Cluster Provisioning     | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS               |\n| Container Orchestration  | kubectl, Helm, Kustomize                                             |\n| GitOps Engines           | Flux, ArgoCD                                                         |\n| Secrets Management       | SOPS with Age encryption                                             |\n| Manifest Validation      | Kubeconform                                                          |\n| Cluster Operations       | K9s, backup & restore, multi-tenancy (`ksail tenant`)                |\n| AI Integration           | Chat assistant (Copilot SDK), MCP server, VS Code extension          |\n| Infrastructure Providers | Docker (local), Kubernetes (nested), Hetzner Cloud, Sidero Omni, AWS |\n\nSee the [feature overview](https://ksail.devantler.tech/features/) and [architecture guide](https://ksail.devantler.tech/architecture/) for details.\n\n## Supported Platforms\n\n| OS                                            | Architecture |\n|-----------------------------------------------|--------------|\n| 🐧 Linux                                      | amd64, arm64 |\n| 🍎 macOS                                      | arm64        |\n| ⊞ Windows (native untested; WSL2 recommended) | amd64, arm64 |\n\n| Provider   | Vanilla  | K3s     | Talos | VCluster | KWOK        | EKS |\n|------------|----------|---------|-------|----------|-------------|-----|\n| Docker     | ✅ (Kind) | ✅ (K3d) | ✅     | ✅ (Vind) | ✅ (kwokctl) | —   |\n| Kubernetes | ✅        | ✅       | ✅     | ✅        | ✅           | —   |\n| Hetzner    | —        | —       | ✅     | —        | —           | —   |\n| Omni       | —        | —       | ✅     | —        | —           | —   |\n| AWS        | —        | —       | —     | —        | —           | 🚧  |\n\n## Community & Support\n\n- 💬 **[GitHub Discussions](https://github.com/devantler-tech/ksail/discussions)** — questions, ideas, and community\n- 🐛 **[Issue Tracker](https://github.com/devantler-tech/ksail/issues)** — bugs and feature requests\n- 📖 **[Documentation](https://ksail.devantler.tech)** — guides, CLI reference, architecture\n- 🎓 **[Resources](https://ksail.devantler.tech/resources/)** — presentations, blog posts, tutorials\n- ⭐ **[Star the repo](https://github.com/devantler-tech/ksail)** — help others discover KSail\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process, coding standards, and PR guidelines. Start with issues labeled [`good first issue`](https://github.com/devantler-tech/ksail/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).\n\n## Related Projects\n\n| Project                                                               | Description                                   | Type     |\n|-----------------------------------------------------------------------|-----------------------------------------------|----------|\n| [devantler-tech/platform](https://github.com/devantler-tech/platform) | The maintainer's personal kubernetes platform | Platform |\n\nUsing KSail in your project? Open a PR to add it here.\n\n## License\n\nKSail is licensed under the **[PolyForm Shield License 1.0.0](LICENSE)**. You may use, modify, and distribute KSail for any purpose — except providing a product that competes with KSail. When redistributing, you must include the [license terms](LICENSE) and the required copyright notice.\n\n**What this means in practice:**\n\n- ✅ Use KSail as a CLI tool in any project (open-source or proprietary)\n- ✅ Embed or link KSail as a library in your own software\n- ✅ Fork and modify KSail for internal or non-competing use\n- ✅ Use any license for your own project — no copyleft requirement\n- ❌ Build and distribute a product that competes with KSail\n\nFor the full license text including notice and non-compete details, see [LICENSE](LICENSE). For common questions, see the [Licensing FAQ](https://ksail.devantler.tech/faq/#licensing).\n\n## Star History\n\n<a href=\"https://www.star-history.com/#devantler-tech/ksail&type=timeline&legend=top-left\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&theme=dark&legend=top-left\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&legend=top-left\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=devantler-tech/ksail&type=timeline&legend=top-left\" />\n </picture>\n</a>\n",
  "bytes": 7279,
  "sha": "af5da6e635c56fca2ef93a6776262f95e771d368ead80b8f32ce4af57dbc0946",
  "repo_slug": "devantler-tech/ksail",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_devantler_tech_ksail_69618017/readme"
}