Host Directory

File System

Project a real host directory into the VM, Docker-style. The guest sees only the mounted subtree, never the wider host filesystem.

Configuration

Built into the SDK — no separate install. Enable it with plugin: { id: "host_dir" } in your VM config.

import { agentOS, setup } from "@rivet-dev/agentos";
import pi from "@agentos-software/pi";
 
const vm = agentOS({
  software: [pi],
  mounts: [
    {
      path: "/home/agentos/repo",
      plugin: { id: "host_dir", config: { hostPath: "/path/to/repo" } },
      readOnly: true,
    },
  ],
});
 
export const registry = setup({ use: { vm } });

View documentation