# remeris

> remeris is a release tool written in Go. It reads Knope's knope.toml, changeset files and Git tags, so it can replace Knope in an existing project.

## Docs

- [remeris: a Go release tool, drop-in for Knope](https://remeris.dev/): remeris is a release tool written in Go. It reads Knope's knope.toml, changeset files and Git tags, so it can replace Knope in an existing project.

## Guide

- [Usage](https://remeris.dev/docs/usage): How to run remeris: the command line, global flags and workflow options, --generate, --upgrade and --validate, environment variables, credentials, exit codes
- [Configuration](https://remeris.dev/docs/configuration): Every knope.toml setting remeris reads: packages, versioned files, changes, release notes, forge settings, workflows and each step with its fields.
- [Differences from Knope](https://remeris.dev/docs/differences): Where remeris differs from Knope 0.23.1: full SemVer 2.0 support, credential storage, GitHub App authentication, fast-forward-only rebase and more.

## Maintainers

- [Maintaining the repository](https://remeris.dev/docs/maintaining): Maintainer guide for the remeris repository: settings, Discussions, labels, rulesets, Actions, security, Renovate, issue triage and the contributor checklist.
- [Releasing](https://remeris.dev/docs/releasing): How remeris releases itself with its own knope.toml: the GitHub Actions workflows, one-time setup, cutting a release and verifying downloads with cosign.

## For implementers

- [Remeris: spec for a Go reimplementation of Knope](https://remeris.dev/docs/spec): The specification for remeris, a Go reimplementation of Knope: milestones, feature behaviour, the quirks register and the design decisions.

## Agent skills

- [remeris](https://remeris.dev/.well-known/agent-skills/remeris/SKILL.md): Read the remeris docs instead of answering from memory. remeris is a release tool written in Go. It reads Knope's knope.toml, changeset files and Git tags, so it can replace Knope in an existing project. Use when a task involves remeris: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://remeris.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://remeris.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://remeris.dev/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://remeris.dev/openapi.json.
- [Agent skills](https://remeris.dev/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://remeris.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://remeris.dev/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://remeris.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://remeris.dev/sitemap.xml): Every indexable page URL with its last-modified date.