Skip to content

kdn

codecov Documentation

kdn is a command-line interface for launching and managing AI agents in isolated, reproducible workspaces. It creates runtime-based environments (containers, VMs, or other backends) where agents run with your project source code mounted, automatically configured and ready to use — no manual onboarding or setup required.

The architecture is built around pluggable runtimes. The first supported runtime is Podman, which creates container-based workspaces using a custom Fedora image. Additional runtimes (e.g., MicroVM, Kubernetes) can be added to support other execution environments.

Supported Agents

  • Claude Code - Anthropic's official CLI for Claude
  • Goose - AI agent for development tasks
  • Cursor - AI-powered code editor agent

Key Features

  • Isolated workspaces per project, each running in its own runtime instance
  • Pluggable runtime system — Podman is the default, with support for adding other runtimes
  • Automatic agent configuration (onboarding flags, trusted directories) on workspace creation
  • Multi-level configuration: workspace, global, project-specific, and agent-specific settings
  • Inject environment variables and mount directories into workspaces at multiple scopes
  • Connect to MCP servers and integrate with various LLM providers (including Vertex AI)
  • Consistent CLI interface across different agent types and runtimes