Actionary

Actionary is a Visual Studio Code extension that adds rich hovers to uses: entries in GitHub Actions workflow files. Hover any action reference to see the resolved repository, commit SHA, current version, latest release, and a hint when a newer version is available -- without leaving the editor.

Works with public GitHub and GitHub Enterprise Server.

Quick Start

1. Install Actionary (goeselt.actionary) from the Visual Studio Code Extensions view.
2. Open a workflow file under .github/workflows/.
3. Hover any uses: reference.

Example workflow line:

- uses: actions/checkout@v5

Hovering the reference shows the action repository, the resolved commit SHA, the inferred version, a link to the latest release, and a clear text hint when a newer version is available.

Where It Works

Actionary runs only for files that match both conditions below:

• Filename is action.yml or action.yaml (path is ignored), or file path contains .github/workflows/ (including subdirectories)
• File extension is .yml or .yaml

The editor language mode must be recognized as yaml or github-actions-workflow.

If hover information does not appear:

1. Check the language mode in the Visual Studio Code status bar (bottom right).
2. Change it to YAML or GitHub Actions Workflow.
3. Ensure the filename is action.yml/action.yaml or the path contains .github/workflows/ (subdirectories are supported), and uses .yml or .yaml.

Features

• Resolves branches, tags, and short SHAs to the full commit SHA.
• Links the action repository, commit, and matching tag or release on GitHub.
• Reports the latest release (or newest tag) and flags when a newer version exists.
• Supports sub-action references such as docker/login-action/path@v3.
• Supports GitHub Enterprise Server hosts in addition to github.com.
• Skips local actions (./...) and Docker image actions (docker://...) by design.
• Caches metadata to keep API usage low.

Settings

Example for a mixed public and GitHub Enterprise Server setup:

"actionary.githubHosts": [
  "github.com",
  "github.company.example"
]

For github.com, Actionary calls https://api.github.com. For GitHub Enterprise Server hosts, it calls https://<host>/api/v3.

Requirements

• Visual Studio Code 1.120.0 or newer.
• Network access to the configured GitHub hosts.

Actionary only contacts the configured GitHub hosts to look up the referenced action repository, ref, and release metadata. Workflow contents are not sent anywhere else.

Further Reading

• Maintenance and packaging notes: docs/housekeeping.md

License

LICENSE