Video Tutorials

Learn Relicta through these hands-on video tutorials. Each tutorial focuses on a specific aspect of the release workflow.

Quick Start (Recommended)

New to Relicta? This video shows you how to go from install to your first release in under 2 minutes.

What you’ll learn:

• Installing Relicta with Homebrew
• Initializing your project with relicta init
• Running your first release with relicta release

---

6. One-Command Release (v2.6.0+)

The easiest way to release: one command that does everything.

What you’ll learn:

• Using relicta release for the complete workflow
• Understanding the 5 automated steps (plan → bump → notes → approve → publish)
• Key flags: --yes, --dry-run, --force, --skip-push
• When to use one-command vs step-by-step

---

CI/CD Integration

Set up automated releases with GitHub Actions.

What you’ll learn:

• Creating a GitHub Actions workflow
• Using relicta-action for automated releases
• Triggering releases on push to main
• Monitoring release workflows

---

1. Basic Release Workflow

Get started with the core release commands: plan, bump, notes, approve, and publish.

What you’ll learn:

• Analyzing commits with relicta plan
• Bumping the version with relicta bump
• Generating release notes with relicta notes
• Approving a release with relicta approve
• Publishing with relicta publish

---

2. GitHub Plugin Setup

Install and configure the GitHub plugin to automate GitHub releases.

What you’ll learn:

• Listing available plugins
• Installing the GitHub plugin
• Configuring the plugin in release.config.yaml
• Setting up release assets

---

3. Multi-Platform Publishing

Configure multiple plugins to publish releases to different platforms simultaneously.

What you’ll learn:

• Installing multiple plugins (GitHub, npm, Slack)
• Configuring multi-platform publishing
• Setting up notification webhooks
• Running a coordinated release

---

4. AI-Powered Release Notes

Use AI to automatically generate professional release notes from your commits.

What you’ll learn:

• Configuring AI providers (OpenAI, Anthropic, Ollama)
• Generating AI-powered release notes
• Reviewing and approving AI-generated content
• Customizing tone and audience

---

AI vs Template Notes Comparison

See the quality difference between template-based and AI-powered release notes.

📝 Template Notes (technical, developer-focused):

## Features
- **api:** redesign API
- **auth:** add login functions

## Bug Fixes
- **app:** add farewell function

✨ AI-Powered Notes (user-friendly, contextual):

## Breaking Changes
Complete API redesign for better performance.
See migration guide for upgrade instructions.

## What's New
Authentication system with login, logout,
and session management.

Key differences:

• Template notes: Lists commit messages verbatim, technical and developer-focused
• AI notes: Summarizes meaningfully, explains user impact, adds migration guidance

Enable AI notes with: relicta notes --ai or relicta release -y --ai

---

Working with Messy Commits

Relicta works great even without perfect conventional commits!

Conventional commits (ideal):

feat(auth): add login and logout functions
fix(api): resolve token expiration bug
docs: update API documentation

Messy commits (real world):

wip
fixed the thing
Update auth.js
actually fixed it this time lol
BREAKING: new api!!!

Relicta uses intelligent heuristics to:

• Detect keywords like “BREAKING”, “fix”, “add”
• Identify fix-like patterns in any commit message
• Group related changes automatically
• Fall back to patch for unclear commits
• Use AI to summarize chaotic history into professional notes

Pro tip: Use relicta notes --ai on messy repositories for best results!

---

5. Custom Plugin Development

Build your own plugin to extend Relicta’s functionality.

What you’ll learn:

• Creating a plugin project with relicta plugin create
• Understanding the plugin structure
• Building and testing your plugin
• Installing a local plugin

---

MCP: AI-Managed Releases

Use Relicta with AI agents like Claude for natural language release management.

🤖 Claude Desktop + Relicta:

You: "What's the release status?"
Claude: "4 commits pending, suggests v2.0.0 (major)"

You: "Generate notes and publish"
Claude: "✓ v2.0.0 published. GitHub release created."

Setup (Claude Desktop):

{
  "mcpServers": {
    "relicta": {
      "command": "relicta",
      "args": ["mcp", "serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

Available MCP tools:

Tool	Description
relicta.status	Get current release state
relicta.plan	Analyze commits and suggest version
relicta.bump	Calculate and set version
relicta.notes	Generate release notes
relicta.evaluate	CGP risk assessment
relicta.approve	Approve release
relicta.publish	Execute release

See the full MCP Integration Guide for detailed configuration.

---

Quick Reference

Tutorial	Duration	Topics
Quick Start	~1 min	install, init, first release
One-Command Release	~2 min	relicta release, flags, workflow
CI/CD Integration	~1 min	GitHub Actions, automation
MCP Integration	-	Claude Desktop, AI agents
Basic Workflow	~2 min	plan, bump, notes, approve, publish
GitHub Plugin	~2 min	plugin install, configuration
Multi-Platform	~2 min	multiple plugins, notifications
AI Notes	~1 min	AI configuration, note generation
Custom Plugin	~2 min	plugin development, local install
AI vs Template	-	Quality comparison
Messy Commits	-	Heuristic handling

Next Steps

• Install the CLI to get started
• Read the workflow guide for detailed command reference
• Explore plugins to see all available integrations