# Introducing bash-tool for filesystem-based context retrieval

By Steven Van · 2026-01-07

Vercel open-sources bash-tool, letting AI SDK agents run bash, grep, and jq over a local filesystem instead of loading it all into the prompt.

Vercel has open-sourced **bash-tool**, the Bash execution engine behind its text-to-SQL agent, which was re-architected to cut token usage and improve accuracy and performance. The library lets an agent run bash-like commands, such as find, grep, and jq, over a filesystem of files and get back only the results of those calls, rather than pasting the full content into the prompt.

bash-tool provides bash, readFile, and writeFile tools for AI SDK agents. It runs on top of **just-bash**, which interprets bash scripts directly in TypeScript without a shell process or arbitrary binary execution. A filesystem of files can be preloaded at startup so the agent can search it on demand, and it can run either in-memory or against a Sandbox-compatible API, such as [Vercel Sandbox](<https://vercel.com/docs/vercel-sandbox>), for full VM isolation.

Read the [original announcement](<https://vercel.com/changelog/introducing-bash-tool-for-filesystem-based-context-retrieval>) for setup examples.

[![](<https://assets.vercel.com/image/upload/contentful/image/e5382hct74si/51ApDFjxfMXbNkA8WbUg7b/ca6b48d491ccaa35b372939463041fc2/image__1_.png>)](<https://vercel.com/changelog/introducing-bash-tool-for-filesystem-based-context-retrieval>)

![Vercel](<https://www.google.com/s2/favicons?domain=vercel.com&sz=128>)

Vercel

The platform for frontend developers — deploy, preview, and scale web apps and AI agents with zero config.

[View Vercel →](<https://creatorstoolbox.com/tools/vercel>)

[Original source](<https://vercel.com/changelog/introducing-bash-tool-for-filesystem-based-context-retrieval>)

[Read Introducing bash-tool for filesystem-based context retrieval on Creators Toolbox](<https://creatorstoolbox.com/blog/vercel-introducing-bash-tool-for-filesystem-based-context-retrieval>)

---
Canonical source: https://creatorstoolbox.com/blog/vercel-introducing-bash-tool-for-filesystem-based-context-retrieval