bash-tool 오픈소스 — AI 에이전트용 파일시스템 컨텍스트 검색 Bash 실행 엔진

Vercel이 텍스트-to-SQL 에이전트에 내부적으로 사용하던 bash-tool을 오픈소스로 공개했다. AI 에이전트가 bash 커맨드로 파일시스템을 탐색해 필요한 컨텍스트만 선택적으로 가져오도록 설계됐으며, 인메모리 실행과 Vercel Sandbox API를 통한 완전한 VM 격리 두 가지 모드를 지원한다.

핵심 포인트

just-bash(TypeScript 기반 bash 인터프리터)로 bash 커맨드를 에이전트 환경에서 안전하게 실행한다.
readFile/writeFile 연산, 스타트업 파일 프리로드, 인메모리/샌드박스 VM 두 가지 실행 모드를 지원한다.
에이전트가 전체 데이터를 프롬프트에 임베딩하지 않고 필요한 파일만 on-demand로 검색해 컨텍스트 창 블로트를 방지한다.
AI SDK v6와 함께 설치해 에이전트 도구로 등록한다.
Vercel Sandbox API와 통합 시 완전한 VM 격리를 제공한다.

상세 정리

배경: 에이전트 개발의 핵심 과제는 컨텍스트 창이 불필요한 정보로 가득 찬 블로트 문제다. bash-tool은 에이전트가 Unix 커맨드로 파일시스템을 탐색해 필요한 데이터만 동적으로 가져오게 한다.
just-bash: TypeScript로 구현된 bash 인터프리터로 bash 커맨드 서브셋을 안전하게 실행한다. 실제 시스템 bash 없이 격리된 실행 환경을 제공한다.
파일 연산: readFile로 특정 파일 내용을 읽고, writeFile로 에이전트가 상태를 파일에 저장할 수 있다.
프리로드 파일시스템: 스타트업 시 특정 파일들을 인메모리에 미리 로드해 에이전트가 즉시 탐색하도록 초기화한다.
인메모리 모드: 애플리케이션 내에서 로컬 실행. 격리가 불필요하고 성능이 중요한 환경에 적합하다.
샌드박스 VM 모드: 실제 셸·파일시스템·커스텀 바이너리가 필요한 경우 Vercel Sandbox API로 완전한 VM 격리 환경에서 실행한다.
AI SDK v6 통합: AI SDK v6과 함께 설치해 에이전트 도구로 등록한다. LLM이 직접 bash-tool을 호출해 파일시스템을 탐색한다.
사용 사례: Vercel 내부 텍스트-to-SQL 에이전트에서 DB 스키마 파일을 파일시스템으로 구성하고 에이전트가 필요한 스키마만 가져오는 패턴을 채택했다.