> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archil.com/llms.txt
> Use this file to discover all available pages before exploring further.

# eve

> Context your agent can understand

eve agents are built around the concept of filesystems as a core primitive. Archil now automatically provides the layer connecting them to your data by exposing tools for eve agents to read, write, and execute commands against data, as if it was a local filesystem.

<Steps>
  <Step title="Create an Archil disk">
    Go to the [Archil console](https://console.archil.com) and create a new disk. Also, [create an API key](https://console.archil.com/api-keys) in the same region as your disk. Create a `.env.local` file in the root of your project with:

    ```sh theme={null}
    ARCHIL_API_KEY=<your-api-key>
    ARCHIL_REGION=<your-disk-region>
    ARCHIL_DISK_ID=<your-disk-id>
    ```
  </Step>

  <Step title="Install the SDK">
    ```bash theme={null}
    npm install disk @archildata/eve
    ```
  </Step>

  <Step title="Create tools">
    Give your agent tools to read/write from an existing Archil disk. Create `agent/tools/disk.ts`:

    ```ts theme={null}
    import * as archil from "disk";
    import { createDiskTools } from "@archildata/eve";

    const disk = await archil.getDisk(process.env.ARCHIL_DISK_ID!);
    export default createDiskTools(disk);
    ```
  </Step>
</Steps>

Optionally, you can add Archil as the compute and persistent storage provider for eve agent sessions. Create `agent/sandbox/sandbox.ts`:

```ts theme={null}
import { defineSandbox } from "eve/sandbox";
import { archilBackend } from "@archildata/eve";

export default defineSandbox({
  backend: archilBackend({
    disk: process.env.ARCHIL_DISK_ID!,
  }),
});
```