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

# Introduction

> Durable, versioned storage that agents can use like a local Linux filesystem.

Amulet provides durable, versioned storage for agents and AI jobs. Mount a
volume as a Linux directory, point existing tools at that path, and keep the
files after the machine or sandbox disappears.

* **Mount durable storage as a directory.** Use shell tools, `pathlib`, and
  existing libraries without adding an object-storage adapter.
* **Isolate each job with a branch.** Give an experiment or agent a writable
  view of shared data without cloning the full volume.
* **Preserve reproducible state with snapshots.** Save an immutable version
  that another process or machine can mount later.

## See it in action

Start a mount in one terminal:

```bash theme={null}
amulet mount workspace ./workspace
```

Then use the mounted directory from another terminal:

```bash theme={null}
echo "persistent state" > ./workspace/state.txt
cat ./workspace/state.txt
```

The mount command creates `workspace` if it does not exist. After you unmount,
the file remains available the next time you mount the volume.

## When to use Amulet

Use Amulet for file-oriented agent, evaluation, training, and batch workloads
that need durable state or isolated copies of shared data. It is not a database
filesystem and does not support every POSIX behavior. Review
[Compatibility and limitations](/compatibility) before using it with software
that depends on file locking or concurrent writes to the same file.

<CardGroup cols={2}>
  <Card title="Quickstart" href="/quickstart">
    Mount a volume, write a file, and verify that it persists.
  </Card>

  <Card title="Volumes and mounts" href="/core-concepts">
    Understand what is durable and what the local mount exposes.
  </Card>
</CardGroup>