> ## 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.

# microservice:create

> Generate a new microservice.

Scaffold a new microservice module with its own entrypoint, start hook, Dockerfile, and env file on a free port. The microservice is declared in the app module config, the root env config, the root tsconfig path aliases, and the commitlint config when those files exist.

## Usage

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

## Examples

```bash theme={null}
# Interactive: prompts for the microservice name
ooneex microservice:create

# Provide the name as a flag
ooneex microservice:create --name=billing

# Run against a specific project directory
ooneex microservice:create --name=billing --cwd=/path/to/project
```

## Options

| Option     | Description                                                                                                                  | Default                   |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `--name`   | Microservice name. Normalized to PascalCase with any trailing `Module` stripped; the module folder uses its kebab-case form. | Prompted if omitted       |
| `--cwd`    | Project directory the microservice is created in.                                                                            | Current working directory |
| `--silent` | Suppress prompts and success output.                                                                                         | `false`                   |