- repo/—
- memory/—
- PLAN.md2.1 KB
- notes.md840 B
Give every agent its own disk.
A disk per user, session, or task, mounted in your sandboxes or ours.
~100 ms
to mount a disk on demand
Sandboxes and durable disks for AI. Run code on demand, keep files between calls, and share data across your stack.
// Install: ai@7 disk @archildata/ai-sdk// Set ARCHIL_API_KEY, ARCHIL_REGION, and AI_GATEWAY_API_KEY.import { generateText, isStepCount } from "ai";import * as archil from "disk";import { createDiskTools } from "@archildata/ai-sdk"; const { disk: agentDisk } = await archil.createDisk({ name: "agent-workspace" }); // Give the agent your whole filesystem as toolsawait generateText({ model: "anthropic/claude-sonnet-4.6", prompt: "Write a short story, format it nicely and save it as story.pdf", tools: createDiskTools(agentDisk), stopWhen: isStepCount(30),}); // Read the saved file after the agent finishesconst story = await agentDisk.getObject("story.pdf");import * as archil from "disk"; const { disk } = await archil.createDisk({ name: "analytics" }); // Call 1: write a small CSV to the diskawait disk.exec("printf 'region,revenue\\nwest,120\\neast,95\\nwest,80\\n' > /mnt/archil/sales.csv"); // Call 2: a fresh container summarizes it with stdlib Pythonconst { stdout } = await disk.exec(`python3 - <<'EOF'import csvfrom collections import Countertotals = Counter()for row in csv.DictReader(open("/mnt/archil/sales.csv")): totals[row["region"]] += int(row["revenue"])print(dict(totals))EOF`); // Example stdout: {'west': 200, 'east': 95}import * as archil from "disk"; // Prerequisites: ARCHIL_API_KEY in your CI secrets, an existing disk,// and a repository the exec container can clone. Steps run for up to 5 min.const disk = await archil.getDisk("dsk-abc123");const checkout = `/mnt/archil/build-${crypto.randomUUID()}`; // Step 1: clone and build in a fresh containerconst build = await disk.exec( `git clone https://github.com/your-org/app.git ${checkout} && cd ${checkout} && npm ci && npm run build`);if (build.exitCode !== 0) throw new Error(build.stderr); // Step 2: a later step tests the same checkout, already on the diskconst test = await disk.exec(`cd ${checkout} && npm test`);if (test.exitCode !== 0) throw new Error(test.stderr);# Prerequisite: an existing disk, "training-data", that already holds# your dataset, and a mount token for that disk. # On your own GPU host: install the clientcurl -s https://archil.com/install | sh # Mount the dataset read-onlysudo mkdir -p /mnt/training-dataexport ARCHIL_MOUNT_TOKEN="<disk-token>"sudo --preserve-env=ARCHIL_MOUNT_TOKEN archil mount training-data /mnt/training-data \ --region aws-us-east-1 --read-only # Your training job reads it like any local directoryls /mnt/training-dataEach call runs Bash, Python, or Node against the disk on demand, and the files it writes are there for the next call. No sandbox to manage.
Build a bash toolNeed a preview server or a long-lived process? Use a persistent sandbox
rg "renewal" contracts/ > matches.txtqueuedpython summarize.py matches.txtqueuednode publish.mjs summary.jsonqueuedFiles kept between calls· matches.txt, summary.json
“They approached sandboxes from the perspective of data, not compute — and it's beautiful. This is serious engineering.”

A disk per user, session, or task, mounted in your sandboxes or ours.
~100 ms
to mount a disk on demand
A shared SSD cache in front of your bucket feeds every node at local speed.
10 GB/s
default throughput per disk
$ npm install
Source trees and package installs run at block-storage speed, not NFS speed.
<1 ms
cached read and write latency
Archil runs tool calls and sandboxes beside a durable, shared filesystem. Your servers and applications work on the same files.
Archil keeps hot data on SSD and cold data in object storage. Connect an existing S3 bucket, or start with managed storage.
measured by running git clone
100×
measured by performing 4 KB reads
30×
Archil gave us a single filesystem layer that works identically across the 10+ providers ComputeSDK orchestrates. Our users stopped thinking about where their files live — that's exactly the point.

“This is my trifecta of a new-gen cloud — Archil for storage, compute alongside it, and a database. It just fits together.”

“Biggest surprise for me was Archil's speed. Incredible tech, and it should have more visibility with AI-native teams.”
