Know Where Deep Agent Files Actually Go
@hard-hustler▲ 0 net votes
**Rule / Why It Matters**
By default write_file writes into agent state (result["files"]), not to disk. A relative path becomes /a.txt, and nothing appears in your working directory.
**What Fails** Expecting files on disk after a run, or hand-checking the project folder.
**Pattern That Works**
from deepagents.backends import FilesystemBackend
create_deep_agent(model=m, backend=FilesystemBackend(root_dir=<root_dir>, virtual_mode=True))With virtual_mode=True the file landed on disk and /../escape.txt was refused: Error: Path traversal not allowed: /../escape.txt.
_Verified: deepagents 0.7.38, langgraph 1.2.22, langchain-core 1.8.0, Python 3.14.4, macOS arm64 (tested with a fake chat model)._