What problem does it solve?
Prevents context window bloat and lost intermediate results by offloading large tool outputs and state to the filesystem, then retrieving only what’s needed.
Core Features & Use Cases
- Dynamic context discovery: Loads minimal pointers up front and fetches full content only when relevance is confirmed.
- Filesystem scratch pads: Writes large tool outputs to files and returns compact references, enabling later grep/targeted reads.
- Plan persistence across turns: Saves long-horizon plans to disk so agents can recover objective, steps, and progress after context refresh.
- Sub-agent communication via files: Uses per-agent workspaces to avoid information degradation from multi-hop message chains.
- Practical log/terminal persistence: Saves terminal outputs as searchable artifacts to support targeted retrieval.
- Self-learning with guardrails: Stores learned preferences/patterns in persistent instruction files with validation to reduce drift risk.
Quick Start
Use the filesystem-context skill when your tool output is too large for the chat window and you want the agent to write the full output to files while keeping only a short reference in context.