---
title: "Supabase docs over SSH"
description: "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."
---

# Supabase docs over SSH

[Supabase](https://yomu.fyi/company/supabase) · gregnr · Apr 1, 2026

**Type:** Announcement

## 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.

## Context

AI coding agents may recommend non-existent APIs, incorrect CLI commands, or omit steps such as enabling RLS when they lack access to current Supabase documentation. The existing search\_docs MCP tool requires the agent to know what to ask for and does not support the same browsing and exploration workflow as a file system.

## Approach / What changed

supabase.sh serves the Markdown source behind Supabase documentation through a virtual file system at /supabase/docs over SSH. It runs on just-bash, an open-source Bash emulator written in TypeScript, inside a sandboxed JavaScript runtime. Agents can use familiar commands to list, search, read, and skim documentation, while project-specific instructions can be appended to AGENTS.md or CLAUDE.md.

## Takeaways

- 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.
- 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.
- 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.

**Tags:** [Developer Experience](https://yomu.fyi/topic/developer-experience), [LLMs](https://yomu.fyi/topic/llm), [Open Source](https://yomu.fyi/topic/open-source)

- Source: [Supabase](https://supabase.com/blog/supabase-docs-over-ssh)
- Source URL: https://supabase.com/blog/supabase-docs-over-ssh
- Ingested by Yomu: 2026-08-29T12:01:11.146Z

[Read original post](https://supabase.com/blog/supabase-docs-over-ssh)