Skip to main content
AgentFS records every file operation and tool call, giving you complete visibility into agent behavior. This is essential for debugging, compliance, and understanding how agents work.

Viewing the Timeline

See a chronological list of tool calls:
Output:

Filtering Results

Show only specific tool types:
Show only errors:
Limit number of entries:

JSON Output

For programmatic analysis:

Inspecting Files

List all files in a session:
Output:
List a subdirectory:
Read file contents:

Viewing Changes (Diff)

See what changed compared to the original filesystem:
This shows:
  • New files created
  • Modified files
  • Deleted files

Querying with SQL

Since AgentFS uses SQLite, you can run arbitrary queries:
Example queries:

Use Cases

Debugging Agent Failures

When an agent fails, use the timeline to understand what happened:

Performance Analysis

Find slow operations:

Compliance Auditing

Export a complete record of agent activity:

Next Steps

Overlay Filesystem

Understanding copy-on-write

Syncing

Sync sessions to Turso Cloud