# Project-aware context for repo-rooted agents

> Agno introduces WorkspaceContextProvider, a context provider purpose-built for agents that operate inside a repository root.

- Published: 2026-04-27
- Author: Agno Team
- Category: Changelog
- Canonical: https://agno-com-nine.vercel.app/articles/project-aware-context-for-repo-rooted-agents
- Markdown: https://agno-com-nine.vercel.app/articles/project-aware-context-for-repo-rooted-agents.md

Agno introduces WorkspaceContextProvider, a context provider purpose-built for agents that operate inside a repository root. It's backed by the read-only Workspace toolkit rather than generic file tools, so reading a repository and acting on it stay cleanly separated by default. Exclusion patterns for noise like `.context`, `.venvs`, dependency caches, and build artifacts are centralized across FileTools and Workspace, and FilesystemContextProvider now accepts an `exclude_patterns` parameter for teams that want to opt out or customize the defaults explicitly.

**Why it matters:** Pointing an agent at a repository is one of the most common patterns in agentic software, and one of the most token-expensive when it pulls in lockfiles, virtualenvs, and build output. Out-of-the-box noise filtering reduces context size, cost, and latency without forcing teams to maintain their own ignore lists. The read-only backing also means the provider is safe to attach to research and analysis agents that should never modify the repo they're reading.

Learn more in the[Context engineering docs](https://docs.agno.com/context/agent/overview) or the [Cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/12_context/13_workspace.py).