First steps

Boot. Freeze. Wake.

Check that everything is fine

kling doctor

Every ✗ comes with its fix. It exits with 1 only when something fails, so it works in scripts.

A throwaway sandbox

kling try -- uname -a           # creates, runs, returns the exit code and deletes
kling try -image toolchain      # no command: a shell that is deleted when you leave

A machine’s lifecycle

kling run -name mcp-demo
kling freeze mcp-demo
kling ps
kling thaw mcp-demo

Output

efad9e5f7003  mcp-demo  booted cold in 54 ms
efad9e5f7003  warm  (754 ms, 256 MiB on disk)
ID             NAME       IMAGE     STATE   CPU/MEM    DISK   EGRESS   AGE   LAST OP
efad9e5f7003   mcp-demo   default   warm    1/256MiB   81M    none     17s   freeze 754ms, 256MiB
efad9e5f7003  running  (22 ms)

Frozen, the machine uses no CPU and no RAM. It wakes up in tens of milliseconds.

When something fails

Every error comes with a second try: … line with the next command to run.

kling help run          # help for a single command
kling logs -f <machine> # the serial console
kling version           # CLI and daemon

In the repo: README: quick start · docs/hallazgos.md