# Install solargraph with Homebrew, Nix Ruby language server. Version 0.60.2 via Homebrew; verified 2026-06-28. ## Install ```sh sudo av install brew:solargraph ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install solargraph ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#solargraph ``` Evidence: nixpkgs package indexes: solargraph from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix ## Package facts - **Package key:** brew:solargraph - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.60.2 - **Source summary:** Ruby language server - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-28T04:59:39Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - solargraph (cli) - solargraph (alias) ## Dependencies - ruby - xz ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 0.60.2 - Package-manager updated: 2026-06-28 - Local data: ok - Upstream repository: https://github.com/castwide/solargraph - info: No cached GitHub release or tag data was available. ## Project history and usage Solargraph is a Ruby language server distributed as a gem and packaged for developer environments that want Ruby autocomplete, diagnostics, inline documentation, and type-aware editor support. ### Project history The castwide/solargraph GitHub repository was created in March 2017, and RubyGems records version 0.1.0 on 2017-03-18. The gem was described early as IDE tools for code analysis and autocompletion, while the current README frames it as a Ruby language server. Solargraph grew with the Language Server Protocol era. The README lists Visual Studio Code, Sublime Text, Vim and Neovim, Emacs, and Eclipse integrations, and the guide site describes editor integration as requiring a language client. The project later expanded beyond autocomplete into diagnostics, inline documentation, type checking, YARD and RBS-aware code maps, Bundler-aware gem support, plugin support, and a separate documentation cache. ### Adoption history RubyGems is Solargraph's primary distribution channel, with the official gem metadata pointing to solargraph.org and the GitHub source. Homebrew and Nix packages make the same CLI available to users who prefer system package managers over gem install. Editor integration drove adoption: the official README calls the VS Code extension out directly and lists third-party integrations for several common editors, making solargraph a common bridge between Ruby projects and LSP-capable editors. ### How it is used Developers install the solargraph command, generate or maintain project configuration with bundle exec solargraph config, and run the server through editor integrations using stdio or TCP socket modes. Project-local configuration lives in .solargraph.yml at the repository root, with optional global configuration at ~/.config/solargraph/config.yml. The README also documents a cache directory at ~/.cache/solargraph and Bundler-aware usage with bundle exec solargraph socket or stdio. ### Why package nerds care Solargraph matters to package nerds because it turns Ruby's dynamic runtime, gems, YARD docs, RBS signatures, Bundler context, and editor protocols into one packaged CLI service. It also illustrates a packaging split familiar to language ecosystems: the upstream artifact is a Ruby gem, but system package managers package it so editors and shell environments can depend on a stable solargraph executable. ### Timeline - 2017-03: GitHub repository and RubyGems 0.1.0 release appear. - 2017-2020s: Solargraph becomes a Ruby LSP server integrated by VS Code and other editors. - 2019: Version 0.33.0 adds type-checking functionality, according to the README. - 2026: RubyGems lists Solargraph 0.60.2 with Ruby 3.1+ requirements and current source metadata. ### Related projects - Language Server Protocol: the editor integration protocol Solargraph targets. - YARD and RBS: documentation and type-information sources Solargraph uses for code maps. - Bundler: important for running Solargraph in the same dependency context as a Ruby project. - vscode-solargraph, nvim-lspconfig, coc-solargraph, eglot, and lsp-mode: editor integration paths listed by the upstream README. ### Sources - current_curation.config-file-location - - - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for solargraph. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: .solargraph.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** solargraph - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - solargraph: normalized package name match | nixpkgs package indexes: solargraph from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix ## Related links - [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [ruby](https://www.automicvault.com/pkg/brew/ruby/) - Runtime dependency declared by Homebrew. - [xz](https://www.automicvault.com/pkg/brew/xz/) - Runtime dependency declared by Homebrew. - [emmylua_ls](https://www.automicvault.com/pkg/brew/emmylua-ls/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp, static-analysis. - [erlang-language-platform](https://www.automicvault.com/pkg/brew/erlang-language-platform/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp, static-analysis. - [lua-language-server](https://www.automicvault.com/pkg/brew/lua-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp, static-analysis. - [python-lsp-server](https://www.automicvault.com/pkg/brew/python-lsp-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp, static-analysis. - [ruby-lsp](https://www.automicvault.com/pkg/brew/ruby-lsp/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp, ruby. - [ansible-language-server](https://www.automicvault.com/pkg/brew/ansible-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp. - [bash-language-server](https://www.automicvault.com/pkg/brew/bash-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp. - [clojure-lsp](https://www.automicvault.com/pkg/brew/clojure-lsp/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp. ## Combined YAML source View the package source record on GitHub. [combined/solargraph.yml](https://github.com/automic-vault/db/blob/main/combined/solargraph.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph