Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings
Open more actions menu

Repository files navigation

Cloud Development Environments

Test against live services without deploying

Discord License Go Report Card Issues GitHub Release

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

cli/
├── server/                        # Control plane API server
├── kl/                            # CLI (runs inside workspace)
└── workmachine-node-manager/      # Host-level Nix package management

controllers/                       # K8s controllers
├── workspace/                     # Workspace lifecycle
└── environment/                   # Environment management

api/                               # Backend API domain packages
pkg/                               # Reusable Go packages
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

Community

Security issues: security@kloudlite.io

License

AGPL-3.0

About

RemoteLocal Environments to build distributed applications.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.