Claude Code Ruby LSP Plugin

Ruby code intelligence for Claude Code via Shopify's ruby-lsp language server.

Once installed, Claude Code automatically gains:

• Diagnostics — syntax errors and warnings surfaced after every edit
• Go-to-definition — jump to method, class, or module definitions
• Find references — locate all usages of a symbol
• Hover — inline documentation and type information
• Completions — context-aware code suggestions
• Code actions — quick fixes and refactors
• Formatting — consistent code style
• Rename — safe symbol renaming across files
• Workspace symbols — project-wide symbol search

Prerequisites

Install Shopify's ruby-lsp gem:

gem install ruby-lsp

Verify the binary is available:

which ruby-lsp && ruby-lsp --version

Installation

From the marketplace

# Add the marketplace
/plugin marketplace add josecolella/claude-code-ruby-lsp

# Install the plugin
/plugin install ruby-lsp@ruby-lsp-marketplace

Local testing

git clone https://github.com/josecolella/claude-code-ruby-lsp.git
claude --plugin-dir ./claude-code-ruby-lsp/plugins/ruby-lsp

What Claude gains

With this plugin active, Claude Code connects to the ruby-lsp language server over stdio. This means:

• Automatic diagnostics — after every file edit, Claude sees any errors or warnings the language server reports
• Code navigation — Claude can jump to definitions and find references when investigating code
• Richer context — hover information and completions give Claude better understanding of your Ruby codebase

No project configuration is needed. ruby-lsp works out of the box with any Ruby project.

Troubleshooting

ruby-lsp not found

Make sure the gem is installed and the binary is on your $PATH:

gem install ruby-lsp
which ruby-lsp

If you use a Ruby version manager (rbenv, asdf, mise), ensure the correct Ruby environment is active in your shell before launching Claude Code.

Version compatibility

This plugin requires ruby-lsp v0.17.0 or later. Check your version:

ruby-lsp --version

Upgrade if needed:

gem update ruby-lsp

License

MIT