Show HN: Docs over SSH for Agents

9 points

2 months ago

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