Skip to content
MCP server

POSH — Ruby documentation

Search and read local Ruby gem docs matched to your project's gem versions

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools