How juan52878911/kindling works
kindling runs isolated microVMs, using Firecracker on Linux or Virtualization.framework on macOS. The main workflow is a user invoking kling, which sends machine operations through the API to the daemon’s machine manager and then to a VMM. The repository also includes separately installable MCP, sandbox, database, and Android-phone extensions, plus an AI gateway. Some extension links and backend details are documented rather than visible in sampled source, so those relationships cite the README; unsampled implementation links are omitted.
Main entry points: manager.go Machine Manager · server.go Daemon API · main.go MCP Extension · client.go API Client
Components 22
CLI and API
- kling CLI
cmd/kling/main.go - API Client
pkg/api/client.go
Machine Runtime
- Daemon API
internal/daemon/server.go - Authorization
internal/daemon/authz.go - Machine Manager
internal/machine/manager.go - Machine State
internal/machine - Shared Folders
internal/share/server.go
VM Backends
- Firecracker Backend
internal/fc/client.go - macOS VMM
vz/internal/server/server.go
Product Extensions
- MCP Extension
ext/mcp/cmd/kling-mcp/main.go - MCP Gateway
ext/mcp/internal/gateway/router.go - MCP Bridge
ext/mcp/cmd/kling-bridge/main.go - Sandbox Extension
ext/sandbox/cmd/kling-sandbox/main.go - Sandbox Operator
ext/sandbox/internal/operator/controller.go - Database Extension
ext/db/cmd/kling-db/app.go - Database Engines
ext/db/cmd/kling-db/engines.go - Android Phone Extension
ext/phone/cmd/kling-phone/main.go
AI Gateway
- AI Gateway
pkg/aigw/server.go - Learning Review
pkg/aigw/learn_review.go - Chispa Models
pkg/chispa
Other components
- CLI User
- MicroVM Guest
Connections 21
- CLI User → kling CLI: invokes
README.md - kling CLI → API Client: uses API
cmd/kling/main.go - API Client → Daemon API: HTTP over socket
README.md - Daemon API → Authorization: authorizes
internal/daemon/server.go - Daemon API → Machine Manager: dispatches
internal/daemon/server.go - Machine Manager → Machine State: persists
internal/machine/manager.go - Machine Manager → Firecracker Backend: uses backend
internal/machine/manager.go - Machine Manager → macOS VMM: uses on macOS
README.md - MicroVM Guest → Shared Folders: accesses shares
internal/share/server.go - CLI User → MCP Extension: uses extension
README.md - MCP Extension → MCP Gateway: provides gateway
ext/mcp/cmd/kling-mcp/main.go - MCP Gateway → API Client: uses API
ext/mcp/internal/gateway/router.go - MCP Extension → MCP Bridge: bridges guest server
- CLI User → Sandbox Extension: uses extension
README.md - Sandbox Extension → Sandbox Operator: runs operator
- CLI User → Database Extension: uses extension
README.md - Database Extension → Database Engines: selects engine
ext/db/cmd/kling-db/engines.go - CLI User → Android Phone Extension: uses extension
README.md - CLI User → AI Gateway: sends AI requests
- AI Gateway → Learning Review: serves review
- Learning Review → Chispa Models: uses models
pkg/aigw/learn_review.go