gh-actions-language-server

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #go #rust #nodejs #windows #kubernetes #awesome-list #vue #pytorch #security #mcp

gh-actions-language-server

(★ 64)

Github Actions Language Server

gh-actions-language-server Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# gh-actions-language-server

**GitHub Actions Language Server**

A lightweight wrapper around [@actions/languageserver](https://github.com/actions/languageservices/tree/main/languageserver) to simplify installation and usage in CLI tools and LSP (Language Server Protocol) clients.

> [!IMPORTANT]
> **January 2026**
> 
> The official [@actions/languageserver](https://github.com/actions/languageservices/tree/main/languageserver) standalone executable is available as of `v0.3.30` - https://github.com/actions/languageservices/issues/56#issuecomment-3705109878.
>
> The Mason Registry (`gh-actions-language-server`) has been updated to reflect it too - https://github.com/mason-org/mason-registry/pull/13000.
>
> Please follow the [official README.md](https://github.com/actions/languageservices/tree/main/languageserver#in-neovim) and guidelines to configure GitHub Actions in Neovim.

## Why?

The `@actions/languageserver` module is published without an executable binary (see [issue #56](https://github.com/actions/languageservices/issues/56)), which makes it less convenient to use directly. This package bridges that gap by providing an easy-to-install binary.

Initially, the plan was to contribute a pull request to `@actions/languageserver` to add a `bin` field. However, it seems that configuring package exports for this purpose requires some adjustments, so creating this standalone package was a quicker solution.

_Note:_ This package may be archived and deprecated once native support for a `bin` executable is added to `@actions/languageserver`.

## Installation

To install globally via npm, run:

```
npm install --global gh-actions-language-server
```

## Configuration for Neovim

### Add `yaml.github` filetype detection

Create a a file at `ftdetect/github-actions.lua` with:

```lua
vim.filetype.add({
  pattern = {
    ['.*/%.github[%w/]+workflows[%w/]+.*%.ya?ml'] = 'yaml.github',
  },
})
```

### Configure Language Server

> [!NOTE]
> Once these PRs get merged, `mason` and `nvim-lspconfig` should support `gh-actions-language-server` out of the box:
>
> - https://github.com/neovim/nvim-lspconfig/pull/3551
> - https://github.com/williamboman/mason-lspconfig.nvim/pull/506
> - https://github.com/mason-org/mason-registry/pull/8497

If you're using [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig), you can configure the `gh-actions-language-server` as follows:

#### Define the Language Server Configuration

Create a new configuration file at `lua/lspconfig/configs/gh_actions_ls.lua` with the following content:

````lua
local util = require('lspconfig.util')

return {
  default_config = {
    cmd = { 'gh-actions-language-server', '--stdio' },
    filetypes = { 'yaml.github' },
    root_dir = util.root_pattern('.github'),
    single_file_support = true,
    capabilities = {
      workspace = {
        didChangeWorkspaceFolders = {
          dynamicRegistration = true,
        },
      },
    },
  },
  docs = {
    description = [[
https://github.com/lttb/gh-actions-language-server
Language server for GitHub Actions.
`gh-actions-language-server` can be installed via `npm`:
```sh
npm install -g gh-actions-language-server
```
]],
  },
}
````

#### Initialise the Language Server

Add the following code to initialise the language server:

```lua
require('lspconfig').gh_actions_ls.setup({})
```

## Credits

- <https://github.com/actions/languageservices>

gh-actions-language-server

gh-actions-language-server Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gh-actions-language-server

gh-actions-language-server Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README