Skip to content

GitHub Actions

Automate your release workflow with the releasio GitHub Action.


Overview

The releasio action provides:

  • Automatic Python & tool installation
  • Git configuration for commits
  • Trusted publishing support (OIDC)
  • Full CLI access

  • Minimal Setup


    Get started with a simple two-job workflow

    Minimal

  • Full Workflow


    Extended workflow with manual triggers

    Full Workflow

  • Action Reference


    All inputs, outputs, and options

    Reference


Basic Usage

- uses: mikeleppane/releasio@v2
  with:
    command: release-pr
    github-token: ${{ secrets.GITHUB_TOKEN }}

Commands

Command Description
check Preview release (dry-run)
release-pr Create/update release PR
release Tag and publish
do-release Complete workflow
check-pr Validate PR title

Permissions Required

permissions:
  contents: write       # Create tags and releases
  pull-requests: write  # Create and update PRs
  id-token: write       # PyPI trusted publishing (OIDC)

Repository Settings

Enable these settings for full functionality:

  1. SettingsActionsGeneral
  2. ✅ "Allow GitHub Actions to create and approve pull requests"