Koala 项目主页介绍，这款工具可在 Apple 芯片 Mac 上，以 ARM64 Linux 虚拟机运行任务、服务、开发环境和 AI agent，每台虚拟机都有独立的内核、磁盘和网络。它针对不可信工作负载提供隔离与访问控制：agent 的 API 密钥留在 Mac 上，由 broker 按策略为请求添加，密钥本身不进入虚拟机。
据项目主页，Koala 将虚拟机内部的一切视为不可信，并在 Mac 端检查访问权限。默认情况下，虚拟机无法访问 Mac 上的文件、秘密信息、本机服务或局域网；互联网访问仅限公网地址，也可以关闭。v0.1 尚不支持虚拟机之间互通。
用户可以明确授予部分资源的访问权限。例如，共享文件夹默认只读，需要读写权限时再指定；访问 Mac 本机服务或局域网时，需要限定地址或网段及端口。
针对 agent 的 API 密钥，Koala 使用 macOS 登录钥匙串保存，由 broker 仅向策略允许的请求添加密钥。项目页同时区分了普通秘密信息的授权方式：指定的秘密信息可以作为文件或环境变量提供给单台虚拟机。
Koala 支持在全新虚拟机中执行一次性命令，命令结束后删除虚拟机。项目页将构建、测试及不希望直接在 Mac 上运行的脚本列为使用场景。需要持续运行的服务和开发环境则可使用常驻虚拟机，关闭终端后仍能运行，并支持执行命令、进入交互式 shell，以及拷入、拷出文件。
agent 也可通过模板创建。执行 koala create hermes --template hermes 后，工具会先展示计划，再创建 agent 的虚拟机、密钥策略、存储卷和初始化步骤。
镜像方面，Koala 支持来自 Docker Hub 或私有仓库的 OCI 镜像，并在创建虚拟机时按摘要锁定。Lean 模式通过最小化的初始化程序运行单个镜像；Full 模式则运行带有 systemd 和 Docker Engine 的 Ubuntu 24.04。
项目主页标注的当前版本为 0.1.0-preview.11。使用需要 Apple 芯片 Mac、macOS 26 或更新版本，以及为 linux/arm64 构建的镜像。
安装依次执行 brew install kunalkushwaha/koala/koala 和 koala system install，无需 sudo。虚拟机由每用户的 launchd 管理进程管理，没有系统级 root 守护进程。不过，常驻虚拟机仅能在关闭终端后继续运行；用户注销或重启 Mac 后，虚拟机不会继续运行。
