> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ooneex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# release:create

> Release packages with version bump, changelog, and git tag.

Release packages and modules by inspecting the conventional commits since each one's last tag. For every target with unreleased commits, the command determines the version bump, updates `package.json` and `CHANGELOG.md`, commits the changes, and creates an annotated git tag.

## Usage

```bash theme={null}
ooneex release:create [options]
```

## Examples

```bash theme={null}
ooneex release:create
```

```bash theme={null}
ooneex release:create --module=cli
```

## Options

| Option     | Description                                                | Default                  |
| ---------- | ---------------------------------------------------------- | ------------------------ |
| `--module` | Limit the release to the package or module with this name. | All packages and modules |

The bump type is derived from the commits: a breaking change yields a major bump, a `feat` yields a minor bump, otherwise a patch bump. After releasing, the command asks whether to push commits and tags to the remote; confirming runs `bun install`, commits `bun.lock`, and pushes.
