# libracoder/kiri

> kiri is a container runtime for macOS, Windows and Linux that runs Docker images and works with the docker CLI, Compose and buildx that developers already use. On macOS and Windows it runs containers inside one small Linux VM, and on Linux it runs them directly on the kernel. It exposes the Docker Engine API, so existing tools connect to it without changes. The project is written in Rust.

Source: https://github.com/libracoder/kiri
Indexed: commit ac82581 on 2026-11-21 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Rust
- Stars: 12,180 at index time
- License: Apache-2.0
- Code health: 6.2/10, Fair
- Last commit: 2026-11-20
- Contributors: 35

## Install

From the README: https://github.com/libracoder/kiri#quick-start

On macOS, install Kiri with Homebrew.
    brew install --cask libracoder/kiri/kiri

Run your first container through the kiri Docker context.
    docker --context kiri run --rm alpine echo hello

## How it works

The docker CLI, Compose and buildx send requests through the Docker Engine API to the kiri daemon, whose API handling is in crates/kiri/src/daemon/api.rs. The daemon's core logic sits in crates/kiri/src/daemon/engine.rs, and the daemon owns the VM. It talks to the guest over vsock using the message types defined in crates/kiri-proto/src/lib.rs. Inside the VM, the guest agent that runs as PID 1, built from crates/kiri-init/src/main.rs, starts each container with a single clone3 call into namespaces and a cgroup. The project does not use runc, a shim or dockerd, and xtask builds the macOS app bundle with the guest kernel and disk template inside it.

- crates/kiri-image/src/lib.rs: entry point
- crates/kiri-init/src/main.rs: entry point
- crates/kiri-proto/src/lib.rs: entry point
- crates/kiri-share-proto/src/lib.rs: entry point
- crates/kiri-vmm/src/lib.rs: entry point
Modules: crates, tests, scripts, bench, packaging, xtask, contrib, brand. 435 files, 93,607 lines, 9,869 symbols.

## Code health

- Score: 6.2/10 (Fair)
- Rank: #207 of 4,000+ indexed repos
- Hotspots: crates/kiri/src/daemon/api.rs, crates/kiri/src/daemon/engine.rs, crates/kiri-init/src/linux/container.rs, crates/kiri-init/src/linux/agent.rs, crates/kiri/src/import.rs
- Lowest file: crates/kiri/src/ui/xterm/xterm.js
- Dead code: none found

## Maintenance

- Last commit 2026-11-20, first commit 2026-11-02, 212 commits
- 35 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/libracoder/kiri/security

## More

- Page: https://repowise.dev/repo/libracoder/kiri
- Ask this codebase: https://repowise.dev/repo/libracoder/kiri/chat
- Docs: https://repowise.dev/repo/libracoder/kiri/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/libracoder/kiri
