Supabase docs over SSH

Summary

Supabase is launching supabase.sh, a free public SSH server that gives AI coding agents bash access to Supabase documentation as a public experiment. Its virtual file system exposes every documentation page as a Markdown file under /supabase/docs, allowing agents to use familiar commands such as grep, find, ls, cat, head, and tail to browse, search, and skim current content. The service runs on just-bash, Vercel’s open-source Bash emulator written in TypeScript, inside a sandboxed JavaScript runtime over a virtual file system, so it does not execute an actual shell on the server. Project instructions can be added with ssh supabase.sh agents >> AGENTS.md or generated through ssh supabase.sh setup | claude; the post contrasts this exploratory workflow with the existing search_docs MCP tool and presents supabase.sh as an early experiment.

Takeaways

1. 1

   Supabase documentation is exposed as Markdown files in a virtual file system at /supabase/docs, so agents can browse topics and inspect pages with standard Bash-style commands.

2. 2

   supabase.sh uses just-bash in a sandboxed JavaScript runtime over a virtual file system rather than running an actual shell on the server, enabling a public unauthenticated service.

3. 3

   The Bash interface supports exploratory browsing across multiple files, whereas the existing search_docs MCP tool relies on a predefined query and returns search results without the same navigation workflow.