Skip to content

Using Herb with Helix

Integrate the Herb Language Server with Helix for HTML+ERB development.

Herb with Helix

Installation

First, install the Herb Language Server globally:

bash
npm install -g @herb-tools/language-server
bash
yarn global add @herb-tools/language-server
bash
pnpm add -g @herb-tools/language-server
bash
bun add -g @herb-tools/language-server

Configuration

Configure Helix to use the Herb Language Server by adding the following to your ~/.config/helix/languages.toml:

~/.config/helix/languages.toml
toml
[language-server.herb]
command = "herb-language-server"
args = ["--stdio"]

[[language]]
name = "erb"
language-servers = ["herb"]
file-types = ["erb", "html.erb"]
roots = ["Gemfile", "package.json"]

Troubleshooting

Debugging

To debug language server issues, you can:

  1. Check Helix logs: hx -vvv to run Helix with verbose logging
  2. View the log file: usually located at ~/.cache/helix/helix.log
  3. Look for language server errors in the output

Additional Resources

Released under the MIT License.