Core
Core AgentOs API: exec, config reference, lifecycle events, and mounts.
The core @rivet-dev/agentos-core API surface in one place: boot a VM with
AgentOs.create() and drive it directly for exec, filesystem, processes, agent
sessions, networking, and cron — no actor runtime and no client/server split.
Reach for this when you want a reference of what an AgentOs instance can do and
how it is configured.
How it works
AgentOs.create({ ... }) boots a VM in-process with its mounts, software, and
network settings, and returns an AgentOs instance. Everything runs through that
instance: exec/spawn for processes, readFile/writeFiles/readdirRecursive
for the filesystem, createSession/prompt for agents, fetch for in-VM
servers, and scheduleCron for jobs. Process output and session/permission/cron
events are delivered through callbacks (spawn({ onStdout }), onProcessExit,
onSessionEvent, onPermissionRequest, onCronEvent).
vm.ts— boot a VM and every instance capability (exec, filesystem, processes, sessions, networking, cron).advanced.ts— pin VMs to a dedicated sidecar process.config-reference.ts— the fullAgentOs.create()config surface.hooks.ts— per-session event and permission observation.mounts.ts— host-directory and S3 mount descriptors.
Run it
npm install
npx tsx vm.ts