POSH — Ruby documentation
Search and read local Ruby gem docs matched to your project's gem versions
- Pricing
- Freemium
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 0.39.0
- Listing updated
- 1 day ago
About POSH — Ruby documentation
POSH — Ruby documentation is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
POSH keeps Ruby documentation on your machine, synced when you run posh sync, so a coding agent can look up a method without web requests. The site's example is searching for at_css in Nokogiri 1.19.4 and then reading just that section, which it says is about 0.5 KB against a 363 KB GitHub page.
The agent tools come as a CLI and a local stdio MCP server packaged as an mcpb bundle. Documentation is treated as data rather than instructions, and the site says it is scanned for prompt injections and built in an isolated VM. A free terminal UI offers project-wide search, outline, bookmarks and find in page.
It runs on macOS and Linux and supports Ruby only; Python and Go are planned. The client and back-end are not open source, and the agent tools need a subscription of 5 euros a month or 45 a year.
Install
Run in a terminal
claude mcp add posh -- npx -y https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"posh": {
"command": "npx",
"args": [
"-y",
"https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"posh": {
"command": "npx",
"args": [
"-y",
"https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"posh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"posh": {
"command": "npx",
"args": [
"-y",
"https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"posh": {
"command": "npx",
"args": [
"-y",
"https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
]
}
}
}What it does
- Version-matched docs
- Documentation follows the gem versions in your project.
- Section-level reading
- The agent reads one clean Markdown section instead of a whole page.
- Offline search
- After a sync, search and read work without network requests.
- Injection scanning
- Docs are scanned and treated as data, not instructions.
- Free terminal browser
- A TUI offers search, outline, bookmarks and cross-reference links.
Good for
- Look up a gem method signature while coding
- Cut token use when an agent needs docs
- Search every gem in a Ruby project at once
- Work with documentation offline
Pricing
Freemium
Free terminal UI; agent tools 5 EUR/month or 45 EUR/year
Prices change. Check poshtui.com before you buy.
POSH — Ruby documentation FAQ
What does it cost?
The terminal UI is free; agent CLI and MCP tools are 5 euros a month or 45 a year.
Is it open source?
No. The client and back-end are not open source.
Which platforms and languages?
macOS and Linux, with Ruby supported and Python and Go planned.
Does it work offline?
Yes, after running posh sync with an internet connection.
Is POSH — Ruby documentation free?
POSH — Ruby documentation has a free plan, with paid plans for more usage or features.
How do I add POSH — Ruby documentation to Claude Code?
Run this command in your terminal: claude mcp add posh -- npx -y https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb
What are the best alternatives to POSH — Ruby documentation?
The closest alternatives to POSH — Ruby documentation are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to POSH — Ruby documentation

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools