# `mix chug.new`
[🔗](https://github.com/crayment/chug/blob/main/lib/mix/tasks/chug.new.ex#L4)

Creates a new pending changelog entry in the `changes/` directory.

## Usage

    mix chug.new --description "Fix session timeout" --category bug
    mix chug.new --description "Add export endpoint" --category feature --stories sc-1234,sc-5678

## Options

  * `--description` - (required) User-facing description of the change
  * `--category` - (required) Category for the change; must be one configured in `chug.config.yml`
  * `--stories` - (optional) Comma-separated story/ticket references

## Configuration

Reads `chug.config.yml` from the current working directory. The `categories` key
determines which category values are valid.

---

*Consult [api-reference.md](api-reference.md) for complete listing*