vercel-labs/bash-tool — Repository

LABSCO SUMMARY

Summary

bash-tool is Vercel Labs' sandboxed bash-and-file-I/O tool for AI SDK agents, and its two skills are only the example files that demonstrate the library's own optional Skills feature.

The library itself has nothing to do with skills: createBashTool hands an agent three tools — bash to run a shell command, readFile, and writeFile — against either an in-process just-bash sandbox for quick work or a real @vercel/sandbox VM when actual isolation matters. Beyond the basics it covers uploading a local directory into the sandbox, reconnecting to a running sandbox by ID across separate serverless invocations, and intercepting every command through onBeforeBashCall/onAfterBashCall hooks to log, block, or rewrite it before or after it runs.

The separate, marked-experimental Skills feature is a second, optional layer: createSkillTool discovers SKILL.md-based skill folders and hands their files and instructions to the agent alongside the bash tool. The two skills, csv and text, live under the repository's own examples/skills-tool/skills/ directory and exist to show that folder structure working end to end, not as a maintained data-analysis product.

What the two skills actually say.

Each carries a one-line description — "Analyze and transform CSV data using bash tools" and the same for text files — and the README's own example tree shows each backed by a couple of shell scripts (analyze.sh, filter.sh, search.sh).

Who this is for.

A developer already building an agent on Vercel's AI SDK (ToolLoopAgent and friends) who wants a ready-made bash and file toolset instead of writing tool schemas by hand. Someone looking for a real CSV or text-analysis skillset should treat the two shipped here as a demonstration of the mechanism, not as the destination.

WHAT'S INSIDE

Skills

csv

Reads a spreadsheet-style CSV file from the command line: a quick summary of what is in it, only the rows matching a value, only the columns you care about, or the whole thing sorted.

text

Works over a plain text file from the command line: count what is in it, find a pattern with the lines either side of it, lift out a section, or list the words that come up most.

INSTALL

Install

CHOOSE SKILLS

Install skills from this package (2 skills)

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 starts with no skills selected; prompts cancel installation without an interactive terminal. For project installation, open your project's folder first.

Install checklist

Use ↑/↓ to move and Space to select skills or Select All, then Enter. Enter alone cannot continue with nothing selected.
Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

npx skills add vercel-labs/bash-tool

SINGLE SKILL

Or install a single skill

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.