# coc-groovy

> Groovy langauage extension for coc.nvim

Latest version **1.5.0** (published 2025-07-02) · EPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install coc-groovy
pnpm add coc-groovy
yarn add coc-groovy
bun add coc-groovy
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support; large bundle.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 1.5.0 |
| Published | 2025-07-02 |
| First published | 2020-04-09 |
| Weekly downloads | 0 |
| License | EPL-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18.20.0 |
| Dependencies | 0 |
| Unpacked size | 15.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 25 |
| Author | dansomething |
| Maintainers | dansomething |
| Keywords | coc.nvim, groovy, languageserver |

## Links

- npm: https://www.npmjs.com/package/coc-groovy
- Repository: https://github.com/dansomething/coc-groovy
- Homepage: https://github.com/dansomething/coc-groovy#readme
- Issues: https://github.com/dansomething/coc-groovy/issues
- npm.io page: https://npm.io/package/coc-groovy

## Recent versions

- 1.5.0 (latest) — 2025-07-02
- 1.4.0 — 2025-06-05
- 1.3.0 — 2023-06-20
- 1.2.1 — 2023-06-20
- 1.2.0 — 2022-08-08
- 1.1.0 — 2022-02-25
- 1.0.0 — 2021-05-15
- 0.2.2 — 2020-12-19
- 0.2.1 — 2020-10-16
- 0.2.0 — 2020-08-10
- 0.1.3 — 2020-04-13
- 0.1.2 — 2020-04-09
- 0.1.1 — 2020-04-09

## README

# coc-groovy

An [extension for coc.nvim](https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions) to enable
[Groovy language server](https://github.com/prominic/groovy-language-server) support.

## Features

- Maven and Gradle project support
- Code Completion
- Find References
- Go to Definition
- Highlights
- Refactor Rename
- Signature Hover

## Quick Start

1. Download and install a recent Java Development Kit (latest Java 8 is the minimum requirement).
2. Install this extension by running this command in Vim:

   ```sh
   :CocInstall coc-groovy
   ```

3. This extension is activated when you first open a Groovy file.

## Dependencies

### Maven Projects

Maven project support requires having the [Maven Wrapper][0] installed in your
project or having [Maven][1] installed on your environment path.

- [Maven Wrapper][0]
- [Installing Maven][1]

## Available commands

The following coc.nvim commands are available:

- `groovy.project.config.update` : This is available when the editor is focused on a Groovy file. It forces project configuration/classpath updates (eg. dependency changes) according to the project build descriptor.

## Supported settings

The following settings are supported:

- `groovy.enable` : Enable the coc-groovy extension, default: `true`
- `groovy.java.home` : The absolute path to the JDK 8+ home directory. This is used to launch the Groovy language server. Requires a coc server restart.
- `groovy.ls.vmargs` : Extra Java VM arguments used to launch the Groovy language server. Requires a coc server restart.
- `groovy.ls.home` : The absolute path to the Groovy language server. This would be used instead of the bundled server when specified.
- `groovy.project.referencedLibraries` : Configure additional paths (jar file or directory) for referencing libraries in a Groovy project. Note, Maven and Gradle projects will have their classpath automatically added.
  - Example: `["/path/to/lib.jar", "/path/to/lib/*"]`
- `groovy.trace.server` : Traces the communication between the coc-groovy extension and the Groovy language server.
- `groovy.noRoot` (Experimental): Enables language server features for standalone Groovy files (for when no Maven or Gradle project root is available). Set this in the global CoC configuration. Default: `false`

## Setting the JDK

The path to the Java Development Kit is searched in the following order:

1. The `groovy.java.home` setting in coc.nvim settings (workspace then user settings).
2. The `JDK_HOME` environment variable.
3. The `JAVA_HOME` environment variable.
4. The current system path.

## License

EPL 2.0, See [LICENSE](LICENSE) for more information.

[0]: https://maven.apache.org/wrapper/
[1]: https://maven.apache.org/install.html

---
_Source: https://npm.io/package/coc-groovy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._