Skip to main content
AgentFS can sync with Turso Cloud, enabling backup, collaboration, and distributed agent deployments.

Setting Up Sync

1. Create a Turso Database

If you don’t have a Turso account, sign up first. Create a database for your agent:
Get the database URL:

2. Initialize with Sync

Create a new agent filesystem with sync enabled:
Or add sync to an existing agent:

Sync Commands

Pull Remote Changes

Download changes from Turso Cloud:

Push Local Changes

Upload local changes to Turso Cloud:

View Sync Status

Check sync statistics:

Create Checkpoint

Force a sync checkpoint:

Use Cases

Backup and Recovery

Automatically back up agent state:

Multi-Machine Agents

Run agents on multiple machines with shared state:

Partial Sync

For large filesystems, use partial sync to only fetch what’s needed:

Partial Sync Options

Authentication

Sync requires a Turso auth token. Set it via environment variable:
Or create a long-lived token:

Conflict Resolution

AgentFS uses last-write-wins for conflicts. If the same file is modified on multiple machines:
  1. Push from Machine A succeeds
  2. Push from Machine B fails (conflict)
  3. Machine B must pull first, then push

Next Steps

Turso Cloud

Learn more about Turso Cloud

NFS Server

Remote access via NFS