docs: revert default agent working directory to /home/user (#1506)

Revert the /workspace default-pwd change in docs + examples back to /home/user
(including mount-path examples). Clarify in the filesystem doc that /home/user
is the agent's home directory and default pwd.

Author: NathanFlurry

examples/docs/filesystem/server.ts

@@ -5,7 +5,7 @@ import pi from "./software/pi";
 const vm = agentOS({
   software: [pi],
   mounts: [
-    { path: "/workspace/scratch", driver: createInMemoryFileSystem() },
+    { path: "/home/user/scratch", driver: createInMemoryFileSystem() },
   ],
 });
 

examples/docs/sandbox/client.ts

@@ -4,17 +4,17 @@ import type { registry } from "./server";
 const client = createClient<typeof registry>({ endpoint: "http://localhost:6420" });
 const vm = client.vm.getOrCreate("my-agent");
 
-// Write code via the filesystem. The /workspace/sandbox mount maps to the sandbox root.
-await vm.writeFile("/workspace/sandbox/app/index.ts", 'console.log("hello")');
+// Write code via the filesystem. The /home/user/sandbox mount maps to the sandbox root.
+await vm.writeFile("/home/user/sandbox/app/index.ts", 'console.log("hello")');
 
 // Run it inside the sandbox. Commands execute through the VM's process table,
 // reading the file from the mounted directory.
-const result = await vm.exec("node /workspace/sandbox/app/index.ts");
+const result = await vm.exec("node /home/user/sandbox/app/index.ts");
 console.log(result.stdout); // "hello\n"
 
 // Call a mounted binding from the client. The sandbox bindings are exposed inside
 // the VM as a CLI command, so you invoke it through the same exec/spawn surface.
-const install = await vm.exec("agentos-sandbox run-command --command \"npm install\" --cwd /workspace/sandbox/app");
+const install = await vm.exec("agentos-sandbox run-command --command \"npm install\" --cwd /home/user/sandbox/app");
 console.log(install.exitCode, install.stdout);
 
 // Spawn a long-running process via the bindings and stream its output.

examples/docs/sandbox/server.ts

@@ -12,7 +12,7 @@ const sandbox = await SandboxAgent.start({ sandbox: docker() });
 // process management as bindings.
 const vm = agentOS({
 	mounts: [
-		{ path: "/workspace/sandbox", plugin: createSandboxFs({ client: sandbox }) },
+		{ path: "/home/user/sandbox", plugin: createSandboxFs({ client: sandbox }) },
 	],
 	bindings: [createSandboxBindings({ client: sandbox })],
 });

website/.astro/data-store.json

@@ -548,15 +548,15 @@ const terminalLines: TermLine[] = [
 	{ text: '  v0.1.0  |  runtime ready', color: 'text-cream/45', delay: 1400 },
 	{ text: '', delay: 1600 },
 	{ text: '✓ V8 isolate pool initialized (12 workers)', color: 'text-cream/70', delay: 1800 },
-	{ text: '✓ File system mounted → /workspace', color: 'text-cream/70', delay: 2100 },
+	{ text: '✓ File system mounted → /home/user', color: 'text-cream/70', delay: 2100 },
 	{ text: '✓ Tool registry loaded (git, curl, python, node)', color: 'text-cream/70', delay: 2400 },
 	{ text: '✓ Network policy applied → allowlist mode', color: 'text-cream/70', delay: 2700 },
 	{ text: '', delay: 3000 },
 	{ text: '● Agent session created  sid=a8f3c2e1', color: 'text-cream/85', delay: 3200 },
 	{ text: '  → Claude Code connected', color: 'text-cream/55', delay: 3500 },
 	{ text: '  → Prompt: "Set up a Next.js app with auth"', color: 'text-cream/55', delay: 3800 },
 	{ text: '', delay: 4100 },
-	{ text: '  ▸ agent  npm create next-app@latest /workspace/app', color: 'text-cream/70', delay: 4400 },
+	{ text: '  ▸ agent  npm create next-app@latest /home/user/app', color: 'text-cream/70', delay: 4400 },
 	{ text: '  ▸ agent  npm install next-auth@5 prisma @prisma/client', color: 'text-cream/70', delay: 5000 },
 	{ text: '  ▸ agent  Writing 7 files...', color: 'text-cream/70', delay: 5600 },
 	{ text: '  ▸ agent  npx prisma db push', color: 'text-cream/70', delay: 6200 },

website/src/components/marketing/solutions/AgentOSPage.tsx

@@ -29,15 +29,15 @@ async function reviewCode(code: string): Promise<string> {
   const reviewerHandle = client.reviewer.getOrCreate("my-project");
 
   // Write the submitted contents into the reviewer's VM.
-  await reviewerHandle.writeFile("/workspace/review.ts", code);
+  await reviewerHandle.writeFile("/home/user/review.ts", code);
 
   // Ask the reviewer to review.
   const session = await reviewerHandle.createSession("claude", {
     env: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },
   });
   const result = await reviewerHandle.sendPrompt(
     session.sessionId,
-    "Review the code at /workspace/review.ts and list any issues.",
+    "Review the code at /home/user/review.ts and list any issues.",
   );
   await reviewerHandle.closeSession(session.sessionId);
 

website/src/content/docs/docs/agent-to-agent.mdx

@@ -394,7 +394,7 @@ registry.start();
 
 ### Filesystem
 
-Read, write, and manage files inside the VM. The `/workspace` directory is persisted automatically across sleep/wake cycles.
+Read, write, and manage files inside the VM. The `/home/user` directory is persisted automatically across sleep/wake cycles.
 
 <CodeGroup>
 ```ts title="client.ts"
@@ -405,14 +405,14 @@ const client = createClient<typeof registry>({ endpoint: "http://localhost:6420"
 const agent = client.vm.getOrCreate("my-agent");
 
 // Write a file
-await agent.writeFile("/workspace/config.json", JSON.stringify({ key: "value" }));
+await agent.writeFile("/home/user/config.json", JSON.stringify({ key: "value" }));
 
 // Read a file
-const content = await agent.readFile("/workspace/config.json");
+const content = await agent.readFile("/home/user/config.json");
 console.log(new TextDecoder().decode(content));
 
 // List directory contents recursively
-const files = await agent.readdirRecursive("/workspace", { maxDepth: 2 });
+const files = await agent.readdirRecursive("/home/user", { maxDepth: 2 });
 console.log(files);
 ```
 
@@ -454,7 +454,7 @@ conn.on("processOutput", (data) => {
   console.log(`[pid ${data.pid}]`, new TextDecoder().decode(data.data));
 });
 
-const { pid } = await agent.spawn("node", ["/workspace/server.js"]);
+const { pid } = await agent.spawn("node", ["/home/user/server.js"]);
 console.log("Process ID:", pid);
 ```
 
@@ -571,7 +571,7 @@ const vm = agentOS({
   bindings: [createSandboxBindings({ client: sandbox })],
   // Mounts let the agent read the sandbox filesystem (optional)
   mounts: [
-    { path: "/workspace/sandbox", plugin: createSandboxFs({ client: sandbox }) },
+    { path: "/home/user/sandbox", plugin: createSandboxFs({ client: sandbox }) },
   ],
 });
 

website/src/content/docs/docs/crash-course.mdx

@@ -26,7 +26,7 @@ const vm = agentOS({
   software: [pi],
   mounts: [
     {
-      path: "/workspace/repo",
+      path: "/home/user/repo",
       plugin: { id: "host_dir", config: { hostPath: "/path/to/repo" } },
       readOnly: true,
     },
@@ -55,7 +55,7 @@ const vm = agentOS({
   software: [pi],
   mounts: [
     {
-      path: "/workspace/data",
+      path: "/home/user/data",
       plugin: {
         id: "s3",
         config: {
@@ -90,7 +90,7 @@ const vm = agentOS({
   software: [pi],
   mounts: [
     {
-      path: "/workspace/drive",
+      path: "/home/user/drive",
       plugin: {
         id: "google_drive",
         config: {
@@ -123,7 +123,7 @@ import pi from "@agentos-software/pi";
 const vm = agentOS({
   software: [pi],
   mounts: [
-    { path: "/workspace/scratch", driver: createInMemoryFileSystem() },
+    { path: "/home/user/scratch", driver: createInMemoryFileSystem() },
   ],
 });
 
@@ -151,10 +151,10 @@ const client = createClient<typeof registry>({ endpoint: "http://localhost:6420"
 const agent = client.vm.getOrCreate("my-agent");
 
 // Write a file (string or Uint8Array)
-await agent.writeFile("/workspace/hello.txt", "Hello, world!");
+await agent.writeFile("/home/user/hello.txt", "Hello, world!");
 
 // Read a file (returns Uint8Array)
-const content = await agent.readFile("/workspace/hello.txt");
+const content = await agent.readFile("/home/user/hello.txt");
 console.log(new TextDecoder().decode(content));
 ```
 
@@ -165,14 +165,14 @@ console.log(new TextDecoder().decode(content));
 ```ts
 // Batch write (creates parent directories automatically)
 const writeResults = await agent.writeFiles([
-  { path: "/workspace/src/index.ts", content: "console.log('hello');" },
-  { path: "/workspace/src/utils.ts", content: "export function add(a: number, b: number) { return a + b; }" },
+  { path: "/home/user/src/index.ts", content: "console.log('hello');" },
+  { path: "/home/user/src/utils.ts", content: "export function add(a: number, b: number) { return a + b; }" },
 ]);
 
 // Batch read
 const readResults = await agent.readFiles([
-  "/workspace/src/index.ts",
-  "/workspace/src/utils.ts",
+  "/home/user/src/index.ts",
+  "/home/user/src/utils.ts",
 ]);
 for (const result of readResults) {
   console.log(result.path, new TextDecoder().decode(result.content ?? new Uint8Array()));
@@ -183,13 +183,13 @@ for (const result of readResults) {
 
 ```ts
 // Create a directory
-await agent.mkdir("/workspace/projects");
+await agent.mkdir("/home/user/projects");
 
 // List directory contents
-const entries = await agent.readdir("/workspace/projects");
+const entries = await agent.readdir("/home/user/projects");
 
 // Recursive listing with metadata
-const tree = await agent.readdirRecursive("/workspace", {
+const tree = await agent.readdirRecursive("/home/user", {
   maxDepth: 3,
   exclude: ["node_modules"],
 });
@@ -202,24 +202,24 @@ for (const entry of tree) {
 
 ```ts
 // Check if a path exists
-const fileExists = await agent.exists("/workspace/hello.txt");
+const fileExists = await agent.exists("/home/user/hello.txt");
 
 // Get file metadata
-const info = await agent.stat("/workspace/hello.txt");
+const info = await agent.stat("/home/user/hello.txt");
 console.log(info.size, info.isDirectory, info.mtimeMs);
 ```
 
 ### Move and delete
 
 ```ts
 // Move/rename
-await agent.move("/workspace/old.txt", "/workspace/new.txt");
+await agent.move("/home/user/old.txt", "/home/user/new.txt");
 
 // Delete a file
-await agent.delete("/workspace/new.txt");
+await agent.delete("/home/user/new.txt");
 
 // Delete a directory recursively
-await agent.delete("/workspace/temp", { recursive: true });
+await agent.delete("/home/user/temp", { recursive: true });
 ```
 
 *[See Full Example](https://github.com/rivet-dev/agent-os/tree/main/examples/docs/filesystem)*
@@ -234,7 +234,7 @@ const vm = agentOS({
   permissions: {
     fs: {
       default: "allow",
-      rules: [{ mode: "deny", operations: ["*"], paths: ["/workspace/secrets/**"] }],
+      rules: [{ mode: "deny", operations: ["*"], paths: ["/home/user/secrets/**"] }],
     },
   },
 });
@@ -250,7 +250,7 @@ For heavier or untrusted workloads, run a full Linux [sandbox](/docs/sandbox) al
 
 With no `mounts` configured, every VM boots an Alpine-based root filesystem with the standard POSIX directories:
 
-- `/workspace`: the agent's default working directory and `pwd` when spawned, where it reads and writes (mounts land under it, e.g. `/workspace/data`).
+- `/home/user`: the agent's home directory (`$HOME`) and default working directory (`pwd`) when spawned, where it reads and writes (mounts land under it, e.g. `/home/user/data`).
 - `/bin`, `/sbin`, `/usr`: installed commands (common POSIX utilities by default, plus any [software](/docs/software) you add).
 - `/etc`, `/lib`, `/opt`, `/root`, `/run`, `/srv`, `/tmp`, `/var`, `/mnt`: standard system paths.
 

website/src/content/docs/docs/filesystem.mdx

@@ -89,23 +89,23 @@ There is no typed `"ask"` mode. Interactive, human-in-the-loop approval lives in
 For finer control, a scope can be a rule set instead of a bare mode: a `default` mode plus an ordered list of `rules`. The `fs` scope matches by `paths` (filesystem globs). Each rule names its `operations` (`read`, `write`, `stat`, `readdir`, `create_dir`, `rm`, `rename`, `symlink`, `readlink`, `chmod`, `truncate`, `mount_sensitive`, or `["*"]` for all). Last matching rule wins; if no rule matches, `default` applies.
 
 ```ts
-// Allow the filesystem everywhere, but deny anything under /workspace/vault.
+// Allow the filesystem everywhere, but deny anything under /home/user/vault.
 const denyVault = {
 	fs: {
 		default: "allow",
-		rules: [{ mode: "deny", operations: ["*"], paths: ["/workspace/vault/**"] }],
+		rules: [{ mode: "deny", operations: ["*"], paths: ["/home/user/vault/**"] }],
 	},
 };
 ```
 
 To invert it, flip `default` to `"deny"` and allow just one subtree:
 
 ```ts
-// Deny the filesystem by default, allow only reads under /workspace/data.
+// Deny the filesystem by default, allow only reads under /home/user/data.
 const allowOnlyData = {
 	fs: {
 		default: "deny",
-		rules: [{ mode: "allow", operations: ["read", "readdir", "stat"], paths: ["/workspace/data/**"] }],
+		rules: [{ mode: "allow", operations: ["read", "readdir", "stat"], paths: ["/home/user/data/**"] }],
 	},
 };
 ```

website/src/content/docs/docs/permissions.mdx

@@ -54,7 +54,7 @@ const vm = agentOS({
 	bindings: [createSandboxBindings({ client: sandbox })],
 	// Mounts let the agent read the sandbox filesystem (optional)
 	mounts: [
-		{ path: "/workspace/sandbox", plugin: createSandboxFs({ client: sandbox }) },
+		{ path: "/home/user/sandbox", plugin: createSandboxFs({ client: sandbox }) },
 	],
 });
 
@@ -76,17 +76,17 @@ import type { registry } from "./server";
 const client = createClient<typeof registry>({ endpoint: "http://localhost:6420" });
 const vm = client.vm.getOrCreate("my-agent");
 
-// Write code via the filesystem. The /workspace/sandbox mount maps to the sandbox root.
-await vm.writeFile("/workspace/sandbox/app/index.ts", 'console.log("hello")');
+// Write code via the filesystem. The /home/user/sandbox mount maps to the sandbox root.
+await vm.writeFile("/home/user/sandbox/app/index.ts", 'console.log("hello")');
 
 // Run it inside the sandbox. Commands execute through the VM's process table,
 // reading the file from the mounted directory.
-const result = await vm.exec("node /workspace/sandbox/app/index.ts");
+const result = await vm.exec("node /home/user/sandbox/app/index.ts");
 console.log(result.stdout); // "hello\n"
 
 // Call a mounted binding from the client. The sandbox bindings are exposed inside the
 // VM as a CLI command, so you invoke it through the same exec/spawn surface.
-const install = await vm.exec("agentos-sandbox run-command --command \"npm install\" --cwd /workspace/sandbox/app");
+const install = await vm.exec("agentos-sandbox run-command --command \"npm install\" --cwd /home/user/sandbox/app");
 console.log(install.exitCode, install.stdout);
 
 // Spawn a long-running process via the bindings and stream its output.