Skip to content

AGENTS.md

Eris

CLI that generates user-facing changelogs from git commit messages and tags, using AI to rewrite raw commits into readable release notes.

Design

  • Parse commits/tags → build an intermediate representation (IR) stored as TOML.
  • IR is stable and reviewable before AI/rendering.
  • Multiple IR TOML files can be combined into a single changelog.
  • Run interactively (prompts) or in CI (flags/args/env, no prompts).

Conventions

  • Rust, edition 2024. Arg parsing via the internal nanoargs module.
  • Use mise tasks: mise run verify (fmt-check + lint + test) before finishing.
  • Every feature/behaviour must be covered by tests.