Plugins

Relicta’s plugin system lets you integrate with external services at any point in the release lifecycle. All official plugins are distributed separately and installed via the plugin registry.

Quick Start

# List all available plugins
relicta plugin list --available

# Install a plugin
relicta plugin install github

# Enable it
relicta plugin enable github

# View details
relicta plugin info github

Available Plugins

Relicta provides 30 official plugins across 6 categories:

Version Control

github - Create GitHub releases
gitlab - Create GitLab releases

Notifications

slack - Slack notifications
discord - Discord notifications
teams - Microsoft Teams
telegram - Telegram notifications

Package Managers

npm - npm registry
homebrew - Homebrew formulas
pypi - Python packages
chocolatey - Windows packages
winget - Windows Package Manager
linuxpkg - deb/rpm/apk
crates - Rust crates
nuget - .NET packages
maven - Java/Maven
rubygems - Ruby gems
hex - Elixir/Erlang
packagist - PHP/Composer
gomod - Go modules
swift-pm - Swift packages
pub - Dart/Flutter packages

Containers & Registries

docker - Build & push images
ecr - AWS ECR
gcr - Google Artifact Registry
acr - Azure Container Registry
helm - Helm charts

Project Management

jira - Jira versions
launchnotes - LaunchNotes
linear - Linear issues

DevOps

sentry - Sentry releases

Version Control

GitHub

Create GitHub releases and upload build artifacts automatically.

Config
Install

plugins:
  - name: github
    enabled: true
    config:
      draft: false
      prerelease: false
      generate_release_notes: false
      discussion_category: ""
      assets:
        - "dist/*.tar.gz"
        - "dist/*.zip"
        - "dist/checksums.txt"

relicta plugin install github
relicta plugin enable github

Environment: GITHUB_TOKEN (auto-set in GitHub Actions)

Hooks: PostPublish, OnSuccess, OnError

GitLab

Create GitLab releases with links to build artifacts.

Config
Install

plugins:
  - name: gitlab
    enabled: true
    config:
      project_id: "12345"
      url: "https://gitlab.com"

relicta plugin install gitlab
relicta plugin enable gitlab

Environment: GITLAB_TOKEN, CI_PROJECT_ID (auto-set in GitLab CI)

Hooks: PostPublish

Notifications

Slack

Send release notifications to Slack channels.

Config
Install

plugins:
  - name: slack
    enabled: true
    config:
      channel: "#releases"
      username: "Relicta Bot"
      notify_on_success: true
      notify_on_error: true

relicta plugin install slack
relicta plugin enable slack

Environment: SLACK_WEBHOOK_URL

Hooks: PostPublish, OnError

Discord

Send release notifications to Discord channels.

Config
Install

plugins:
  - name: discord
    enabled: true
    config:
      username: "Relicta Bot"
      avatar_url: "https://example.com/avatar.png"

relicta plugin install discord
relicta plugin enable discord

Environment: DISCORD_WEBHOOK_URL

Hooks: PostPublish, OnError

Microsoft Teams

Send release notifications to Microsoft Teams channels.

Config
Install

plugins:
  - name: teams
    enabled: true
    config:
      theme_color: "0076D7"
      notify_on_success: true
      notify_on_error: true

relicta plugin install teams
relicta plugin enable teams

Environment: TEAMS_WEBHOOK_URL

Hooks: PostPublish

Send release notifications to Telegram channels or groups.

Config
Install

plugins:
  - name: telegram
    enabled: true
    config:
      chat_id: "-1001234567890"
      parse_mode: "Markdown"
      disable_notification: false

relicta plugin install telegram
relicta plugin enable telegram

Environment: TELEGRAM_BOT_TOKEN

Hooks: PostPublish, OnError

Package Managers

npm

Publish packages to npm registry.

Config
Install

plugins:
  - name: npm
    enabled: true
    config:
      registry: "https://registry.npmjs.org"
      access: "public"
      tag: "latest"

relicta plugin install npm
relicta plugin enable npm

Environment: NPM_TOKEN, NPM_OTP (optional for 2FA)

Hooks: PrePublish, PostPublish

Homebrew

Update Homebrew formula with new release.

Config
Install

plugins:
  - name: homebrew
    enabled: true
    config:
      tap: "your-org/homebrew-tap"
      formula: "your-app"

relicta plugin install homebrew
relicta plugin enable homebrew

Environment: HOMEBREW_GITHUB_TOKEN

Hooks: PostPublish

PyPI

Publish Python packages to PyPI.

Config
Install

plugins:
  - name: pypi
    enabled: true
    config:
      repository: "https://upload.pypi.org/legacy/"
      dist_dir: "dist"
      skip_existing: false

relicta plugin install pypi
relicta plugin enable pypi

Environment: PYPI_USERNAME (use __token__), PYPI_PASSWORD

Hooks: PrePublish, PostPublish

Chocolatey

Publish packages to Chocolatey (Windows).

Config
Install

plugins:
  - name: chocolatey
    enabled: true
    config:
      package_id: "your-package"
      source: "https://push.chocolatey.org/"

relicta plugin install chocolatey
relicta plugin enable chocolatey

Environment: CHOCOLATEY_API_KEY

Hooks: PrePublish, PostPublish

Linux Packages

Build Linux packages (deb, rpm, apk).

Config
Install

plugins:
  - name: linuxpkg
    enabled: true
    config:
      formats: ["deb", "rpm", "apk"]
      maintainer: "Your Name <[email protected]>"
      description: "Package description"
      binaries:
        - "bin/myapp"

relicta plugin install linuxpkg
relicta plugin enable linuxpkg

Hooks: PrePublish, PostPublish

crates.io

Publish Rust crates to crates.io.

Config
Install

plugins:
  - name: crates
    enabled: true
    config:
      manifest_path: "Cargo.toml"
      allow_dirty: false

relicta plugin install crates
relicta plugin enable crates

Environment: CARGO_REGISTRY_TOKEN

Hooks: PrePublish, PostPublish

NuGet

Publish .NET packages to NuGet.

Config
Install

plugins:
  - name: nuget
    enabled: true
    config:
      source: "https://api.nuget.org/v3/index.json"
      skip_duplicate: false

relicta plugin install nuget
relicta plugin enable nuget

Environment: NUGET_API_KEY

Hooks: PrePublish, PostPublish

Maven Central

Publish Java packages to Maven Central.

Config
Install

plugins:
  - name: maven
    enabled: true
    config:
      group_id: "com.example"
      artifact_id: "my-artifact"
      pom_path: "pom.xml"

relicta plugin install maven
relicta plugin enable maven

Environment: MAVEN_USERNAME, MAVEN_PASSWORD, GPG_KEY_ID (optional)

Hooks: PrePublish, PostPublish

RubyGems

Publish Ruby gems to RubyGems.org.

Config
Install

plugins:
  - name: rubygems
    enabled: true
    config:
      host: "https://rubygems.org"

relicta plugin install rubygems
relicta plugin enable rubygems

Environment: GEM_HOST_API_KEY

Hooks: PrePublish, PostPublish

Hex.pm

Publish Elixir/Erlang packages to Hex.pm.

Config
Install

plugins:
  - name: hex
    enabled: true
    config:
      organization: ""
      replace: false
      mix_path: "mix.exs"

relicta plugin install hex
relicta plugin enable hex

Environment: HEX_API_KEY

Hooks: PrePublish, PostPublish

Packagist

Publish PHP packages to Packagist.

Config
Install

plugins:
  - name: packagist
    enabled: true
    config:
      package_name: "vendor/package"

relicta plugin install packagist
relicta plugin enable packagist

Environment: PACKAGIST_API_TOKEN, PACKAGIST_USERNAME

Hooks: PostPublish

Go Modules

Publish Go modules and notify the module proxy.

Config
Install

plugins:
  - name: gomod
    enabled: true
    config:
      module_path: "github.com/user/repo"
      private: false

relicta plugin install gomod
relicta plugin enable gomod

Hooks: PrePublish, PostPublish

Winget

Publish packages to Windows Package Manager (winget).

Config
Install

plugins:
  - name: winget
    enabled: true
    config:
      package_id: "Publisher.AppName"
      manifest_path: "manifests/"
      installer_url: "https://github.com/org/repo/releases/download/{{version}}/app.exe"

relicta plugin install winget
relicta plugin enable winget

Environment: GITHUB_TOKEN (for PR creation)

Hooks: PostPublish

Swift Package Manager

Publish Swift packages.

Config
Install

plugins:
  - name: swift-pm
    enabled: true
    config:
      package_path: "Package.swift"

relicta plugin install swift-pm
relicta plugin enable swift-pm

Hooks: PrePublish, PostPublish

Pub (Dart/Flutter)

Publish Dart and Flutter packages to pub.dev.

Config
Install

plugins:
  - name: pub
    enabled: true
    config:
      dry_run: false
      force: false

relicta plugin install pub
relicta plugin enable pub

Environment: PUB_CREDENTIALS (from dart pub login)

Hooks: PrePublish, PostPublish

Project Management

Jira

Create and link Jira release versions. Automatically detects issue keys in commits.

Config
Install

plugins:
  - name: jira
    enabled: true
    config:
      url: "https://yourcompany.atlassian.net"
      project: "PROJ"
      create_version: true
      release_version: true

relicta plugin install jira
relicta plugin enable jira

Environment: JIRA_USERNAME, JIRA_TOKEN

Hooks: PostPublish

LaunchNotes

Create releases in LaunchNotes for customer-facing announcements.

Config
Install

plugins:
  - name: launchnotes
    enabled: true
    config:
      project_id: "proj_123"
      auto_publish: false
      categories:
        feat: "new-features"
        fix: "bug-fixes"

relicta plugin install launchnotes
relicta plugin enable launchnotes

Environment: LAUNCHNOTES_API_KEY

Hooks: PostPublish

Linear

Create and link Linear issues to releases. Automatically detects issue IDs in commits.

Config
Install

plugins:
  - name: linear
    enabled: true
    config:
      team_id: "TEAM-123"
      project_id: "PROJECT-456"
      create_release: true

relicta plugin install linear
relicta plugin enable linear

Environment: LINEAR_API_KEY

Hooks: PostPublish

Containers & Registries

Docker

Build and push Docker images to container registries.

Config
Install

plugins:
  - name: docker
    enabled: true
    config:
      registry: "docker.io"
      image: "username/myapp"
      tags:
        - "{{version}}"
        - "{{major}}.{{minor}}"
        - "latest"
      platforms:
        - "linux/amd64"
        - "linux/arm64"
      dockerfile: "Dockerfile"
      context: "."
      push: true

relicta plugin install docker
relicta plugin enable docker

Environment: DOCKER_USERNAME, DOCKER_PASSWORD

Hooks: PrePublish, PostPublish

Tag variables: {{version}}, {{major}}, {{minor}}, {{patch}}

AWS ECR

Push container images to Amazon Elastic Container Registry.

Config
Install

plugins:
  - name: ecr
    enabled: true
    config:
      registry: "123456789.dkr.ecr.us-east-1.amazonaws.com"
      repository: "myapp"
      tags:
        - "{{version}}"
        - "latest"

relicta plugin install ecr
relicta plugin enable ecr

Environment: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION

Hooks: PrePublish, PostPublish

Google Artifact Registry

Push container images to Google Artifact Registry (GAR/GCR).

Config
Install

plugins:
  - name: gcr
    enabled: true
    config:
      project: "my-gcp-project"
      location: "us-central1"
      repository: "myapp"
      tags:
        - "{{version}}"
        - "latest"

relicta plugin install gcr
relicta plugin enable gcr

Environment: GOOGLE_APPLICATION_CREDENTIALS or GCLOUD_SERVICE_KEY

Hooks: PrePublish, PostPublish

Azure Container Registry

Push container images to Azure Container Registry.

Config
Install

plugins:
  - name: acr
    enabled: true
    config:
      registry: "myregistry.azurecr.io"
      repository: "myapp"
      tags:
        - "{{version}}"
        - "latest"

relicta plugin install acr
relicta plugin enable acr

Environment: AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID

Hooks: PrePublish, PostPublish

Helm

Package and publish Helm charts to OCI registries or chart repositories.

Config
Install

plugins:
  - name: helm
    enabled: true
    config:
      chart_path: "charts/myapp"
      registry: "oci://ghcr.io/myorg/charts"
      push: true

relicta plugin install helm
relicta plugin enable helm

Environment: HELM_REGISTRY_USERNAME, HELM_REGISTRY_PASSWORD

Hooks: PrePublish, PostPublish

DevOps

Sentry

Track releases and deployments in Sentry for error monitoring.

Config
Install

plugins:
  - name: sentry
    enabled: true
    config:
      organization: "my-org"
      project: "my-project"
      environment: "production"
      set_commits: true

relicta plugin install sentry
relicta plugin enable sentry

Environment: SENTRY_AUTH_TOKEN, SENTRY_ORG

Hooks: PostPublish

Plugin Lifecycle

Plugins execute at specific hooks during the release process:

PreInit → PostInit → PrePlan → PostPlan → PreVersion → PostVersion
  → PreNotes → PostNotes → PreApprove → PostApprove → PrePublish
  → PostPublish → OnSuccess → OnError

Most plugins run at PostPublish after the release is tagged. Some run at PrePublish for validation or preparation.

Creating Custom Plugins

Build your own plugins using the Plugin SDK.

# Create a new plugin
relicta plugin create my-plugin
cd my-plugin

# Build and test
go build -o my-plugin
relicta plugin test my-plugin

Plugin Interface

package main

import (
    "context"
    "github.com/relicta-tech/relicta-plugin-sdk/helpers"
    "github.com/relicta-tech/relicta-plugin-sdk/plugin"
)

type MyPlugin struct{}

func (p *MyPlugin) GetInfo() plugin.Info {
    return plugin.Info{
        Name:        "my-plugin",
        Version:     "1.0.0",
        Description: "My custom plugin",
        Author:      "Your Name",
        Hooks:       []plugin.Hook{plugin.HookPostPublish},
    }
}

func (p *MyPlugin) Execute(ctx context.Context, req plugin.ExecuteRequest) (*plugin.ExecuteResponse, error) {
    parser := helpers.NewConfigParser(req.Config)
    // ... plugin logic
    return &plugin.ExecuteResponse{Success: true}, nil
}

func (p *MyPlugin) Validate(ctx context.Context, config map[string]any) (*plugin.ValidateResponse, error) {
    return &plugin.ValidateResponse{Valid: true}, nil
}

func main() {
    plugin.Serve(&MyPlugin{})
}

Best Practices

Test with dry run first
Terminal window
```
relicta publish --dry-run
```
Validate configuration
Terminal window
```
relicta validate
```

Enable error notifications

plugins:
  - name: slack
    config:
      notify_on_error: true

Enable plugins incrementally - Add one plugin at a time to identify issues.
Pin plugin versions for reproducible releases:
Terminal window
```
relicta plugin install [email protected]
```