Editor support (goozels)

goozels is the Language Server for Gooze. It runs in front of gopls, so you keep all your normal Go features and get Gooze ones on top — autocompletion, hovers, live validation, and one-click mutation runs.

What you get

  • Completion, hover docs, and a warning for unknown names inside//gooze:ignore comments.
  • Key/value completion, hover, and validation for yourgooze.yaml config.
  • ▶ gooze run, gooze list, and 📊 gooze report code lenses at the top of every Go file.
  • Mutation scores from your reports shown inline after a run.

What you need

  • Go installed on your machine.
  • gopls on your PATH:
go install golang.org/x/tools/gopls@latest

Gooze itself is only needed for the run / report actions.

Install goozels

go install gooze.dev/pkg/goozels/cmd/goozels@latest

This puts a goozels binary in your Go bin directory. goozels finds gopls and gooze on your PATH automatically.

VS Code

Tell the Go extension to launch goozels instead of gopls (it proxies gopls for you):

{
  "go.alternateTools": {
    "gopls": "goozels"
  }
}

Neovim

Point your Go LSP config at the goozels binary instead of gopls, and attach it to gooze config files. See editors/neovim.md.

JetBrains (GoLand / IntelliJ)

Register goozels through the LSP4IJ plugin. See editors/jetbrains.md.