
Local Ruby documentation MCP server. Public install metadata for proprietary POSH binaries.
Local Ruby documentation MCP server. Public install metadata for proprietary POSH binaries.
·
Search and read local Ruby and gem documentation matched to your project's versions.
POSH gives coding agents documentation selected from your Ruby version and
Gemfile.lock: API references, READMEs, changelogs, and guides where available.
Documentation lookups use local files and an index after syncing. The sync
tool uses the network to download docs and update that index.
This repository contains public installation metadata and integration manifests, not the POSH application source. POSH is proprietary software. Its terminal documentation browser and basic sync are free; MCP and agent CLI tools require a POSH license. Current plans and trial details are at poshtui.com.
Supported platforms: macOS (Apple Silicon and Intel) and Linux (ARM64, x86-64, and x86). Windows and hosted HTTP connections are not supported.
brew install --cask skatkov/tap/poshtuiOn Arch Linux, use yay -S poshtui-bin. Other installs are available from
GitHub Releases.
Retrieve your license from the customer portal linked in your Polar purchase email. Activate it locally, outside agent chats:
posh activate YOUR_LICENSE_KEYNever put a license key in a public issue, chat, or MCP configuration.
From your Ruby project, download its documentation:
posh syncAdd this to your client's MCP configuration, replacing the project path:
{
"mcpServers": {
"posh": {
"command": "posh",
"args": ["mcp"]
}
}
}Transport: local stdio. POSH must be on your client's PATH; otherwise use its
absolute executable path. Update the configured project when switching projects,
or supply project on individual tool calls. No API-key environment variable is
required: the executable uses the license activation saved on your computer.
Compatible clients can install the universal posh-mcp.mcpb asset from
POSH releases. Select your Ruby
project when prompted. The bundle contains the existing platform binaries and
does not bypass license activation. It does not host or upload your project.
After installing and activating POSH:
gemini extensions install https://github.com/skatkov/posh-mcpThe extension runs posh mcp locally. Ask the agent to pass your absolute Ruby
project directory in tool calls if its working directory is not your project.
An MCP server alone gets used late, because agents tend to reach for it only once they are stuck. These plugins connect the server and also tell the agent to check POSH before relying on memory for Ruby, Rails, and gem work. Install and activate POSH first.
Claude Code, as two separate prompts:
/plugin marketplace add skatkov/posh-mcp
/plugin install posh@skatkovCodex, then open /hooks, trust the POSH hooks, and start a new thread. Codex
skips hooks until they are trusted:
codex plugin marketplace add skatkov/posh-mcp
codex plugin add posh@skatkovOpenCode 2:
opencode plugin add github:skatkov/posh-mcp#mainThe instructions come from skills/posh/SKILL.md.
OpenCode adds them to the system prompt of every model request. Claude Code and
Codex have no plugin API for the system prompt, so they receive them as hidden
context at session start, after compaction, and when a subagent starts.
| Command | Effect |
|---|---|
/posh auto | Default. Active when the project has a Gemfile, Gemfile.lock, gems.rb, or *.gemspec, in the working directory or above it, up to the Git root |
/posh or /posh on | Active in every project. Use this when the Ruby app sits in a subdirectory |
/posh feedback | Same as /posh on, and the agent ends replies that used POSH with a POSH feedback section. The feedback stays in the reply; nothing is sent anywhere |
/posh off | Inactive everywhere |
In Codex, use $posh in place of /posh. The mode is saved in
~/.config/posh/agent-mode and shared by all three agents. These plugins are
not a claim that Anthropic, OpenAI, or OpenCode has reviewed or listed them.
Install and activate POSH first, then paste this into the browser address bar. Cursor prompts before it installs:
cursor://anysphere.cursor-deeplink/mcp/install?name=posh&config=eyJjb21tYW5kIjoicG9zaCIsImFyZ3MiOlsibWNwIl19The encoded configuration is {"command":"posh","args":["mcp"]}. GitHub strips
cursor:// links, so the one-click button lives in the
installation docs
instead.
This repository also includes .cursor-plugin/plugin.json and root mcp.json.
The deeplink adds only the MCP server; the plugin format also carries the POSH
skill, and Cursor lists plugins only after its own review. The integration
launches posh mcp locally; pass the intended absolute project path in tool
calls. This is not a claim that Cursor has reviewed or listed the plugin. POSH
remains proprietary software.
| Tool | Purpose | Effects |
|---|---|---|
docsets | Discover project versions and installed documentation | Read-only |
search | Find APIs and documentation | Read-only |
list | Browse a docset's indexed entries | Read-only |
outline | Get headings and section references | Read-only |
read | Read a document or section | Read-only |
sync | Download and index documentation | Network access and local cache/index writes |
Start with docsets, search using a returned library ref, and read the returned
document or section ref. Sync missing docs, then retry. Do not invent refs or
assume a tool call's project override persists to the next call.
See POSH's privacy policy. Documentation lookups read locally synced documentation. Sync requires network access; license activation and verification contact licensing services. Your MCP client controls what tool results it sends to its model provider. Do not claim that all MCP calls are offline or read-only.
Copyright © 2026 KROONI B.V. All rights reserved. See LICENSE and Terms of Service. This repository does not grant additional rights to POSH or its binaries.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add posh -- posh mcp{
"mcpServers": {
"posh": {
"args": [
"mcp"
],
"command": "posh"
}
}
}code --add-mcp '{"name":"posh","args":["mcp"],"command":"posh"}'[mcp_servers.posh]
command = "posh"
args = ["mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/posh-mcp-server to learn what the "POSH MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/posh-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "posh-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.