Skip to content
play

GitHub Action

Setup Hayagriva

v1.0.2 Latest version

Setup Hayagriva

play

Setup Hayagriva

🏷️ Installs the Hayagriva CLI for GitHub Actions

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Setup Hayagriva

uses: typst-community/[email protected]

Learn more about this action in typst-community/setup-hayagriva

Choose a version

Setup Hayagriva

🏷️ Installs the Hayagriva CLI for GitHub Actions

- uses: jcbhmr/setup-hayagriva@v1
- run: hayagriva literature.yml reference --style apa

✅ Installs the hayagriva CLI globally
📌 Supports version pinning
⚡ Caches the compiled binary using @actions/cache
📥 Downloads from the Hayagriva GitHub releases

Usage

GitHub Actions GitHub

🚀 Here's what you're after:

on: push
jobs:
  job:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jcbhmr/setup-hayagriva@v1
      - run: hayagriva literature.yml reference

Inputs

  • hayagriva-version: Which version of Hayagriva to install. This can be an exact version specifier such as 0.5.1 or a semver range like ~0.5.0 or 0.x. Use latest to always install the latest release. Defaults to latest.

  • hayagriva-token: The GitHub token to use when fetching the version list from typst/hayagriva. You shouldn't have to touch this. The default is the github.token if you're on github.com or unauthenticated (rate limited) if you're not on github.com.

  • cache: Whether or not to use the workflow cache to cache the compiled hayagriva binary for future runs.

Outputs

  • hayagriva-version: The version of Hayagriva that was installed. This will be something like 0.5.1 or similar.

  • cache-hit: Whether or not Hayagriva was restored from the runner's cache or download anew.

Development

Bun GitHub Actions

This GitHub Action uses Bun to bundle the main entry point plus all the imported dependencies into a single .js file ready to be run by main: dist/main.js in the action.yml. To test the action just open a PR (even a draft one) and some magic GitHub Actions will test your changes. 🧙‍♂️

ℹ Once Bun gets Windows support make sure you add back the runs-on: windows-latest test to test-action.yml.