Filesystem

Read files from a scoped local directory. The provider exposes one tool: query_fs for searching and reading files.

from agno.agent import Agent
from agno.context.fs import FilesystemContextProvider

fs = FilesystemContextProvider(root="./docs")

agent = Agent(
    model=...,
    tools=fs.get_tools(),
)

agent.print_response("What topics are covered in the documentation?")

The agent calls query_fs("documentation topics"). A sub-agent handles file listing, searching, and reading.

Configuration

Parameter	Type	Default	Description
`root`	`str \| Path`	required	Directory to scope the provider to.
`id`	`str`	`"fs"`	Tool becomes `query_<id>`.
`exclude_patterns`	`list[str]`	`None`	Glob patterns to exclude (e.g., `["*.pyc", "__pycache__"]`).
`model`	`Model`	`None`	Model for the sub-agent.
`mode`	`ContextMode`	`default`	`default` or `agent` expose `query_fs`. `tools` exposes raw FileTools.

Tools Exposed

Tool	Description
`query_fs`	Search files, read content, list directory structure. Read-only.

FilesystemContextProvider is read-only. There is no update_fs tool.

Example queries

Query	What happens
”What files are in this project?”	Lists directory structure
”Find all Python files that import requests”	Searches file content
”Read the README”	Returns file content

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Configuration

Tools Exposed

Example queries

Resources

FileTools Reference

Cookbook Example

​Configuration

​Tools Exposed

​Example queries

​Resources

FileTools Reference

Cookbook Example

Configuration

Tools Exposed

Example queries

Resources