Skip to main content
Agents are extremely capable of performing tasks, but they are limited by the amount of information available in their context. The Archil AI SDK integration gives agents the ability to store and retrieve information from an infinite filesystem, giving them access to the entirety of your data. It exposes an interface they are already extremely familiar with — the filesystem. It allows your agent to read files, write files, list directories, search with grep, and execute commands in a sandbox via serverless execution.
1

Create an Archil disk

Go to the Archil console and create a new disk. Also, create an API key in the same region as your disk. Add the following environment variables to your project:
ARCHIL_API_KEY=<your-api-key>
ARCHIL_REGION=<your-disk-region>
ARCHIL_DISK_ID=<your-disk-id>
2

Install the SDK

npm install disk @archildata/ai-sdk
3

Create tools

Create tools for your agent to interact with the disk.
import { generateText } from "ai";
import * as archil from "disk";
import { createDiskTools } from "@archildata/ai-sdk";

const disk = await archil.getDisk(process.env.ARCHIL_DISK_ID!);
const result = await generateText({
  model: "anthropic/claude-sonnet-4.6",
  prompt: "Read the quarterly reports and write a summary of the key findings for each one.",
  tools: createDiskTools(disk),
});