---
id: "action-implement-filesystem"
type: "action-item"
source_timestamps: ["§ Filesystems for Durable Storage and Context Management"]
tags: ["infrastructure", "state-management"]
related: ["concept-filesystem-primitive", "claim-long-horizon-compounds"]
action: "Equip agents with filesystem abstractions and tools for durable storage and context offloading."
outcome: "Agents can maintain state across sessions and avoid context window exhaustion."
speakers: ["Vivek Trivedy"]
---
# Implement Filesystem Abstractions

## Action

**Equip agents with filesystem abstractions and tools for durable storage and context offloading.**

## How

Provide agents with a filesystem workspace and a set of fs-ops tools (`read_file`, `write_file`, `list_dir`, `grep`, `apply_patch`, etc.). This allows them to:

- **Offload intermediate outputs** so they do not consume context tokens unnecessarily.
- **Maintain state across sessions** — critical for [[claim-long-horizon-compounds|long-horizon work]] and [[concept-ralph-loop|Ralph Loops]].
- **Collaborate via shared files** — Agent Teams (multiple agents and humans) coordinate naturally through the filesystem surface.

Add Git on top for versioning, rollback, and experiment branching.

## Expected Outcome

Agents can maintain state across sessions, avoid context window exhaustion, and recover from failures by re-reading durable state.

## Cross-Reference

Grounding concept: [[concept-filesystem-primitive]].