{"id":34600275,"url":"https://github.com/devantler-tech/ksail","last_synced_at":"2026-06-14T22:02:29.630Z","repository":{"id":214973547,"uuid":"737584922","full_name":"devantler-tech/ksail","owner":"devantler-tech","description":"Tool for creating, maintaining and operating Kubernetes clusters with ease.","archived":false,"fork":false,"pushed_at":"2026-02-26T06:51:11.000Z","size":730651,"stargazers_count":137,"open_issues_count":20,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-26T06:51:51.381Z","etag":null,"topics":["ai","app","argocd","cli","declarative","fluxcd","github-copilot","helm","hetzner","k3d","k3s","kind","kubeconform","kubectl","kubernetes","kustomize","mcp-server","talos-linux","tui","yaml"],"latest_commit_sha":null,"homepage":"http://ksail.devantler.tech/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devantler-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"devantler"}},"created_at":"2023-12-31T16:17:15.000Z","updated_at":"2026-02-26T02:55:53.000Z","dependencies_parsed_at":"2026-02-26T05:05:25.275Z","dependency_job_id":null,"html_url":"https://github.com/devantler-tech/ksail","commit_stats":null,"previous_names":["devantler/ksail","devantler-tech/ksail"],"tags_count":770,"template":false,"template_full_name":null,"purl":"pkg:github/devantler-tech/ksail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devantler-tech%2Fksail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devantler-tech%2Fksail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devantler-tech%2Fksail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devantler-tech%2Fksail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devantler-tech","download_url":"https://codeload.github.com/devantler-tech/ksail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devantler-tech%2Fksail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29987726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T22:42:38.399Z","status":"ssl_error","status_checked_at":"2026-03-01T22:41:51.863Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","app","argocd","cli","declarative","fluxcd","github-copilot","helm","hetzner","k3d","k3s","kind","kubeconform","kubectl","kubernetes","kustomize","mcp-server","talos-linux","tui","yaml"],"created_at":"2025-12-24T12:34:59.228Z","updated_at":"2026-06-07T03:03:45.744Z","avatar_url":"https://github.com/devantler-tech.png","language":"Go","funding_links":["https://github.com/sponsors/devantler"],"categories":["Go"],"sub_categories":[],"readme":"\u003c!-- mcp-name: io.github.devantler-tech/ksail --\u003e\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[![Go Report Card](https://goreportcard.com/badge/github.com/devantler-tech/ksail/v7)](https://goreportcard.com/report/github.com/devantler-tech/ksail/v7)\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:** \u003chttps://ksail.devantler.tech\u003e\n\n## Quick Install\n\n```bash\n# macOS / Linux (Homebrew)\nbrew install --cask devantler-tech/tap/ksail\n\n# Go (1.26.1+)\ngo install github.com/devantler-tech/ksail/v7@latest\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://docs.claude.com/en/docs/claude-code/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 cluster 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 \u0026 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 \u0026 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\u003ca href=\"https://www.star-history.com/#devantler-tech/ksail\u0026type=timeline\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=devantler-tech/ksail\u0026type=timeline\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=devantler-tech/ksail\u0026type=timeline\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=devantler-tech/ksail\u0026type=timeline\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevantler-tech%2Fksail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevantler-tech%2Fksail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevantler-tech%2Fksail/lists"}