https://github.com/zircote/ruby-lsp
Claude Code plugin for Ruby development with solargraph LSP and rubocop hooks
https://github.com/zircote/ruby-lsp
claude-code-plugin code-quality lsp rails rubocop ruby
Last synced: 3 months ago
JSON representation
Claude Code plugin for Ruby development with solargraph LSP and rubocop hooks
- Host: GitHub
- URL: https://github.com/zircote/ruby-lsp
- Owner: zircote
- License: mit
- Created: 2026-01-02T21:03:06.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-30T15:37:23.000Z (3 months ago)
- Last Synced: 2026-03-30T17:36:00.455Z (3 months ago)
- Topics: claude-code-plugin, code-quality, lsp, rails, rubocop, ruby
- Language: Ruby
- Size: 20.5 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ruby-lsp
[](CHANGELOG.md)
[](LICENSE)
[](https://docs.anthropic.com/en/docs/claude-code/plugins)
[](https://github.com/zircote/lsp-marketplace)
[](https://www.ruby-lang.org/)
A Claude Code plugin providing comprehensive Ruby development support through:
- **ruby-lsp** (Shopify) integration for IDE-like features
- **12 automated hooks** for linting, formatting, testing, and security scanning
- **Ruby ecosystem** integration (RuboCop, RSpec, Bundler, Brakeman)
## Quick Setup
```bash
# Run the setup command (after installing the plugin)
/setup
```
Or manually:
```bash
# Install Ruby LSP
gem install ruby-lsp
# Install development tools
gem install rubocop bundler-audit brakeman
```
## Features
### LSP Integration
The plugin configures ruby-lsp for Claude Code via `.lsp.json`:
```json
{
"ruby": {
"command": "ruby-lsp",
"args": [],
"extensionToLanguage": {
".rb": "ruby",
".rake": "ruby",
".gemspec": "ruby"
},
"transport": "stdio"
}
}
```
**Capabilities:**
- Go to definition / references
- Hover documentation
- Gem resolution
- YARD documentation
- Real-time diagnostics
### Automated Hooks
| Hook | Trigger | Description |
|------|---------|-------------|
| `ruby-syntax-check` | `**/*.rb` | Ruby syntax validation |
| `rubocop-on-edit` | `**/*.rb` | Lint and auto-fix with RuboCop |
| `brakeman-check` | `**/*.rb` | Security scanning (Rails) |
| `ruby-todo-fixme` | `**/*.rb` | Surface TODO/FIXME comments |
## Required Tools
| Tool | Installation | Purpose |
|------|--------------|---------|
| `ruby-lsp` | `gem install ruby-lsp` | LSP server |
| `rubocop` | `gem install rubocop` | Linting & formatting |
| `bundler-audit` | `gem install bundler-audit` | Dependency security |
| `brakeman` | `gem install brakeman` | Rails security |
## Project Structure
```
ruby-lsp/
├── .claude-plugin/
│ └── plugin.json # Plugin metadata
├── .lsp.json # ruby-lsp configuration
├── commands/
│ └── setup.md # /setup command
├── hooks/
│ └── scripts/
│ └── ruby-hooks.sh
├── tests/
│ └── sample_spec.rb # Test file
├── CLAUDE.md # Project instructions
└── README.md # This file
```
## License
MIT