Create a plugin

A plugin is a GitHub repository with a rencal-plugin.toml manifest at its root. It can contribute themes, calendar providers, or both.

id = "alice.dusk"
name = "Dusk"
description = "A quiet dark theme for renCal"
min_rencal_version = "0.8.0"

[[contributes.themes]]
id = "dark"
name = "Dusk Dark"
css = "theme.css"
appearance = "dark"

The id is <github-owner>.<plugin-name>, in lowercase, and the owner must match the account that hosts the repository.

Build it with an agent

renCal ships a skill that teaches coding agents like Claude Code and Codex to build plugins. On Linux, install it with:

rencal skill install

Or copy it from GitHub into your agent’s skills directory. Then ask your agent something like “Make a renCal theme based on Tokyo Night”.

Test it locally

Add the path to your checkout to ~/.config/rencal/plugins.toml:

plugins = [
  "~/dev/rencal-dusk",
]

Edits show up immediately, and any manifest errors appear in Settings → Plugins.