The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
Ruby — LSP setup
- Builtin server:
ruby-lsp—rubocop --lsp - Extensions:
.rb .rake .gemspec .ru - Install hint:
gem install ruby-lsp
Note: the builtin id is
ruby-lsp, but the executable actually invoked isrubocop(rubocop --lsp). RuboCop must be installed:gem install rubocop.
Install
- macOS:
gem install rubocop(andgem install ruby-lspfor the install hint's gem) - Linux:
gem install rubocop - Windows:
gem install rubocop
In a Bundler project, prefer adding rubocop to the Gemfile and running via bundle exec.
Confirm it resolves (check rubocop, since that is what runs):
command -v rubocop
Configure
Builtin — usually NO config needed (auto-resolved by extension). Configure only to set priority, init options, override extensions, or disable. Same JSON shape in every harness's project config (per-harness paths: the Configure step in SKILL.md):
{ "lsp": { "ruby-lsp": { "priority": 100 } } }
For builtin ids in a PROJECT config, command is supplied automatically — only set priority/initialization/extensions/disabled (a project entry drops env). env, and a fully custom (non-builtin) server with its own command, must go in your harness's USER config (see the Configure step in SKILL.md).
Initialization options (only if commonly needed)
None commonly required. Behavior is driven by your .rubocop.yml; the server surfaces RuboCop diagnostics, formatting, and code actions over LSP.
Alternatives
ruby-lspgem server (not builtin) — the standalone Shopify Ruby LSP binary (ruby-lspexecutable), richer navigation than RuboCop alone. Configure as a custom server withcommand: ["ruby-lsp"]in the USER config.solargraph(not builtin) — older completion/type server; install withgem install solargraph, customcommand: ["solargraph", "stdio"].
Troubleshooting
- PATH:
rubocopon PATH (that is the invoked binary, notruby-lsp); reopen shell after install. rubocopnot found: the builtin fails even if theruby-lspgem is installed — install RuboCop withgem install rubocop.- Bundler mismatch: if the project pins RuboCop in its
Gemfile, run inside the bundle so versions match. - No diagnostics: check
.rubocop.ymlis valid and not disabling everything.
Verify
bun ../../scripts/verify-lsp.ts path/to/file.rb