# POSH — Ruby documentation

> POSH — Ruby documentation is a freemium MCP server for developer tools. Search and read local Ruby gem docs matched to your project's gem versions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, Linux, CLI
- **Website:** https://poshtui.com
- **MCP Registry name:** io.github.skatkov/posh
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add posh -- npx -y https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "posh": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "posh": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "posh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "posh": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "posh": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/skatkov/homebrew-tap/releases/download/0.39.0/posh-mcp.mcpb"
      ]
    }
  }
}
```

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/posh-ruby-documentation
