HN Showcase
Back to browse
GitHub Repository

Supabase docs over SSH

45 starsTypeScript

Docs over SSH for Agents

by gregnr·Apr 1, 2026·9 points·0 comments
Visit ProjectView on HN

AI Analysis

●●SolidBig BrainZero to One

SSH interface for docs matches how agents naturally explore codebases with grep and cat.

Strengths
  • •Leverages agent training on shell commands instead of fighting with vector search APIs.
  • •Vercel's just-bash library creates sandboxed VFS without actual shell execution.
  • •Agents can skim with head and tail without bloating context windows.
Weaknesses
  • •Currently only serves Supabase docs, not a generalizable solution yet.
  • •No evals proving this outperforms traditional RAG or web search methods.
Category
AI/ML
Target Audience

Developers using coding agents like Claude Code, Cursor

Post Description

Coding agents spend a lot of time in the shell. When exploring a codebase, they usually reach for the same handful of tools: grep, find, ls, cat. We built a public SSH server that hosts Supabase docs as markdown files so that agents can explore them the same way they explore code:

ssh supabase.sh grep -rl 'RLS' docs

ssh supabase.sh cat docs/guides/database/postgres/row-level-security.md | head -10

Under the hood commands run inside Vercel's just-bash [1] library - an emulated bash shell sandboxed within the JS runtime. It uses a VFS where the docs are mounted as markdown files. SSH is handled by ssh2 [2].

Next step is evals to confirm whether or not this truly performs better than other knowledge retrieval methods (like skills, web search, MCP tools), but we were too excited not to share something now.

[1] https://github.com/vercel-labs/just-bash [2] https://github.com/mscdex/ssh2

Similar Projects