https://github.com/kloudlite/kloudlite
RemoteLocal Environments to build distributed applications.
https://github.com/kloudlite/kloudlite
dev-environment remotelocal
Last synced: 4 days ago
JSON representation
RemoteLocal Environments to build distributed applications.
- Host: GitHub
- URL: https://github.com/kloudlite/kloudlite
- Owner: kloudlite
- License: agpl-3.0
- Created: 2024-02-06T08:06:47.000Z (about 2 years ago)
- Default Branch: development
- Last Pushed: 2026-01-31T20:38:21.000Z (13 days ago)
- Last Synced: 2026-01-31T22:31:18.999Z (13 days ago)
- Topics: dev-environment, remotelocal
- Language: Go
- Homepage: http://kloudlite.io
- Size: 89.9 MB
- Stars: 160
- Watchers: 1
- Forks: 4
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Cloud Development Environments
Test against live services without deploying
## What is Kloudlite?
Kloudlite provides cloud-based development workspaces with live service connectivity. Think Telepresence meets cloud IDEs — but with per-developer environment ownership, instant environment switching, and cross-team collaboration built in.
Your code runs against real services. No container builds. No deployments. No waiting.
## The Inner Loop Problem
The traditional development cycle — code, build, deploy, test — takes minutes per iteration. Most of that time is spent waiting for builds and deployments, not actually validating changes.
Kloudlite eliminates build and deploy from your inner loop. You write code in a cloud workspace that's already connected to your services. Changes are testable immediately. The feedback loop drops from minutes to seconds.
## Core Concepts
**Workspace** — A container running on your work machine with your dev tools installed. Accessible via SSH, VS Code Server, or web terminal. Mounts code from the host filesystem. Multiple workspaces share system volumes for efficiency.
**Environment** — An isolated namespace containing your services, databases, and configurations. You own your environments — create as many as you need for different features or experiments. Switch your workspace between them instantly.
**Intercept** — Routes traffic from any service in your environment to your workspace. Debug with production-like traffic patterns. Validate fixes before pushing.
**Tunnel** — WireGuard-based connection from your local machine to your work machine via `kltun`. All services become DNS-resolvable locally. Your IDE connects over this tunnel.
## Architecture
```
┌──────────────────────────────────────────────────────────────────────────────┐
│ Kubernetes Cluster (Team) │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ Control Plane │ │
│ │ API Server ◄───► Dashboard ◄───► Kubernetes Controllers │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────┐ ┌──────────────────────────┐ │
│ │ Work Machine (Dev A) │ │ Work Machine (Dev B) │ ... │
│ │ │ │ │ │
│ │ ┌────────────────────┐ │ │ ┌────────────────────┐ │ │
│ │ │ Namespace: dev-a │ │ │ │ Namespace: dev-b │ │ │
│ │ │ ┌─────────────┐ │ │ │ │ ┌─────────────┐ │ │ │
│ │ │ │ Workspace 1 │ │ │ │ │ │ Workspace 1 │ │ │ │
│ │ │ │ Workspace 2 │ │ │ │ │ │ Workspace 2 │ │ │ │
│ │ │ └─────────────┘ │ │ │ │ └─────────────┘ │ │ │
│ │ └────────────────────┘ │ │ └────────────────────┘ │ │
│ │ │ │ │ │
│ │ ┌────────────────────┐ │ │ ┌────────────────────┐ │ │
│ │ │ Env: dev-a-feature │ │ │ │ Env: dev-b-feature │ │ │
│ │ │ (services, DBs) │ │ │ │ (services, DBs) │ │ │
│ │ └────────────────────┘ │ │ └────────────────────┘ │ │
│ └──────────────────────────┘ └──────────────────────────┘ │
│ │
│ All nodes can reach any environment — collaborate across teams │
└──────────────────────────────────────────────────────────────────────────────┘
▲ ▲
│ WireGuard (kltun) │ WireGuard (kltun)
▼ ▼
┌───────────────┐ ┌───────────────┐
│ Dev A Local │ │ Dev B Local │
│ (IDE, CLI) │ │ (IDE, CLI) │
└───────────────┘ └───────────────┘
```
**Work Machine** — Dedicated node per developer in the cluster. Runs your workspaces and environments.
**Workspaces** — Containers in your namespace. Share host volumes for code and system packages. Include:
- Nix package management (`kl pkg add go@1.21 nodejs python3`)
- IDE integration (SSH, VS Code Server, Web Terminal)
- Mounted workspace folders from host
**Environments** — Isolated namespaces with your services. Each developer owns their environments. Connect to any team member's environment for debugging or collaboration.
## Capabilities
| Feature | Description |
|---------|-------------|
| **Service Interception** | Route traffic from any service to your workspace for live debugging |
| **Multi-Environment** | Own multiple environments, switch between them without rebuilds |
| **Cross-Team Access** | Connect to any environment in the cluster for collaboration |
| **Nix Packages** | `kl pkg add go@1.21 nodejs` — reproducible, conflict-free |
| **Port Exposure** | Public URLs for webhooks, OAuth callbacks, external testing |
| **MCP Server** | AI tools (Claude, Codex, OpenCode) control workspace via `kl mcp` |
## Project Structure
```
api/
├── cmd/server/ # Control plane API server
├── cmd/kl/ # CLI (runs inside workspace)
├── cmd/workmachine-node-manager/ # Host-level Nix package management
├── internal/controllers/ # K8s controllers
│ ├── workspace/ # Workspace lifecycle
│ ├── environment/ # Environment management
│ └── serviceintercept/ # Traffic interception
└── manifests/ # CRDs and RBAC
web/ # Next.js dashboard
devenv/ # Local K3s development setup
```
**Stack:** Go 1.24, controller-runtime, Kubernetes CRDs, WireGuard, Nix, Next.js 15, React 19
## Getting Started
- **Self-host:** Deploy on AWS, GCP, or Azure — [Installation Guide](https://kloudlite.io/docs/install)
- **Documentation:** [kloudlite.io/docs](https://kloudlite.io/docs)
- **CLI Reference:** [kloudlite.io/docs/cli](https://kloudlite.io/docs/cli)
- **Helm Charts:** [github.com/kloudlite/helm-charts](https://github.com/kloudlite/helm-charts)
## Community
- [Discord](https://discord.com/invite/m5tYzQfcG8)
- [Twitter](https://x.com/kloudlite)
- [GitHub Issues](https://github.com/kloudlite/kloudlite/issues)
Security issues: **security@kloudlite.io**
## License
[AGPL-3.0](LICENSE)